引入maven依赖即可使用framework:
com.jztey framework
需要注意的是framework包含内容森罗万象,为了避免造成依赖传递,framework里面的所有依赖scope均设置为provided,需要使用framework哪部分自行引用依赖
整个公司maven版本库分为两个版本:DEV-SNAPSHOT 和 PROD-SNAPSHOT。开发环境及代码中一律使用DEV-SNAPSHOT,PROD-SNAPSHOT 仅由运维打包生产环境时使用。
打包生产环境:
mvn -N versions:set -DnewVersion=PROD-SNAPSHOTmvn deploy#如需还原:versions:revert clean
MVC
为了兼容spring-cloud,简化代码,参照JAX-RS,MVC去掉controller层,直接将service对外暴露。所有restful接口均要求写到interface中,实现类中不可以出现与http相关的内容,该interface既是spring-cloud的feign client也是dubbo的Reference。由于springMVC不支持方法参数注解继承,因此需要改造。
在springboot项目的Application.java类中导入
@Import({ ApplicationInterfaceMvc.class })public class Application {...}
使用Swagger注解以便自动产生api文档 import io.swagger.annotations.*;
自动生成api文档,在swagger注解所在工程的pom文件添加
com.github.kongchen swagger-maven-plugin true com.jztey.redmine http test-api.998jk.com /redmine redmine报表项目 v1 统计remine信息,产生报表并定时发送 ${basedir}/../doc
执行mvn swagger:generate 生成api文档
统一异常处理:RestfulGlobalExceptionHandler RestfulResultException。异常统一返回RestfulResult json串。
表单验证:使用JSR-303 javax.validation包下相关类。注意:由于spring仅支持bean注解,@PathVariable尚不支持。
Cache
Encrypt
Security
Dubbo
要使用dubbo,需要在工程中加入如下依赖
com.alibaba dubbo org.apache.zookeeper zookeeper com.github.sgroschupf zkclient org.javassist javassist
并在springboot项目的Application.java类中导入
@Import({ ApplicationDubbo.class })public class Application {...}
在application.properties进行如下配置
#微服务唯一标识,总是放在第一行spring.application.name=redmine...#dubbo配置dubbo.application.name=${spring.application.name}dubbo.registry.protocol=zookeeperdubbo.registry.address=10.3.5.36:2181,10.3.5.38:2181,10.3.5.42:2181dubbo.annotation.package=com.jztey.${spring.application.name}dubbo.protocol.port=20880 可选配置,设置dubbo端口,一台物理机部署多个微服务时才需要指定不同端口dubbo.provider.timeout=15000 可选配置,设置超时时间dubbo.consumer.check=false 可选配置,禁用启动依赖检查
Druid
要使用druid连接池,需要在工程中加入如下依赖
com.alibaba druid
并在springboot项目的Application.java类中导入
@Import({ ApplicationDruid.class })public class Application {...}
Monitoring
要使用监控,需要在工程中开启Druid并加入如下依赖
org.springframework.boot spring-boot-starter-actuator org.springframework.boot spring-boot-starter-security
并在springboot项目的Application.java类中导入
@Import({ ApplicationDruid.class, ApplicationMonitoring.class })public class Application {...}
在application.properties进行如下配置
#微服务唯一标识,总是放在第一行spring.application.name=redmine...#日志logging.file=${spring.application.name}.log#logging.level.root=DEBUG
默认actuator监控路径为 /monitoring/health, druid健康路径为 /monitoring/druid/index.html, 默认账号密码为admin/admin
配置application.properties logging.file=${spring.application.name}.log 后可以在 /monitoring/logfile 看到服务器日志, 更多监控endpoint请参照springboot文档