# go-spring **Repository Path**: wwoon/go-spring ## Basic Information - **Project Name**: go-spring - **Description**: Go-Spring 是模仿 Java Spring 全家桶实现的一套 GoLang 应用程序框架 - **Primary Language**: Shell - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://www.oschina.net/p/go-spring - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 34 - **Created**: 2020-06-23 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
logo
license go-version release
Go-Spring 的愿景是让 GoLang 程序员也能用上如 Java Spring 那般威力强大的编程框架。🎉 wiki 已更新 🎉。 特性: 1. 提供完善的 IoC 容器,支持依赖注入、属性绑定; 2. 提供强大的启动器框架,支持自动装配、开箱即用; 3. 提供常见组件的抽象层,支持灵活地替换底层实现; Go-Spring 当前使用 Go1.12 进行开发,使用 Go Modules 进行依赖管理。 ### IoC 容器 Go-Spring 实现了如 Java Spring 那般功能强大的 IoC 容器,不仅支持通过对象注册 Bean,还支持通过 Bean 的构造函数注册 Bean,可以非常方便地在项目中引入 Go-Spring 框架。 Go-Spring 还扩充了 Bean 的概念,在 Golang 中,对象(即指针)、数组、Map、函数指针,这些都是 Bean,都可以放到 IoC 容器里。 `@Value` Go-Spring 不仅支持基础类型的属性绑定,也支持自定义值类型的属性绑定,以及结构体属性的嵌套绑定。 `@Autowired` `@Qualifier` `@Required` Go-Spring 通过 BeanId 的概念将上面的三个功能合并到了一个 Tag 属性里面,通过 BeanId 可以指定要绑定的 Bean 的名称、类型,以及绑定是否可以为空。 `@Configurable` Go-Spring 可以对容器外部的对象进行属性和变量绑定。 `@Profile` Go-Spring 可以设定 IoC 容器的运行环境,满足特定环境下 Bean 的注册问题。 `@Primary` Go-Spring 可以在 Bean 注册时设定优先级,满足单元测试时注入 Mocked Bean 的需求。 `@DependsOn` Go-Spring 支持对 Bean 的非直接依赖首先进行初始化。 `@Lookup` Go-Spring 可以通过注册原型 Bean 工厂的方式在程序中方便的获取原型 Bean。 `ConstructorBinding` Go-Spring 可以通过注册构造函数的方式进行属性绑定。 `@ComponentScan` `@Indexed` Go-Spring 使用包匿名引用机制实现对注册 Bean 的扫描,并且无需借助其他手段如索引就能实现高效率的扫描。 `@Conditional` Go-Spring 支持对 Bean 的注册设定各种 Matches 条件。 `@ConditionalOnExpression` 暂未支持。 `@ConditionalOnProperty` Go-Spring 支持通过匹配属性值的方式决定是否注册 Bean。 `@ConditionalOnBean` `@ConditionalOnMissingBean` Go-Spring 支持通过判断指定 Bean 存在的方式决定是否注册 Bean。 `@ConditionalOnClass` `@ConditionalOnMissingClass` GoLang 不会出现类型不存在的情况。 ### 属性绑定 Go-Spring 不仅支持对普通数据类型进行属性绑定,也支持对自定义的值类型进行属性绑定,而且还支持对结构体属性的嵌套绑定。 ``` type DB struct { UserName string `value:"${username}"` Password string `value:"${password}"` Url string `value:"${url}"` Port string `value:"${port}"` DB string `value:"${db}"` } type DbConfig struct { DB []DB `value:"${db}"` } ``` 比如上面的这段代码就可以通过下面的配置进行绑定: ``` db: - username: root password: 123456 url: 1.1.1.1 port: 3306 db: db1 - username: root password: 123456 url: 1.1.1.1 port: 3306 db: db2 ``` 而且更多属性绑定的能力还在等待你去发现。 ### Boot 框架 Go-Spring 提供了一个简单但功能强大的启动器框架,不仅开箱即用,还支持开发自己的模块来利用开箱即用的能力,使得代码不仅仅是库层面的代码复用。 ``` package main import ( _ "github.com/go-spring/go-spring-boot-starter/starter-gin" _ "github.com/go-spring/go-spring-boot-starter/starter-web" "github.com/go-spring/go-spring-web/spring-web" "github.com/go-spring/go-spring/spring-boot" "github.com/go-spring/go-spring/spring-core" "net/http" ) func init() { SpringBoot.RegisterBean(new(Controller)) } type Controller struct{} func (c *Controller) InitWebBean(wc SpringWeb.WebContainer) { wc.GET("/", c.Home) } func (c *Controller) Home(ctx SpringWeb.WebContext) { ctx.String(http.StatusOK, "OK!") } func main() { SpringBoot.RunApplication("config/") } ``` 更多示例: https://github.com/go-spring/go-spring-boot-demo ### 项目列表 #### go-spring-parent 所有 Go-Spring 项目的根模块,包含日志,常量等。 #### go-spring 实现了 IoC 容器和 Boot 框架。 #### go-spring-web 不依赖 Go-Spring 框架的独立的 Web 模块。 #### go-spring-redis 不依赖 Go-Spring 框架的独立的 Redis 模块。 #### go-spring-rpc 不依赖 Go-Spring 框架的独立的 RPC 模块。 #### go-spring-orm 不依赖 Go-Spring 框架的独立的 ORM 模块。 #### go-spring-message 不依赖 Go-Spring 框架的独立的 MQ 模块。 #### go-spring-boot-starter 提供常见组件的启动器,实现开箱即用。 ### 项目成员 #### 发起者/负责人 [lvan100 (LiangHuan)](https://github.com/lvan100) 如何成为贡献者? 提交有意义的PR,并被采纳。 ### QQ 交流群 ### 微信公众号 ### License The Go-Spring is released under version 2.0 of the Apache License.