微服务解决方案 Go微服务开发利器

GitHub地址 https://github.com/zhuxiujia/GoMybatisMall

首先让我们 对比 看看 Java 是如何写接口（要支持swagger注解）

@Controller
@Api(
    description = "验证码生成控制器"
)
public class CaptchaImageController {
    private static Logger logger = LoggerFactory.getLogger(CaptchaImageController.class);
    private static final String NO_CACHE = "No-cache";
    @Resource
    private SmsVerificationService smsVerificationService;

    public CaptchaImageController() {
    }

    @RequestMapping({"/image/code/phone"})
    @ApiOperation(
        value = "得到一个校验码",
        notes = "得到一个校验码",
        httpMethod = "POST",
        produces = "image/png"
    )
    public void getCode(@RequestParam("phone") String phone, HttpServletRequest request, HttpServletResponse response) throws ServiceException {
        response.setHeader("Pragma", "No-cache");
        response.setHeader("Cache-Control", "No-cache");
        response.setDateHeader("Expires", 0L);
        response.setContentType("image/jpeg");
        if (phone != null && phone.length() == 11) {
            try {
                String code = ValidateCodeUtil.createVcode();
                this.smsVerificationService.saveVerificationImageCode(phone, code);
                ValidateCodeUtil.write(code, response);
                logger.info("产生一个验证码[" + code + "],保存于   key[" + phone + "]");
            } catch (Exception var6) {
                logger.error("生成验证图片失败！", var6);
                throw new ServiceException(var6);
            }
        } else {
            throw new ServiceException(new Object[]{"手机号不正确！", phone});
        }
    }
}

再来看看 go 这边写接口（要支持swagger注解）

type CaptchaApi struct {
	easy_mvc.Controller `doc:"验证码API"`
	StoreService        *service.StoreService `inject:"StoreService"`

	GetImage func(phone string, writer http.ResponseWriter) interface{} `path:"/api/captcha" arg:"phone,w" doc:"图形验证码接口" doc_arg:"phone:手机号,w:_"`
	Slide    func(phone string, writer http.ResponseWriter) interface{} `path:"/api/captcha/slide" arg:"phone,w" doc:"图形验证码接口" doc_arg:"phone:手机号,w:_"`
}
func (it *CaptchaApi) Routers() {
	it.GetImage = func(phone string, writer http.ResponseWriter) interface{} {
		if phone == "" {
			return errors.New("手机号不能空！")
		}
		if len(phone) != 11 {
			return errors.New("手机号不正确！")
		}
		//生成4位随机数字
		var digs = captcha.RandomDigits(4)
		var code = toDigitString(digs)
		//save code
		var err = it.StoreService.SaveImageCode(service.ImageCodeDTO{
			Phone: phone,
			Code:  code,
		})
		if err != nil {
			return err
		}
		var img = captcha.NewImage("", digs, 80, 42)
		log.Println("产生一个验证码[" + code + "],保存于   key[" + phone + "]")
		writer.Header().Set("Content-Type", "image/png")
		img.WriteTo(writer)
		return nil
	}
        it.Init(it)
	app_context.Context.Provide(&inject.Object{
		Value: it,
	})
}

• 有木有感觉 go 写 貌似 更加的 便利和简洁~ 而且。。。。和spring 似曾相识，对。要的就是这种感觉~

• 再来看看具体的项目

基于GoMybatis的商城 微服务 项目

• 适用于给 初学GoMybatis开发者作为 示例或参考用或者快速开发一个GoMybatis项目.
• 适用于Java服务端开发者学习适用go项目（jvm开发者一般都是公司性质，注重扩展性和简单化，适用于习惯SSM组合的开发者，即SpringBoot,SpringMVC,Mybatis）
• 非常适合需要快速敏捷业务开发的，执行异常快速，适合低功耗电脑（例如笔记本），go本身写test和benchamrk简单，利于测试，压测

设计

• 本项目使用基本的微服务设计（Controller-Service Discovery-Rpc LB-Service）拆分粒度为最大化（仅包含 一个网关和一个微服务，实际项目需要根据业务自己评估拆分）

• 关于网关（自行设计controller 作为网关做鉴权，注意本项目作为案例未加入，但是可以把controller层视为网关）

• 关于链路追踪（需要自行封装链路追踪，本项目基于rpc ，使用方式上没差别。注意本项目未加入）

• 关于熔断（需要自行封装熔断，本项目基于rpc ，使用方式上没差别。注意本项目未加入）

