/app-engine

分布式App服务端快速开发框架

Primary LanguageJavaApache License 2.0Apache-2.0

app-engine 是一个分布式的App服务端快速开发框架,包含了基本的权限认证、日志处理、接口防刷、系统监控等基本功能。 此框架围绕分布式服务系统构建,能够快速扩容,迎合微服务化,提供App服务端常用必备功能。

技术栈:

  1. Spring Boot / Spring MVC / Spring Data Jpa
  2. Gradle
  3. Java8
  4. Logback
  5. Lombok

功能列表:

  1. 认证方式: Basic、 Cookie、Header、内外网
  2. 统一错误处理、统一Json格式模板
  3. 接口请求日志统一处理
  4. 接口频次拦截
  5. 支持多数据源、主从分离
  6. 多Profile支持,Gradle、Spring、应用程序Profile整合
  7. 完善的系统监控
  8. 热部署
  9. 自动生成接口文档
  10. docker支持(gradle创建image、docker-compose)

环境配置

区分有三种环境dev、test、prod,不同环境会加载不同的配置文件

  1. Gradle环境配置: gradle.properties里设置profile
  2. Spring环境变量: application.yaml或application.properties里配置spring.profiles.active
  3. 应用内获取环境变量: spring注入: @Autowired Environment env 或手动解析spring配置文件(不依赖Spring)

数据源配置

  1. 如果安装了docker,直接执行 deploy/bin/init_redis.sh脚本
  2. 手动安装: redis: ip:127.0.0.1 port:6379 password:无

可执行jar包

运行 gradle clean jar assemble 会自动打可执行jar包,运行:

  1. java -jar deploy/build/libs/deploy-${version}.jar
  2. ./deploy/build/libs/deploy-${version}.jar 如需配置JVM等参数请修复deploy/config/deploy-${version}.conf并拷贝到可执行jar包相同目录,并修改${version}

发布jar/war包到私有仓库

  1. 修改build.gradle里uploadArchives的私有仓库地址、用户名、密码
  2. 执行 ./gradlew uploadArchives 命令

运行项目方式

  1. 执行: gradle run
  2. 执行运行: Application.java
  3. 执行: ./gradlew run,此方式不用安装gradle

checkstyle findbugs

  1. 指定 gradle check
  2. 在build/reports目录会生成相关报告文件

监控

接口文档

TODO

  • 完善注释
  • 完善文档
  • 添加单元测试、集成测试、压力测试