# demo-code

**Repository Path**: kzc_666/demo-code

## Basic Information

- **Project Name**: demo-code
- **Description**: UCode Cms代码生成器快速开始脚手架
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://www.altitude.xin
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 20
- **Created**: 2022-03-26
- **Last Updated**: 2022-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 一、序言

`UCode Cms` 是一款Maven版的Java源代码生成器，是快速构建项目的利器。代码生成器模块属于可拆卸模块，即按需引入。代码生成器生成Spring、SpringBoot、MybatisPlus风格的源代码。

面试时经常提到面向对象编程，实际开发中常常是面向数据库编程，随着需求的快速变化，数据库的库表结构也需要相应变化，如何根据库表结构的变化，快速响应到源代码层次，是Java代码生成器主要的关切点。

> 本项目仅仅是为了方便使用而提供的`示例项目`，[原始项目](https://gitee.com/decsa/ucode-cms-vue) 地址访问路径在这里，觉得不错的小伙伴动动小手给个star吧。
> [Java知识图谱](http://www.altitude.xin) 网站汇聚近百余篇专题技术博客，欢迎来踩！！！

##### 功能亮点

实时读取库表结构元数据信息，比如表名、字段名、字段类型、注释等，选中修改后的表，点击`一键生成`，代码成即可提现出表结构的变化。

单表快速转化restful风格的API接口并对外暴露服务。对于百余张表的数据库，使用代码生成器让开发事半功倍。

多表连接查询。多表连接查询默认不开启，需要在全局文件中手动配置。开启后代码生成器会自动读取数据库元数据信息中的主外键关系，分别生成`一对一`、`一对多`、`多对多`风格的源代码。

生成的代码接口可通过Swagger暴露。

### 二、运行依赖服务

代码生成器运行依赖Mysql数据库、Redis服务，版本不限。

##### Mysql数据库

Mysql数据库中库表结构分为两部分，一是系统运行必要的系统表（跟代码生成业务无关），二是用户自定义的库表，代码生成将会读取。
项目SQL脚本提供5张测试表，方便用于测试使用。

##### Redis服务

Redis服务跟代码生成业务无关，系统中其它业务用到Redis，因此也依赖Redis服务。

### 三、快速入门使用

使用demo脚手架[cms demo项目](https://gitee.com/decsa/demo-code)，可直接跳转到步骤三。脚手架是标准的Spring Web工程，内置少量配置信息，用户替换后可快速上手。

```bash
# 拉去脚手架，并初始化项目
git clone https://gitee.com/decsa/demo-code.git
```

##### 1、前提条件

引入如下依赖是使用代码生成器功能的前提条件，其中`代码生成器模块`在代码生成完毕后，建议移出。

```xml
<!--ucode-cms核心依赖-->
<dependency>
    <groupId>xin.altitude.cms</groupId>
    <artifactId>ucode-cms-spring-boot-starter</artifactId>
    <version>1.4.0</version>
</dependency>
<!--代码生成器模块（非必选）-->
<dependency>
    <groupId>xin.altitude.cms.code</groupId>
    <artifactId>ucode-cms-code-spring-boot-starter</artifactId>
    <version>1.4.0</version>
</dependency>
```

##### 2、全局配置

环境变量必须绑定为开发环境，代码生成器仅在开发模式下生效。打包时即使不移除相关Maven依赖，运行时在非开发环境时，相应代码不加载。建议在打包时移除。

```
spring:
  profiles:
    active: dev
```

##### 3、数据库文件

数据库脚本有两类：核心SQL和用户自定义表结构。

```
sql/
├── cms（必选）.sql                                 // 核心脚本（必选）    
```

导入系统表后，用户需自定义业务表，方可体验代码生成的功能。

##### 4、连接数据库

如果已经配置完数据库连接，则可忽略此步骤

```
spring:
  datasource:
    # 主库数据源
    url: jdbc:mysql://localhost:3306/ucode-cms?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: 123456
```

##### 5、可视化界面

访问可视化界面操作需要生成代码的表

![](https://www.altitude.xin/typora/image-20220216105356896.png)

##### 6、重启项目

勾选表结构，点击生成，重启项目，相应的代码生效。访问地址`http://localhost:8080/doc.html`访问接口列表。

![](https://www.altitude.xin/typora/image-20220215114641102.png)

接口列表
![](https://www.altitude.xin/typora/image-20220216172127541.png)

### 四、高级使用

在完成简单入门体验后，需要了解代码生成的高级部分，即全局配置。在项目中搜索类名`CodeProperties`即可查看所有内置可供修改的参数，在全局`yml`文件中覆盖默认值即可完成修改，按需配置。

##### 单表处理

当全局配置`ucode.code.joinQuery = false`或者使用默认配置时，则仅处理单表结构。将表名、字段名、字段类型、备注信息转化为SSM风格的源代码。

##### 多表连接

当在全局配置`ucode.code.joinQuery = true`时，则手动开启主外键查询，系统会自动读取表的主外键关系，并将其转化为连接查询的源代码。

##### 主要参数

| 参数                           | 默认值               | 使用备注                                           |
| ------------------------------ | -------------------- | -------------------------------------------------- |
| `ucode.code.projectDir`        | 空                   | 用户自定义多模块项目需要指定项目名                 |
| `ucode.code.removeTablePrefix` | `false`              | 根据需要是否在生成代码时移除表前缀                 |
| `ucode.code.packageName`       | `xin.altitude.front` | 配置用户自己的包名                                 |
| `ucode.code.useLombok`         | `true`               | 默认使用Lombok                                     |
| `ucode.code.filterSysTable`    | `true`               | 默认过滤不显示系统表                               |
| `ucode.code.joinQuery`         | `false`              | 是否使用连接查询（默认单表查询）                   |
| `ucode.code.xml.addXml`        | `false`              | 虽然说不建议使用XML文件编写SQL，但仍提高可开启开关 |
| `ucode.code.mapper.useCache`   | `true`               | 默认开启二级缓存，自定义业务缓存可关闭             |

### 五、常见问题
##### 1、找不到依赖？
找不到依赖很大可能是因为阿里云景象仓库尚未同步完成Jar包，在项目中`pom`文件添加如下配置：
```xml
<repository>
    <id>public</id>
    <name>maven nexus</name>
    <url>https://repo1.maven.org/maven2/</url>
    <snapshots>
        <updatePolicy>always</updatePolicy>
    </snapshots>
    <releases>
        <updatePolicy>always</updatePolicy>
    </releases>
</repository>
```
##### 2、项目打包发布时如何处理代码生成器依赖？
项目打包发布时建议手动移除代码生成器依赖，实际上代码生成器的生命周期存在于开发阶段。手动不移出对打包不会产生影响，但不推荐这么做。
```xml
<!--代码生成器模块（非必选）-->
<dependency>
    <groupId>xin.altitude.cms.code</groupId>
    <artifactId>ucode-cms-code-spring-boot-starter</artifactId>
    <version>1.4.0</version>
</dependency>
```

##### 3、多表连接查询异常
对表连接查询是一项复杂的业务，目前支持：一个员工对应一个部门（一对一）、一个部门对应多个员工（一对多）、一名学生可选修多门课程每门课程可被多名学生选修（多对多）。
更高级别的套娃尚不支持。

##### 4、生成后的代码能无缝迁移到新项目吗？
能。生成的代码具有高度的迁移属性，在新项目中导入缺省依赖即可。如果找不到相关依赖，请参考问题一。


> 点♥️赞♥️支持一下吧，相关源码在[GitHub](https://gitee.com/decsa)，视频讲解在[B站](https://space.bilibili.com/1936685014)，本文收藏在[专题博客](http://www.altitude.xin)。