Trong lần thay đổi cuối cùng với mã của module, bạn sẽ bổ sung khả năng lấy lời chào cho nhiều người trong cùng một yêu cầu. Nói cách khác, bạn sẽ xử lý đầu vào gồm nhiều giá trị, rồi ghép các giá trị đó với đầu ra cũng gồm nhiều giá trị. Để làm vậy, bạn cần truyền một tập tên vào một hàm có thể trả về lời chào cho từng người.
Lưu ý: Chủ đề này là một phần của loạt hướng dẫn nhiều phần, bắt đầu từ Tạo một Go module.
Nhưng có một vướng mắc. Việc đổi tham số của hàm Hello từ một tên đơn lẻ thành một tập tên sẽ làm thay đổi chữ ký của hàm. Nếu bạn đã publish module example.com/greetings và người dùng đã viết mã gọi Hello, thay đổi đó sẽ làm hỏng chương trình của họ.
Trong tình huống này, lựa chọn tốt hơn là viết một hàm mới với tên khác. Hàm mới sẽ nhận nhiều tham số. Cách này giữ lại hàm cũ để đảm bảo tương thích ngược.
-
Trong greetings/greetings.go, sửa mã của bạn thành như sau.
package greetings import ( "errors" "fmt" "math/rand" ) // Hello returns a greeting for the named person. func Hello(name string) (string, error) { // If no name was given, return an error with a message. if name == "" { return name, errors.New("empty name") } // Create a message using a random format. message := fmt.Sprintf(randomFormat(), name) return message, nil } // Hellos returns a map that associates each of the named people // with a greeting message. func Hellos(names []string) (map[string]string, error) { // A map to associate names with messages. messages := make(map[string]string) // Loop through the received slice of names, calling // the Hello function to get a message for each name. for _, name := range names { message, err := Hello(name) if err != nil { return nil, err } // In the map, associate the retrieved message with // the name. messages[name] = message } return messages, nil } // randomFormat returns one of a set of greeting messages. The returned // message is selected at random. func randomFormat() string { // A slice of message formats. formats := []string{ "Hi, %v. Welcome!", "Great to see you, %v!", "Hail, %v! Well met!", } // Return one of the message formats selected at random. return formats[rand.Intn(len(formats))] }Trong đoạn mã này, bạn:
- Thêm hàm
Helloscó tham số là một slice các tên thay vì một tên đơn lẻ. Bạn cũng đổi một trong các kiểu trả về từstringthànhmapđể có thể trả về các tên được ánh xạ tới thông điệp chào. - Cho hàm
Hellosmới gọi lại hàmHellođã có. Điều này giúp giảm trùng lặp mà vẫn giữ được cả hai hàm. - Tạo map
messagesđể gắn mỗi tên nhận được (làm khoá) với một thông điệp được sinh ra (làm giá trị). Trong Go, bạn khởi tạo map bằng cú pháp sau:make(map[kiểu-khoá]kiểu-giá-trị). Bạn cho hàmHellostrả về map này cho phía gọi. Tìm hiểu thêm về map tại Go maps in action trên blog của Go. - Lặp qua các tên mà hàm nhận được, kiểm tra từng tên có giá trị khác rỗng, rồi gắn một thông điệp cho mỗi tên. Trong vòng lặp
fornày,rangetrả về hai giá trị: chỉ số của phần tử hiện tại trong vòng lặp và một bản sao giá trị của phần tử. Bạn không cần chỉ số, nên bạn dùng blank identifier của Go (dấu gạch dưới) để bỏ qua nó. Tìm hiểu thêm tại The blank identifier trong Effective Go.
- Thêm hàm
-
Trong mã phía gọi hello/hello.go, hãy truyền vào một slice các tên, rồi in ra nội dung của map tên/thông điệp mà bạn nhận lại.
Trong hello.go, sửa mã của bạn thành như sau.
package main import ( "fmt" "log" "example.com/greetings" ) func main() { // Set properties of the predefined Logger, including // the log entry prefix and a flag to disable printing // the time, source file, and line number. log.SetPrefix("greetings: ") log.SetFlags(0) // A slice of names. names := []string{"Gladys", "Samantha", "Darrin"} // Request greeting messages for the names. messages, err := greetings.Hellos(names) if err != nil { log.Fatal(err) } // If no error was returned, print the returned map of // messages to the console. fmt.Println(messages) }Với những thay đổi này, bạn:
- Tạo biến
nameskiểu slice chứa ba tên. - Truyền biến
nameslàm đối số cho hàmHellos.
- Tạo biến
-
Tại dòng lệnh, chuyển sang thư mục chứa hello/hello.go, rồi dùng
go runđể xác nhận mã hoạt động.Kết quả in ra sẽ là dạng biểu diễn chuỗi của map gắn tên với thông điệp, đại khái như sau:
$ go run . map[Darrin:Hail, Darrin! Well met! Gladys:Hi, Gladys. Welcome! Samantha:Hail, Samantha! Well met!]
Chủ đề này đã giới thiệu map để biểu diễn các cặp tên/giá trị. Nó cũng giới thiệu ý tưởng giữ tương thích ngược bằng cách hiện thực một hàm mới cho chức năng mới hoặc chức năng thay đổi trong module. Tìm hiểu thêm về tương thích ngược tại Keeping your modules compatible.
Tiếp theo, bạn sẽ dùng các tính năng có sẵn của Go để viết unit test cho mã của mình.