为多个人返回问候语
一、说明
你将为你模块的代码添加最后一次的改变。你将添加支持在一次请求中为多个人获取问候。换句话说,你讲处理多值的输入,然后将该输入中的值与多值输入配对。为了做这样的事情,你将需要传递一个集合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
函数。这帮助减少了重复,也保留了两个函数功能; - 创建了一个map类型的·
messages
,用于关联每一个接收到的name(作为key)和产生的消息(作为value)。在Go语言中,你使用后面的语法来初始化一个map:make(map(key-type))value-type
。在Hellos
函数中返回这个map给调用者。更多关于map,请看GO map在实战中的应用 - 循环你的函数接收names,检查每一个都有一个非空的value,然后为每一个关联一个消息。在这个
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对。它也介绍了维护向前兼容的想法,通过为一个新功能或改变的功能实现一个新函数