跳转到主要内容

标签(标签)

资源精选(342) Go开发(108) Go语言(103) Go(99) angular(82) LLM(75) 大语言模型(63) 人工智能(53) 前端开发(50) LangChain(43) golang(43) 机器学习(39) Go工程师(38) Go程序员(38) Go开发者(36) React(33) Go基础(29) Python(24) Vue(22) Web开发(20) Web技术(19) 精选资源(19) 深度学习(19) Java(18) ChatGTP(17) Cookie(16) android(16) 前端框架(13) JavaScript(13) Next.js(12) 安卓(11) 聊天机器人(10) typescript(10) 资料精选(10) NLP(10) 第三方Cookie(9) Redwoodjs(9) LLMOps(9) Go语言中级开发(9) 自然语言处理(9) PostgreSQL(9) 区块链(9) mlops(9) 安全(9) 全栈开发(8) ChatGPT(8) OpenAI(8) Linux(8) AI(8) GraphQL(8) iOS(8) 软件架构(7) Go语言高级开发(7) AWS(7) C++(7) 数据科学(7) whisper(6) Prisma(6) 隐私保护(6) RAG(6) JSON(6) DevOps(6) 数据可视化(6) wasm(6) 计算机视觉(6) 算法(6) Rust(6) 微服务(6) 隐私沙盒(5) FedCM(5) 语音识别(5) Angular开发(5) 快速应用开发(5) 提示工程(5) Agent(5) LLaMA(5) 低代码开发(5) Go测试(5) gorm(5) REST API(5) 推荐系统(5) WebAssembly(5) GameDev(5) CMS(5) CSS(5) machine-learning(5) 机器人(5) 游戏开发(5) Blockchain(5) Web安全(5) Kotlin(5) 低代码平台(5) 机器学习资源(5) Go资源(5) Nodejs(5) PHP(5) Swift(5) 智能体(4) devin(4) Blitz(4) javascript框架(4) Redwood(4) GDPR(4) 生成式人工智能(4) Angular16(4) Alpaca(4) 编程语言(4) SAML(4) JWT(4) JSON处理(4) Go并发(4) kafka(4) 移动开发(4) 移动应用(4) security(4) 隐私(4) spring-boot(4) 物联网(4) nextjs(4) 网络安全(4) API(4) Ruby(4) 信息安全(4) flutter(4) 专家智能体(3) Chrome(3) CHIPS(3) 3PC(3) SSE(3) 人工智能软件工程师(3) LLM Agent(3) Remix(3) Ubuntu(3) GPT4All(3) 软件开发(3) 问答系统(3) 开发工具(3) 最佳实践(3) RxJS(3) SSR(3) Node.js(3) Dolly(3) 移动应用开发(3) 低代码(3) IAM(3) Web框架(3) CORS(3) 基准测试(3) Go语言数据库开发(3) Oauth2(3) 并发(3) 主题(3) Theme(3) earth(3) nginx(3) 软件工程(3) azure(3) keycloak(3) 生产力工具(3) gpt3(3) 工作流(3) C(3) jupyter(3) 认证(3) prometheus(3) GAN(3) Spring(3) 逆向工程(3) 应用安全(3) Docker(3) Django(3) R(3) .NET(3) 大数据(3) Hacking(3) 渗透测试(3) C++资源(3) Mac(3) 微信小程序(3) Python资源(3) JHipster(3) 大型语言模型(2) 语言模型(2) 可穿戴设备(2) JDK(2) SQL(2) Apache(2) Hashicorp Vault(2) Spring Cloud Vault(2) Go语言Web开发(2) Go测试工程师(2) WebSocket(2) 容器化(2) AES(2) 加密(2) 输入验证(2) ORM(2) Fiber(2) Postgres(2) Gorilla Mux(2) Go数据库开发(2) 模块(2) 泛型(2) 指针(2) HTTP(2) PostgreSQL开发(2) Vault(2) K8s(2) Spring boot(2) R语言(2) 深度学习资源(2) 半监督学习(2) semi-supervised-learning(2) architecture(2) 普罗米修斯(2) 嵌入模型(2) productivity(2) 编码(2) Qt(2) 前端(2) Rust语言(2) NeRF(2) 神经辐射场(2) 元宇宙(2) CPP(2) 数据分析(2) spark(2) 流处理(2) Ionic(2) 人体姿势估计(2) human-pose-estimation(2) 视频处理(2) deep-learning(2) kotlin语言(2) kotlin开发(2) burp(2) Chatbot(2) npm(2) quantum(2) OCR(2) 游戏(2) game(2) 内容管理系统(2) MySQL(2) python-books(2) pentest(2) opengl(2) IDE(2) 漏洞赏金(2) Web(2) 知识图谱(2) PyTorch(2) 数据库(2) reverse-engineering(2) 数据工程(2) swift开发(2) rest(2) robotics(2) ios-animation(2) 知识蒸馏(2) 安卓开发(2) nestjs(2) solidity(2) 爬虫(2) 面试(2) 容器(2) C++精选(2) 人工智能资源(2) Machine Learning(2) 备忘单(2) 编程书籍(2) angular资源(2) 速查表(2) cheatsheets(2) SecOps(2) mlops资源(2) R资源(2) DDD(2) 架构设计模式(2) 量化(2) Hacking资源(2) 强化学习(2) flask(2) 设计(2) 性能(2) Sysadmin(2) 系统管理员(2) Java资源(2) 机器学习精选(2) android资源(2) android-UI(2) Mac资源(2) iOS资源(2) Vue资源(2) flutter资源(2) JavaScript精选(2) JavaScript资源(2) Rust开发(2) deeplearning(2) RAD(2)

