本文翻译自《Return greetings for multiple people》。
在你对模块代码所做的最后更改中,你将添加代码,在一个请求中获取对多个人的问候语。换句话说,你将处理多个值输入,然后对应地输出多个值。为此,你需要将一组名字传递给一个可以为每个名字返回一句问候语的函数。
注意:本主题是从《创建一个Go模块》开始的多部分教程的一部分。
但有一个问题。将Hello
函数的参数从单个名字name
更改为一组名字将会改变函数的签名。如果你已经发布了example.com/greeting
模块,并且用户已经编写了调用Hello
函数的代码,那么这种更改将破坏他们的程序。
在这种情况下,更好的选择是编写一个具有不同名称的新函数。新函数将采用多个参数。这保留了旧功能以实现向后兼容性。
1 在greetings/greetings.go中,更改你的代码,使其如下所示。
package greetings
import (
"errors"
"fmt"
"math/rand"
"time"
)
// Hello函数为给定名字的人返回一句问候语。
func Hello(name string) (string, error) {
// 如果name参数的值为空字符串,那么返回一条错误信息。
if name == "" {
return name, errors.New("empty name")
}
// 使用一个随机格式创建一条消息。
message := fmt.Sprintf(randomFormat(), name)
return message, nil
}
// Hellos函数返回一个映射map,用来关联每个给出名字的人和发给他的一句问候语消息。
func Hellos(names []string) (map[string]string, error) {
// 一个映射map,用来关联名字和消息。
messages := make(map[string]string)
// 循环遍历接收到的names切片,为其中每个名字调用Hello函数获取一条消息。
for _, name := range names {
message, err := Hello(name)
if err != nil {
return nil, err
}
//在这个映射map中,关联名字和对应的消息。
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
函数,其参数是一组名字而不是单个名字。此外,你将其返回类型之一从字符串更改为映射,以便你可以返回名字到问候语消息的映射。
- 让新的
Hellos
函数调用现有的Hello
函数。这有助于减少重复,同时保留这两个函数。
- 创建一个消息
messages
映射,将每个接收到的名字(作为关键字)与生成的消息(作为值)相关联。在Go中,使用以下语法初始化映射:make(map[key-type]value-type)
。让Hellos
函数将此映射返回给调用者。有关映射类型map
的更多信息,请参阅Go博客上的实践Go map。
- 遍历你的函数收到的名字,检查每个名字是否具有非空值,然后将消息与每个名字相关联。在此
for
循环中,range
返回两个值:循环中当前条目的索引和条目值的一个副本。你不需要索引,因此你使用Go空白标识符(一个下划线)来忽略它。有关更多信息,请参阅Effective Go中的空白标识符。
2 在你的hello/hello.go的代码调用中,传递一个名字切片,然后打印输出你获得的名字/消息映射的内容。
package main
import (
"fmt"
"log"
"example.com/greetings"
)
func main() {
log.SetPrefix("greetings: ")
log.SetFlags(0)
// 一个名字切片
names := []string{"Gladys", "Samantha", "Darrin"}
// 为names请求响应的问候语消息
messages, err := greetings.Hellos(names)
if err != nil {
log.Fatal(err)
}
fmt.Println(messages)
}
通过这些更改,你可以:
- 创建一个
names
切片类型变量,包含三个名字。 - 将
names
变量作为参数传递给Hellos
函数。
3 在命令行中,切换到包含hello/hello.go的目录,然后使用go un
运行并确认代码是否有效
输出应该是将名字与消息关联起来的映射的字符串表示,如下所示:
$ go run .
map[Darrin:Hail, Darrin! Well met! Gladys:Hi, Gladys. Welcome! Samantha:Hail, Samantha! Well met!]
本主题介绍了表示名/值对的映射类型。它还引入了通过为模块中的新功能或更改功能来实现新功能并保持向后兼容性的思想。有关向后兼容性的详细信息,请参阅保持模块兼容。
接下来,你将使用Go内置的功能为代码创建一个单元测试。