你将为你模块的代码添加最后一次的改变。你将添加支持在一次请求中为多个人获取问候。换句话说,你讲处理多值的输入,然后将该输入中的值与多值输入配对。为了做这样的事情,你将需要传递一个集合name到函数中,然后能为他们中的每一个返回一个问候。
但是这儿有一个小问题。改变Hello
函数的参数从单个name到一个集合name,将改变函数的签名。如果你已经发布了example.com/greetings
模块,并且用户已经写代码调用了Hello
,这种改变将破环他们的程序。
在这种情况下,一个好的选择是写一个不同名称的新函数。新的函数将获取多值。这保留了旧功能以实现向后的兼容性。
在greetings/greetings.go
文件中,改变你的代码以至于它看来来像这样:
package greetings
import (
"errors"
"fmt"
"math/rand"
"time"
)
// Hello 为一个命名的人返回一个问候
func Hello(name string) (string, error) {
// 如果没有给出name,返回一个带有消息的错误
if name == "" {
return "", errors.New("empty name")
}
// 如果接受到一个名字,返回一个问候,嵌套名字在消息中
// message := fmt.Sprintf("Hi, %v. Welcome!", name)
// 使用随机消息格式创建消息
message := fmt.Sprintf(randomFormat(), name)
return message, nil
}
// Hellow 返回一个关联了每一个人名和问候语的map
func Hellos(names []string) (map[string]string, error) {
// 一个map,用于关联人名和消息
messages := make(map[string]string)
// 循环查看接口的分片names,调用Hello函数 为每一个name获取一个消息
for _, name := range names {
message, err := Hello(name)
if err!=nil {
return nil, err
}
// 在map中,关联检索到的消息和name
messages[name] = message
}
return messages, nil
}
// 为在函数中使用的变量初始化集合的最初始的值
func init() {
rand.Seed(time.Now().UnixNano())
}
// randomFormat 返回一个问候语集合中的一个,被返回的消息是随机选择的
func randomFormat() string {
// 一个消息格式的切片
formats := []string{
"Hi, %v. Welcome!",
"Great to see you, %v!",
"Hail, %v! Well met!",
}
// 根据指定的随机索引从格式化切片中返回一个随机选择的消息格式
return formats[rand.Intn(len(formats))]
}
在这个代码中:
Hellos
函数,它的参数是一个切片类型的names,而不是单个name。因此,你改变了它的返回值类型,从一个string到一个map,以便于你能返回names对应的消息;Hellos
函数中,调用已经存在的Hello
函数。这帮助减少了重复,也保留了两个函数功能;messages
,用于关联每一个接收到的name(作为key)和产生的消息(作为value)。在Go语言中,你使用后面的语法来初始化一个map:make(map(key-type))value-type
。在Hellos
函数中返回这个map给调用者。更多关于map,请看GO map在实战中的应用for
循环中,range
返回两个值:当前项在循环中的索引和一个项目值的副本。你不需要这个索引,因此你使用Go的空白标识符(下划线)来忽略它。在hello2/hello2.go
的调用者代码中,传递一个names分片,然后打印你获得的name/message内容。
在hello.go
文件中,改变你的代码让它看起来像这样:
package main
import (
"fmt"
"log"
"example.com/greetings"
)
func main() {
// 设置Logger预定义的属性,包含了log项的前缀,和一个禁用打印时间,源文件,行号的标识。
log.SetPrefix("greetings: ")
log.SetFlags(0)
// 获取一个问候消息,并打印它
// message := greetings.Hello("hef")
// 请求一个问候消息
// message, err := greetings.Hello("")
// message, err := greetings.Hello("hef")
// 一个names切片
names := []string{"lifei", "tw", "zy", "my"}
// 为names请求问候消息
messages, err := greetings.Hellos(names)
// 如果一个错误返回,将它打印到控制台,并退出程序
if err != nil {
log.Fatal(err)
}
// 如果没有错误返回,打印返回到消息到控制台
// fmt.Println(message)
fmt.Println(messages)
}
你进行了如下改变:
names
作为切片类型,持有三个names;names
变量作为参数给Hellos函数;在命令行中,改变目录到包含hello2/hello2.go
文件到目录下,然后使用go run
去验证代码的工作。
输出应该是一个字符串表示的map,关联着name和消息。看起来像这样:
$ go run .
map[lifei:Hi, lifei. Welcome! my:Hi, my. Welcome! tw:Great to see you, tw! zy:Great to see you, zy!]
$
这篇文章介绍了maps代表key-value对。它也介绍了维护向前兼容的想法,通过为一个新功能或改变的功能实现一个新函数