介绍


在 Go 中创建包时,最终目标通常是使包可供其他开发人员使用,无论是高阶包还是整个程序。通过导入包,您的代码可以作为其他更复杂工具的构建块。但是,只有某些包可用于导入。这是由包的可见性决定的。

在此上下文中的可见性意味着可以引用包或其他构造的文件空间。例如,如果我们在函数中定义一个变量,该变量的可见性(范围)仅在定义它的函数内。同样,如果您在包中定义变量,则可以使其仅对该包可见,或者也允许它在包外可见。

在编写符合人体工程学的代码时,仔细控制包的可见性很重要,尤其是在考虑到您可能希望对包进行的未来更改时。如果您需要修复错误、提高性能或更改功能,您需要以不会破坏任何使用您的包的人的代码的方式进行更改。最小化重大更改的一种方法是只允许访问包中正确使用它所需的部分。通过限制访问,您可以在内部对您的包进行更改,而不会影响其他开发人员如何使用您的包。

在本文中,您将学习如何控制包的可见性,以及如何保护只应在包内使用的部分代码。为此,我们将创建一个基本的记录器来记录和调试消息,使用具有不同程度项目可见性的包。

先决条件


要遵循本文中的示例,您将需要:

  • 按照如何安装 Go 和设置本地编程环境设置的 Go 工作区。本教程将使用以下文件结构:
.
├── bin 
│ 
└── src
    └── github.com
        └── gopherguides


导入的和未导入的事项


与 Java 和 Python 等使用访问修饰符(例如 public、private 或 protected)来指定范围的其他程序语言不同,Go 通过声明项目的方式确定是否导出和取消导出。在这种情况下,导出项目使其在当前包之外可见。如果它没有被导出,它只能在它定义的包中可见和可用。

这种外部可见性是通过将声明的项目的第一个字母大写来控制的。所有以大写字母开头的声明,例如类型、变量、常量、函数等,在当前包之外都是可见的。

让我们看下面的代码,注意大小写:

greet.go

package greet

import "fmt"

var Greeting string

func Hello(name string) string {
    return fmt.Sprintf(Greeting, name)
}

 

这段代码声明它在 greet 包中。然后它声明了两个符号,一个名为 Greeting 的变量和一个名为 Hello 的函数。因为它们都以大写字母开头,所以它们都可以导出并可供任何外部程序使用。如前所述,制作一个限制访问的包将允许更好的 API 设计,并更容易在内部更新你的包,而不会破坏依赖于你包的任何人的代码。

定义包可见性


