微服务解决方案 Golang商城微服务项目

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注解） ```go 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 ```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 即可返回 ```json {"code":-1,"msg":"手机号不能空！","data":null} ``` ### 最后 * 告别java的编译慢，告别过早优化万恶之源 * 快速结束开发，而且还保障高性能，保护渐渐消失的头发... * 不失原有java服务端的简洁性，同时享受golang的异步超高并发，超快编译速度，像python一样简单的特性吧... 别忘记喜欢的话 GitHub地址右上角点个赞 GitHub地址 https://github.com/zhuxiujia/GoMybatisMall