Go-Spring

Go-Spring 的愿景是让 GoLang 程序员也能用上如 Java Spring 那般威力强大的编程框架。

特性：

提供完善的 IoC 容器，支持依赖注入、属性绑定；
提供强大的启动器框架，支持自动装配、开箱即用；
提供常见组件的抽象层，支持灵活地替换底层实现；

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/")
}

项目列表

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)

如何成为贡献者？提交有意义的PR，并被采纳。

QQ 交流群

微信公众号

License

The Go-Spring is released under version 2.0 of the Apache License.

Note

This is not an official Didi product (experimental or otherwise), it is just code that happens to be owned by Didi.

alive-z / go-spring