为了更详细地了解包可见性在程序中的工作原理,让我们创建一个日志记录包,记住我们希望在包外显示的内容以及不显示的内容。这个日志包将负责将我们的任何程序消息记录到控制台。它还将查看我们正在登录的级别。级别描述了日志的类型,将是以下三种状态之一:信息、警告或错误。

首先,在您的 src 目录中,让我们创建一个名为 logging 的目录来放置我们的日志文件:

mkdir logging


接下来进入该目录:

cd logging


然后,使用 nano 之类的编辑器,创建一个名为 logging.go 的文件:

nano logging.go


将以下代码放入我们刚刚创建的 logging.go 文件中:

logging/logging.go

package logging

import (
    "fmt"
    "time"
)

var debug bool

func Debug(b bool) {
    debug = b
}

func Log(statement string) {
    if !debug {
        return
    }

    fmt.Printf("%s %s\n", time.Now().Format(time.RFC3339), statement)
}

该代码的第一行声明了一个名为 logging 的包。在这个包中,有两个导出的函数:Debug 和 Log。这些函数可以被任何其他导入日志包的包调用。还有一个名为 debug 的私有变量。此变量只能从日志记录包中访问。需要注意的是,虽然函数 Debug 和变量 debug 的拼写相同,但函数是大写的,而变量不是。这使得它们具有不同范围的不同声明。

保存并退出文件。

要在我们代码的其他区域使用这个包,我们可以将它导入到一个新包中。我们将创建这个新包,但首先需要一个新目录来存储这些源文件。

让我们移出日志目录,创建一个名为 cmd 的新目录,然后进入该新目录:

cd ..
mkdir cmd
cd cmd


在我们刚刚创建的 cmd 目录中创建一个名为 main.go 的文件:

nano main.go


现在我们可以添加以下代码:

package main

import "github.com/gopherguides/logging"

func main() {
    logging.Debug(true)

    logging.Log("This is a debug statement...")
}

我们现在已经编写了整个程序。但是,在我们可以运行这个程序之前,我们还需要创建几个配置文件以使我们的代码正常工作。 Go 使用 Go Modules 来配置用于导入资源的包依赖项。 Go 模块是放置在你的包目录中的配置文件,它告诉编译器从哪里导入包。虽然学习模块超出了本文的范围,但我们只需编写几行配置即可使此示例在本地工作。

在 cmd 目录中打开以下 go.mod 文件:

nano go.mod


然后将以下内容放入文件中:

go.mod

module github.com/gopherguides/cmd

replace github.com/gopherguides/logging => ../logging

这个文件的第一行告诉编译器cmd包的文件路径是github.com/gopherguides/cmd。第二行告诉编译器包 github.com/gopherguides/logging 可以在本地磁盘的 ../logging 目录中找到。

我们的日志包还需要一个 go.mod 文件。让我们回到日志目录并创建一个 go.mod 文件:

cd ../logging
nano go.mod


将以下内容添加到文件中:

go.mod

module github.com/gopherguides/logging


这告诉编译器我们创建的日志包实际上是 github.com/gopherguides/logging 包。这使得我们可以使用我们之前编写的以下行将包导入我们的主包中:

cmd/main.go

package main

import "github.com/gopherguides/logging"

func main() {
    logging.Debug(true)

    logging.Log("This is a debug statement...")
}

您现在应该具有以下目录结构和文件布局:

├── cmd
│   ├── go.mod
│   └── main.go
└── logging
    ├── go.mod
    └── logging.go


现在我们已经完成了所有配置,我们可以使用以下命令从 cmd 包中运行主程序:

cd ../cmd
go run main.go


您将获得类似于以下内容的输出:

Output
2019-08-28T11:36:09-05:00 This is a debug statement...


该程序将以 RFC 3339 格式打印出当前时间,然后是我们发送给记录器的任何语句。 RFC 3339 是一种时间格式,旨在表示 Internet 上的时间,通常用于日志文件。

因为 Debug 和 Log 函数是从 logging 包中导出的,所以我们可以在我们的 main 包中使用它们。但是,不会导出日志包中的调试变量。尝试引用未导出的声明将导致编译时错误。

将以下突出显示的行添加到 main.go:

cmd/main.go

package main

import "github.com/gopherguides/logging"

