Sky Cloud

文档地址

• quick-start

代码结构

• framework-dependencies framework项目 1rd part jar包兼容版本依赖管理

• framework-bom framework项目 3rd part jar包版本依赖管理

• framework-generator-plugin 代码生成器插件支持jar包

• framework-dao 存储层代码封装,如:hive hbase等

  • framework-dao-hive
  • framework-dao-hbase
  • framework-dao-mybatis
  • framework-dao-mybatis-plus

• framework-web Spring Boot Web 脚手架依赖

• framework-model 公共DTO实体与分页实体

• framework-rpc 远程调用框架(暂时用于学习)

• framework-integrate 整合其他三方库,如netty、spark等

  • framework-integrate-canal 同步mysql binlog
  • framework-integrate-validator 业务参数验证器,使用方法请读本项目readme.md
  • framework-integrate-redis redis,使用方法请读本项目readme.md
  • framework-integrate-rocketmq mq,使用方法请读本项目readme.md
  • framework-integrate-job 分布式定时任务,使用方法请读本项目readme.md
  • framework-integrate-logback 自定义logback appenderreadme.md

• framework-util 工具类

  • framework-util-common 公共工具类包
  • framework-util-oss 对象资源存储readme.md
  • framework-util-threadpool 线程池工具类,使用方法请读本项目readme.md

git 分支开发规约

• 使用git flow 流程，分支名称分别以 feature-* 、 release-* 、hotfix-* 开头
• 版本号：<主版本>.<次版本>.<增量版本>-<代号>
  • 方式1: 升级版本号命令: mvn versions:set -DnewVersion=x.x.x
  • 方式2: 升级版本号命令
    • mvn release:prepare
      1. 把项目打一个release版本
      2. 在git的tag中打一个tag
      3. 自动升级SNAPSHOT 并提交更新后的pom文件到git
    • mvn release:rollback
      1. 回滚,但不会删除tag
    • mvn release:perform
      1. 去git的tag上拿代码
      2. 用tag上的代码，打一个release版的包
      3. deploy到的maven私服
  • 方式3: 仅修改 pom.xml --> 1.0.0-SNAPSHOT 属性
  • 推荐方式3
• 代号版本
  • SNAPSHOT: 用于develop/hotfix
  • RC数字: 用于测试阶段
  • RELEASE: 正式发布版
  • 具体列子:
    1. 开发版本: 1.1.0-SNAPSHOT、1.2.0-SNAPSHOT、2.1.0-SNAPSHOT
    2. 稳定版本:
       1. 候选发布版本: 1.1.0-RC1、1.2.0-RC2
       2. 正式发布版本: 1.1.0-RELEASE、1.1.1-RELEASE

git message 规约

用于生成规范changelog

提交格式

1. 请点我
2. idea 可使用 git commit template 插件
3. npm 可以使用 commitizen

生成changelog方式

运行docs/script/changelog/gitlog.sh

javadoc生成方式

mvn javadoc:javadoc

问题反馈

• 在使用中有任何问题，欢迎反馈

开发计划

1.0.0 logback appender 、mybatis-plus 1.0.1 canal

关于作者

LICENSE

MIT License

Copyright (c) 2019 framework

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.