• 关于分布式唯一id（推荐使用其他的算法例如 雪花snowflake，本项目为了简单 默认使用uuid生成）

• 关于服务发现（本项目使用consul，也意味着支持spring cloud 调用基于本项目的集群）

• 关于 sql 不推荐或极少使用join语句,外键，触发器，存储过程（一般不超过3条，且join的应该是同业务的表，禁止跨服务join），而是使用 查询后组合的方法（因为go查询并发执行，为分库分表做万全准备）

• gomybatis的xml里不出现任何的包名（得益于 设计之初 遵循单一职责原则和序列化方法定义在xml中和结构体tag中）似乎有点洁癖+强迫症，哈哈

• 关于事务，已处理好core服务中嵌套事务传播行为

• 秒启动（完成项目扫描,bean注入，总耗时小于1秒内）

• 支持 Swagger UI（go语言中唯一使用接口注解）和移动端前端沟通更便利~

架构:

• 必须的库

• log（日志推荐使用golang官方（官方最稳定，其他库太重，本项目不赞成引入），仅写入到静态文件）
• consul(服务发现，consul是支持spring cloud的go语言分布式服务发现)
• easy_mvc(https://github.com/zhuxiujia/easy_mvc) （拟mvc设计）
• easyrpc(https://github.com/zhuxiujia/easyrpc) （封装定义,支持事务传播，基于go官方rpc库封装，兼容性也好）
• easyrpc_discovery(https://github.com/zhuxiujia/easyrpc_discovery) （微服务发现）
• GoMybatis
• Mysql5.7
• redis

• 可选的库

• GoFastdfs(开源分布式文件存储,你也可以选择其他的例如 阿里云oss)
• statikFs(开源静态文件编译，用于打包外部配置文件，mapper xml文件 进程序（打包的本质是生成string全局变量模拟已打包的文件，如不适用，需要自行打包配置文件上传目录)

编译打包

• DockerFile镜像打包(详情请查看 build_app.sh build_core.sh build_discover.sh)
• jenkins打包（仅提供步骤脚本）

目录结构 DDD（领域驱动设计）分层 介绍:

• app/admin接口层,位于app/com/controller/目录下，也可以看做网关鉴权层（基于JWT token（使用BCryptPasswordEncoder同时兼容java和go）配合easy_mvc过滤器）
• core/服务层,也是核心业务层
• common 公共库（Domain model,Rpc model,DTO model,VO model）
• consul/存放下载好的consul可执行文件
• controller/网关层
• database/dao数据库层
• db/ 存放 mysql 表结构

项目接口分层

• app(提供app接口)
• admin(后台接口)

包管理

• mod (golang官方推荐)

安装依赖，win/mac os 命令行执行(前提，需要安装go环境，并且建议打开go mod 选项为auto，自行百度教程~)

go mod download

谈运行和debug（当然是每次都小于1秒内启动完毕，反观spring cloud那缓慢的启动时间.....）

• 下载并且安装GoLand(https://www.jetbrains.com/go/) IDE自行激活(建议使用GoLand，如果你对VSCode非常熟悉也行)
• 阅读readme.md文件
• 1打开discovery目录，选择你的系统 解压对应的 consul 可执行文件(PS consul其实也是开源go程序，这里是下载编译好的)，然后 使用右键执行脚本run_linux.sh 或者 windows.bat (goland 需要安装插件)
• 2打开app/main/App.go 找到main方法 点击绿色按钮执行(即可看到接口以及swagger完美启动)，或者 go run App.go

2020/04/06 02:32:34 [easy_mvc] swagger ui yaml config on :http://127.0.0.1:8000/doc
2020/04/06 02:32:34 [easy_mvc] swagger ui web start on :http://127.0.0.1:8000/swagger

• 3打开core/main/CoreService.go 找到main方法 点击绿色按钮执行，或者 go run CoreService.go
• 在这之后，可以在consul后台查看到启动的微服务 (http://127.0.0.1:8500/)
• 现在也可以访问接口地址 http://127.0.0.1:8000/
• 例如访问验证码接口 http://127.0.0.1:8000/api/captcha 即可返回

{"code":-1,"msg":"手机号不能空！","data":null}

最后

• 告别java的编译慢，告别过早优化万恶之源
• 快速结束开发，而且还保障高性能，保护渐渐消失的头发...
• 不失原有java服务端的简洁性，同时享受golang的异步超高并发，超快编译速度，像 python 一样简单的特性吧... 别忘记喜欢的话 GitHub地址右上角点个赞

GitHub地址 https://github.com/zhuxiujia/GoMybatisMall