func main() {
    logging.Debug(true)

    logging.Log("This is a debug statement...")

    fmt.Println(logging.debug)
}

保存并运行该文件。您将收到类似于以下内容的错误:

Output
. . .
./main.go:10:14: cannot refer to unexported name logging.debug


现在我们已经了解了包中导出和未导出项的行为,接下来我们将看看如何从结构中导出字段和方法。

结构内的可见性


虽然我们在上一节中构建的记录器中的可见性方案可能适用于简单的程序,但它共享的状态太多,无法在多个包中使用。这是因为导出的变量可供多个包访问,这些包可能会将变量修改为相互矛盾的状态。允许以这种方式更改包的状态使得很难预测程序的行为方式。例如,在当前设计中,一个包可以将 Debug 变量设置为 true,而另一个包可以在同一实例中将其设置为 false。这会产生一个问题,因为正在导入日志记录包的两个包都会受到影响。

我们可以通过创建一个结构然后挂起方法来隔离记录器。这将允许我们创建一个记录器的实例,以便在每个使用它的包中独立使用。

将日志包更改为以下内容以重构代码并隔离记录器:

logging/logging.go

package logging

import (
    "fmt"
    "time"
)

type Logger struct {
    timeFormat string
    debug      bool
}

func New(timeFormat string, debug bool) *Logger {
    return &Logger{
        timeFormat: timeFormat,
        debug:      debug,
    }
}

func (l *Logger) Log(s string) {
    if !l.debug {
        return
    }
    fmt.Printf("%s %s\n", time.Now().Format(l.timeFormat), s)
}

在这段代码中,我们创建了一个 Logger 结构。 该结构将容纳我们未导出的状态,包括要打印的时间格式和调试变量设置的真或假。 New 函数设置用于创建记录器的初始状态,例如时间格式和调试状态。 然后它将我们在内部给它的值存储到未导出的变量 timeFormat 和 debug 中。 我们还在 Logger 类型上创建了一个名为 Log 的方法,该方法接受我们要打印的语句。 在 Log 方法中是对其局部方法变量 l 的引用,以访问其内部字段,例如 l.timeFormat 和 l.debug。

这种方法将允许我们在许多不同的包中创建一个 Logger,并独立于其他包如何使用它来使用它。

要在另一个包中使用它,让我们将 cmd/main.go 更改为如下所示:

cmd/main.go

package main

import (
    "time"

    "github.com/gopherguides/logging"
)

func main() {
    logger := logging.New(time.RFC3339, true)

    logger.Log("This is a debug statement...")
}

运行此程序将为您提供以下输出:

Output
2019-08-28T11:56:49-05:00 This is a debug statement...


在这段代码中,我们通过调用导出的函数 New 创建了一个记录器的实例。 我们将对该实例的引用存储在 logger 变量中。 我们现在可以调用 logging.Log 来打印语句。

如果我们尝试从 Logger 引用未导出的字段,例如 timeFormat 字段,我们将收到编译时错误。 尝试添加以下突出显示的行并运行 cmd/main.go:

cmd/main.go

package main

import (
    "time"

    "github.com/gopherguides/logging"
)

func main() {
    logger := logging.New(time.RFC3339, true)

    logger.Log("This is a debug statement...")

    fmt.Println(logger.timeFormat)
}

这将给出以下错误:

Output
. . .
cmd/main.go:14:20: logger.timeFormat undefined (cannot refer to unexported field or method timeFormat)


编译器识别 logger.timeFormat 未导出,因此无法从日志包中检索。

方法内的可见性


与结构字段一样,方法也可以导出或不导出。

为了说明这一点,让我们在记录器中添加分级记录。分级日志记录是一种对日志进行分类的方法,以便您可以在日志中搜索特定类型的事件。我们将放入记录器的级别是:

  • 信息级别,表示通知用户操作的信息类型事件,例如程序已启动或已发送电子邮件。这些帮助我们调试和跟踪程序的某些部分,以查看是否正在发生预期的行为。
  • 警告级别。这些类型的事件可识别何时发生非错误的意外事件,例如电子邮件发送失败、重试。它们帮助我们看到我们的程序中没有像我们预期的那样顺利的部分。
  • 错误级别,表示程序遇到问题,例如找不到文件。这通常会导致程序运行失败。

