Go语言中从导出函数返回未导出类型：设计模式与最佳实践

package users

import "fmt"

// user 是一个未导出的结构体，外部包无法直接访问其字段或直接实例化
type user struct {
    id   string
    name string
    age  int
}

// NewUser 是一个导出函数，作为 user 类型的工厂
// 它返回一个指向未导出 user 结构体的指针
func NewUser(id, name string, age int) (*user, error) {
    if id == "" || name == "" {
        return nil, fmt.Errorf("ID and name cannot be empty")
    }
    if age < 0 {
        return nil, fmt.Errorf("Age cannot be negative")
    }
    return &user{
        id:   id,
        name: name,
        age:  age,
    }, nil
}

// GetName 是一个导出方法，允许外部包访问 user 的名字
func (u *user) GetName() string {
    return u.name
}

// GetID 是一个导出方法，允许外部包访问 user 的ID
func (u *user) GetID() string {
    return u.id
}

// SayHello 是一个导出方法，展示 user 的行为
func (u *user) SayHello() string {
    return fmt.Sprintf("Hello, my name is %s and I am %d years old.", u.name, u.age)
}

package main

import (
    "fmt"
    "your_module/users" // 假设 your_module 是你的模块名
)

func main() {
    // 通过工厂函数创建 user 实例
    u, err := users.NewUser("123", "Alice", 30)
    if err != nil {
        fmt.Println("Error creating user:", err)
        return
    }
    fmt.Println(u.SayHello()) // 输出: Hello, my name is Alice and I am 30 years old.
    fmt.Println("User ID:", u.GetID())

    // 尝试直接创建 user 实例 (会编译错误)
    // var invalidUser users.user // 编译错误: field user.user is unexported
    // invalidUser := users.user{} // 编译错误: field user.user is unexported
}

package users

import "fmt"

// User 是一个导出接口，定义了用户行为
type User interface {
    GetName() string
    GetID() string
    SayHello() string
}

// user 是一个未导出的结构体，实现了 User 接口
type user struct {
    id   string
    name string
    age  int
}

// NewUser 是一个导出函数，作为 user 类型的工厂
// 它返回一个 User 接口类型，而不是具体的 *user 类型
func NewUser(id, name string, age int) (User, error) { // 注意这里返回的是 User 接口
    if id == "" || name == "" {
        return nil, fmt.Errorf("ID and name cannot be empty")
    }
    if age < 0 {
        return nil, fmt.Errorf("Age cannot be negative")
    }
    return &user{ // 返回的是 *user 实例，但被隐式转换为 User 接口
        id:   id,
        name: name,
        age:  age,
    }, nil
}

// 以下是 user 结构体实现 User 接口的方法
func (u *user) GetName() string {
    return u.name
}

func (u *user) GetID() string {
    return u.id
}

func (u *user) SayHello() string {
    return fmt.Sprintf("Hello, my name is %s and I am %d years old.", u.name, u.age)
}

package main

import (
    "fmt"
    "your_module/users"
)

func main() {
    // 通过工厂函数创建 User 接口实例
    u, err := users.NewUser("456", "Bob", 25)
    if err != nil {
        fmt.Println("Error creating user:", err)
        return
    }
    fmt.Println(u.SayHello()) // 输出: Hello, my name is Bob and I am 25 years old.
    fmt.Println("User ID:", u.GetID())

    // 此时，外部代码只知道它有一个 users.User 接口，而不知道具体的实现类型是 users.user
    // 这提供了更大的灵活性，将来可以更改 user 的底层实现，而无需修改外部代码
}