为多人返回问候

在对模块代码进行的最后更改中，您将添加对在一个请求中为多人获取问候的支持。换句话说，您将处理多值输入，然后将该输入中的值与多值输出配对。为此，您需要将一组名称传递给一个函数，该函数可以为每个名称返回问候语.

但是有一个障碍。将 Hello 函数的参数从单个名称更改为一组名称将更改函数的签名。如果您已经发布了 example.com/greetings 模块，并且用户已经编写了调用 Hello 的代码，则该更改将破坏其程序.

在这种情况下，更好的选择是编写一个具有不同名称的新函数。新函数将采用多个参数。这保留了旧函数以实现向后兼容性.

在 greetings/greetings.go 中，更改您的代码，使其看起来如下所示.

package greetings

import (
    "errors"
    "fmt"
    "math/rand"
    "time"
)

// Hello 为指定的人返回问候语.
func Hello(name string) (string, error) {
    // 如果没有给出名字，返回一个带有消息的错误.
    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)
    // 遍历接收到的名称切片，调用
    // Hello 函数为每个名字获取一条消息.
    for _, name := range names {
        message, err := Hello(name)
        if err != nil {
            return nil, err
        }
        // 在map中，将检索到的消息与
        // 名称相关联.
        messages[name] = message
    }
    return messages, nil
}

//Init 为函数中使用的变量设置初始值.
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 函数，其参数是名称切片而不是单个名称。此外，还将其返回类型之一从string更改为map，以便可以返回映射到问候消息的名称.
让新的 Hellos 函数调用现有的 Hello 函数。这有助于减少重复，同时也保留了两个函数.
创建messages map，将每个收到的名称（作为键）与生成的消息（作为值）相关联。在 Go 中，使用以下语法初始化map：make(map[key-type]value-type)。您让 Hellos 函数将此map返回给调用方。有关maps的详细信息，请参阅 Go 博客上的 Go maps 实战。
循环遍历函数收到的名称，检查每个名称是否具有非空值，然后将消息与每个名称相关联。在此 for 循环中，range 返回两个值：循环中当前项的索引和项值的副本。您不需要索引，因此使用 Go 空白标识符（下划线）来忽略它。有关详细信息，请参阅 Effective Go 中的空白标识符.

在 hello/hello.go 调用代码中，传递名称的一个切片，然后打印返回的名称/消息map的内容.

在 hello.go 中，更改您的代码，使其看起来如下所示.

package main

import (
    "fmt"
    "log"

    "example.com/greetings"
)

func main() {
    // 设置预定义Logger的属性，包括
    // 日志条目前缀和禁用打印的标志
    // 时间、源文件和行号.
    log.SetPrefix("greetings: ")
    log.SetFlags(0)

    // 一个名字切片.
    names := []string{"Gladys", "Samantha", "Darrin"}

    // 请求姓名的问候消息.
    messages, err := greetings.Hellos(names)
    if err != nil {
        log.Fatal(err)
    }
    // 如果没有返回错误，则打印返回的map
    // 消息到控制台.
    fmt.Println(messages)
}

通过这些更改，您:

将 names 变量创建为包含三个名称的切片类型.
将 names 变量作为参数传递给 Hellos 函数.

在命令行中，切换到包含 hello/hello.go 的目录，然后使用 go run 确认代码是否正常工作.
输出应该是将名称与消息相关联的映射的字符串表示形式，如下所示;
```
$ go run .
map[Darrin:Hail, Darrin! Well met! Gladys:Hi, Gladys. Welcome! Samantha:Hail, Samantha! Well met!]
```

本主题介绍了用于表示名称/值对的映射。它还引入了通过为模块中的新功能或更改功能实现新函数来保持向后兼容性的想法。有关向后兼容性的更多信息，请参阅保持模块兼容。

接下来，您将使用内置的 Go 功能为您的代码创建单元测试.