前言
多年前曾经梦想着能有一天能在 Go 语言中使用上 Spring 那样强大的框架，幸运的是我找到了go-spring，一款类似 Spring 的库，我很喜欢它，并且在我的项目中深度使用它，它给我带来了非常酷的编程体验。
然而很不幸的是最近 go-spring 停止更新了(最近的一次提交停留在九个月之前)，一些问题无法得到有效的解决，因此我决定创建一个基于 go-spring 的开源库，我为它修复了一系列 bug ，并添加了一些新得特性，并对代码结构进行了简化，将外部生态从核心库中移除，仅保留核心功能，外部生态预计将来将作为独立的仓库存在，我将持续继续将它维护下去，也希望有感兴趣的人可以一起参与进来一起持续开发它。
仓库地址: https://github.com/go-spring-projects/go-spring
特性
- IoC 容器: 实现了基于反射的控制反转(IoC)容器，支持结构体、函数和常量的注入。这意味着你可以使用' autowired '标签来自动注入依赖，而不必手动管理它们。
- 配置管理: 受 Spring 的 @Value 注释的启发，Go-Spring 允许您从多个源(如环境变量、文件、命令行参数等)获取配置项。这为配置管理带来了前所未有的灵活性。
- 配置验证器: 通过支持自定义验证器扩展扩展了其健壮的配置管理功能。这使您能够对属性执行有效性检查，确保仅将有效的配置应用于您的应用程序。
- 结构化日志: 使用标准库 slog 提供内置日志记录器支持，以实现有效和简化的日志记录。这种增强提供了清晰、简洁和结构良好的日志信息，有助于系统调试和性能监视。
- 动态属性: 提供动态属性刷新功能，让您无需重新启动应用程序即可动态更新应用程序属性。它满足了需要高可用性和实时响应的应用程序的需求。
- 依赖序事件: 按照 bean 依赖关系的顺序，确保根据对象的生命周期正确通知初始化和销毁事件。这增强了系统在其生命周期运行中的鲁棒性和可靠性。
动态属性例子
允许在运行时动态刷新属性，不仅支持基本数据类型，还支持结构、切片和 Map 类型。
package main
import (
"fmt"
"log/slog"
"net/http"
"github.com/go-spring-projects/go-spring/dync"
"github.com/go-spring-projects/go-spring/gs"
)
type Handler struct {
Open dync.Bool `value:"${server.open:=true}"`
}
func (h *Handler) OnInit(ctx gs.Context) error {
http.HandleFunc("/server/status", func(writer http.ResponseWriter, request *http.Request) {
if !h.Open.Value() {
http.Error(writer, "server closed", http.StatusNotAcceptable)
return
}
fmt.Fprint(writer, "server running")
})
return nil
}
type Server struct {
Logger *slog.Logger `logger:""`
}
func (s *Server) OnInit(ctx gs.Context) error {
props := ctx.(gs.Container).Properties()
http.HandleFunc("/server/status/open", func(writer http.ResponseWriter, request *http.Request) {
props.Set("server.open", "true")
s.Logger.Info("server opened")
})
http.HandleFunc("/server/status/close", func(writer http.ResponseWriter, request *http.Request) {
props.Set("server.open", "false")
s.Logger.Info("server closed")
})
go func() {
http.ListenAndServe(":7878", nil)
}()
return nil
}
func main() {
gs.Object(new(Handler))
gs.Object(new(Server))
if err := gs.Run(); nil != err {
panic(err)
}
}
// Output:
//
// $ curl http://127.0.0.1:7878/server/status
// server running
//
// $ curl http://127.0.0.1:7878/server/status/close
//
// $ curl http://127.0.0.1:7878/server/status
// server closed
//
// $ curl http://127.0.0.1:7878/server/status/open
//
// $ curl http://127.0.0.1:7878/server/status
// server running
参数校验器例子
Go-Spring允许您注册自定义值验证器。如果值验证失败，则Go-Spring将在启动阶段报告一个错误。
在这例子中, 我们将使用 go-validator/validator, 您可以参考这个示例来注册您的自定义验证器。
package main
import (
"fmt"
"log/slog"
"github.com/go-spring-projects/go-spring/conf"
"github.com/go-spring-projects/go-spring/gs"
"gopkg.in/validator.v2"
)
const validatorTagName = "validate"
type validatorWrapper struct {
validator *validator.Validator
}
func (v *validatorWrapper) Field(tag string, i interface{}) error {
if 0 == len(tag) {
return nil
}
return v.validator.Valid(i, tag)
}
func init() {
conf.Register(validatorTagName, &validatorWrapper{validator: validator.NewValidator().WithTag(validatorTagName)})
}
//--------------------------------------------------------------------------
type DBOptions struct {
UserName string `value:"${username}"`
Password string `value:"${password}"`
IP string `value:"${ip}"`
Port int32 `value:"${port}" validate:"min=1024,max=65535"`
DB string `value:"${db}" validate:"nonzero"`
}
type MysqlDatabase struct {
Logger *slog.Logger `logger:""`
Options DBOptions `value:"${db}"`
}
func (md *MysqlDatabase) OnInit(ctx gs.Context) error {
md.Logger.Info("mysql connection summary",
"url", fmt.Sprintf("mysql://%s:%s@%s:%d/%s", md.Options.UserName, md.Options.Password, md.Options.IP, md.Options.Port, md.Options.DB))
return nil
}
func main() {
gs.Property("db.username", "admin")
gs.Property("db.password", "123456")
gs.Property("db.ip", "127.0.0.1")
gs.Property("db.port", "0") // set db.port=0
gs.Property("db.db", "test")
gs.Object(new(MysqlDatabase))
if err := gs.Run(); nil != err {
panic(err)
}
}
//
// Output:
// panic: container refresh failed
// ↳object bean "main/main.MysqlDatabase:MysqlDatabase" /projects/go-project/gocase/validator/main.go:58
// ↳bind MysqlDatabase.Options error: validate MysqlDatabase.Options.Port error: less than min
更多特性请参考说明: go-spring-projects/go-spring
最后还要感谢原作者lvan100的辛勤付出。
1
Select Language