一文看懂分布式企业开发平台

一、简介

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系列