一、简介
1.1 概述
XXL-DEEP 是一个分布式企业开发平台。基于 “SpringBoot+XXL技术栈” 进行系统架构。
提供整套开箱即用的基础模块，包括：权限管理、用户管理、代码生成、服务治理、配置中心、调度中心……等，努力为中小型企业打造开箱即用的分布式企业开发解决方案。
1.2 特性
- 1、权限管理：灵活、细粒度权限管控；
- 2、用户管理：在线、多角色用户管理；
- 3、代码生成：轻量级、多层代码自动生成 "controller/service/dao/mybatis/model" ，参与到开发全流程；
- 4、服务治理：分布式服务通讯与治理能力；
- 5、配置中心：分布式配置管理能力；
- 6、调度中心：分布式任务调度能力；
1.3 环境
- JDK：1.8+
二、快速入门
第一步：编译项目
项目目录结构如下：
- xxl-deep
- xxl-deep-admin : 基础管理平台
- xxl-deep-xx-service : XX业务-服务模块
- xxx-deep-xx-api : XX业务-API模块
- xxx-deep-xx-web : XX业务-Web服务
第二步：部署运行
应用 “xxl-deep-admin” 是个spring boot应用，直接启动运行即可。
三、操作指南
3.1、代码生成
第一步：准备SQL
代码生成，是以数据库表为维度进行生成。所以，需要准备好待生成代码的表SQL脚本。
然后进入代码生成平台，将建表SQL脚本填写到 "表结构信息" 输入框即可。
（默认已经提供了一个供参考Demo表SQL脚本，可操作体验下）
表结构SQL
第二步：生成代码
点击右上角 "生成代码按钮"，即可完整多层代码的生成，非常方便；
生成代码
第三步：Finish
代码生成后，可在界面查看和使用 "controller/service/dao/mybatis/model" 多层源代码。部分截图如下：
image.png
image.png
image.png
image.png
image.png
image.png
四、总体设计
4.1、设计思想
略
4.2、代码生成
公共响应结果：ReturnT
统一接口返回数据类型，有利于接口对接与效率提升；因此生成的多层代码交互时，采用统一ReturnT，源码如下:
import java.io.Serializable;
/**
* common return
* @author xuxueli 2015-12-4 16:32:31
*/
public class ReturnT<T> implements Serializable {
public static final long serialVersionUID = 42L;
public static final int SUCCESS_CODE = 200;
public static final int FAIL_CODE = 500;
public static final ReturnT<String> SUCCESS = new ReturnT<String>(null);
public static final ReturnT<String> FAIL = new ReturnT<String>(FAIL_CODE, null);
private int code;
private String msg;
private T data;
public ReturnT(int code, String msg) {
this.code = code;
this.msg = msg;
}
public ReturnT(T data) {
this.code = SUCCESS_CODE;
this.data = data;
}
public int getCode() {
return code;
}
public void setCode(int code) {
this.code = code;
}
public String getMsg() {
return msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
public T getData() {
return data;
}
public void setData(T data) {
this.data = data;
}
}
代码生成特性
代码生成拥有如下特性：
- 1、简洁：界面操作，简洁直观，可快速上手；
- 2、轻量级：仅需提供建表SQL，即可自动完成代码生成，简洁高效；
- 3、多层代码生成：自动生成 "controller/service/dao/mybatis/model" 多层代码，参与到开发全流程；
- 4、高效：从SQL到API接口，全部代码均支持自动生成，极大提高生产力和效率；
- 5、在线预览：代码生成后，支持实时在线预览，直接复制使用；
来源
许雪里老师的xxl系列