您可能还希望打开和关闭某些级别的日志记录,特别是如果您的程序没有按预期执行并且您想要调试程序。我们将通过更改程序来添加此功能,以便当 debug 设置为 true 时,它​​将打印所有级别的消息。否则,如果它是 false,它只会打印错误消息。

通过对 logging/logging.go 进行以下更改来添加分级日志记录:

logging/logging.go

package logging

import (
    "fmt"
    "strings"
    "time"
)

type Logger struct {
    timeFormat string
    debug      bool
}

func New(timeFormat string, debug bool) *Logger {
    return &Logger{
        timeFormat: timeFormat,
        debug:      debug,
    }
}

func (l *Logger) Log(level string, s string) {
    level = strings.ToLower(level)
    switch level {
    case "info", "warning":
        if l.debug {
            l.write(level, s)
        }
    default:
        l.write(level, s)
    }
}

func (l *Logger) write(level string, s string) {
    fmt.Printf("[%s] %s %s\n", level, time.Now().Format(l.timeFormat), s)
}

在此示例中,我们为 Log 方法引入了一个新参数。 我们现在可以传入日志消息的级别。 Log 方法确定它是什么级别的消息。 如果它是信息或警告消息,并且调试字段为真,那么它会写入消息。 否则它会忽略该消息。 如果它是任何其他级别,例如错误,它将无论如何都会写出消息。

大部分判断消息是否打印出来的逻辑都存在于 Log 方法中。 我们还介绍了一个未导出的方法,称为 write。 write 方法是实际输出日志消息的方法。

现在,我们可以通过将 cmd/main.go 更改为如下所示在我们的其他包中使用此级别的日志记录:

cmd/main.go

package main

import (
    "time"

    "github.com/gopherguides/logging"
)

func main() {
    logger := logging.New(time.RFC3339, true)

    logger.Log("info", "starting up service")
    logger.Log("warning", "no tasks found")
    logger.Log("error", "exiting: no work performed")

}

运行它会给你:

Output
[info] 2019-09-23T20:53:38Z starting up service
[warning] 2019-09-23T20:53:38Z no tasks found
[error] 2019-09-23T20:53:38Z exiting: no work performed

我们现在可以通过将 debug 切换为 false 来传递每条消息的级别:

main.go

package main

import (
    "time"

    "github.com/gopherguides/logging"
)

func main() {
    logger := logging.New(time.RFC3339, false)

    logger.Log("info", "starting up service")
    logger.Log("warning", "no tasks found")
    logger.Log("error", "exiting: no work performed")

}

现在我们将看到只打印错误级别的消息:

Output
[error] 2019-08-28T13:58:52-05:00 exiting: no work performed


如果我们尝试从日志包外部调用 write 方法,我们将收到一个编译时错误:

main.go

package main

import (
    "time"

    "github.com/gopherguides/logging"
)

func main() {
    logger := logging.New(time.RFC3339, true)

    logger.Log("info", "starting up service")
    logger.Log("warning", "no tasks found")
    logger.Log("error", "exiting: no work performed")

    logger.write("error", "log this message...")
}

Output
cmd/main.go:16:8: logger.write undefined (cannot refer to unexported field or method logging.(*Logger).write)


当编译器看到您试图从另一个以小写字母开头的包中引用某些内容时,它知道它没有被导出,因此会引发编译器错误。

本教程中的记录器说明了我们如何编写只公开我们希望其他包使用的部分的代码。因为我们控制了包的哪些部分在包外可见,所以我们现在能够在不影响任何依赖于我们包的代码的情况下进行未来的更改。例如,如果我们只想在 debug 为 false 时关闭信息级别消息,您可以在不影响 API 的任何其他部分的情况下进行此更改。我们还可以安全地更改日志消息以包含更多信息,例如运行程序的目录。

结论


本文展示了如何在包之间共享代码,同时保护包的实现细节。这允许您导出一个简单的 API,该 API 很少更改以实现向后兼容性,但将允许根据需要在包中进行私有更改,以使其在未来更好地工作。在创建包及其相应的 API 时,这被认为是最佳实践。

文章链接