/springboot-dubbo

Spring Boot & MyBatis & Dubbo 种子项目，用于快速构建中大型RESTful API项目。

Primary LanguageJava

简介

springboot-dubbo 是一个基于Spring Boot & MyBatis & dubbo的种子项目，用于快速构建 RESTful API 项目； 稳定、简单、快速，使我们摆脱那些重复劳动，专注于业务代码的编写，减少加班。

特征&提供

  • 统一响应结果封装及生成工具
  • 统一异常处理
  • 简单的接口签名认证
  • 常用基础方法抽象封装
  • 使用Druid Spring Boot Starter 集成Druid数据库连接池与监控
  • 使用FastJsonHttpMessageConverter，提高JSON序列化速度
  • 集成MyBatis、通用Mapper插件、PageHelper分页插件，实现单表业务零SQL
  • 提供代码生成器根据表名生成对应的Model、Mapper、MapperXML、Service、ServiceImpl、Controller等基础代码，其中Controller模板默认提供POST和RESTful两套，根据需求在CodeGenerator.genController(tableName)方法中自己选择，默认使用RESTful模板。代码模板可根据实际项目的需求来扩展，由于每个公司业务都不太一样，所以只提供了一些比较基础、通用的模板，主要是提供一个思路来减少重复代码的编写，我在实际项目的使用中，其实根据公司业务的抽象编写了大量的模板。另外，使用模板也有助于保持团队代码风格的统一  

快速开始

  1. 克隆项目
  2. 对test包内的代码生成器CodeGenerator进行配置，主要是JDBC，因为要根据表名来生成代码
  3. 如果只是想根据上面的演示来亲自试试的话可以使用test resources目录下的demo-user.sql，否则忽略该步
  4. 输入表名，运行CodeGenerator.main()方法，生成基础代码（可能需要刷新项目目录才会出来）
  5. 根据业务在基础代码上进行扩展
  6. 对开发环境配置文件application-dev.properties进行配置，启动项目，Have Fun！  

开发建议

  • 表名，建议使用小写，多个单词使用下划线拼接
  • Model内成员变量建议与表字段数量对应，如需扩展成员变量（比如连表查询）建议创建DTO，否则需在扩展的成员变量上加@Transient注解，详情见通用Mapper插件文档说明
  • 建议业务失败直接使用ServiceException("message")抛出，由统一异常处理器来封装业务失败的响应结果，比如throw new ServiceException("该手机号已被注册")，会直接被封装为{"code":400,"message":"该手机号已被注册"}返回，无需自己处理，尽情抛出
  • 需要工具类的话建议先从apache-commons-*和guava中找，实在没有再造轮子或引入类库，尽量精简项目
  • 开发规范建议遵循阿里巴巴Java开发手册（最新版下载)  

技术选型&文档

安装 Zookeeper 环境

这里只演示mac系统，win请自行百度

# 安装
brew install zookeeper

# 启动
zkServer

# 查看运行状态
zkCli