readme.md · 弓长张/code-gen

# code-gen

一款代码生成工具，可自定义模板生成不同的代码，支持MySQL、Oracle、SQL Server、PostgreSQL。

- 只需要一个Java8环境，下载后即可运行使用。
- 步骤简单，只需配置一个数据源，然后勾选模板即可生成代码。
- 默认提供了通用的实体类、mybatis接口、mybatis配置文件模板，可以快速开发mybatis应用。

> 用到的技术：SpringBoot + Mybatis + Vue

## 使用步骤

- 前往[发行版页面](https://gitee.com/durcframework/code-gen/releases)，下载最新版本zip文件
- 解压zip，如果是Mac/Linux操作系统，运行`startup.sh`文件启动，Windows操作系统运行cmd输入`java -jar gen.jar`启动
- 浏览器访问`http://localhost:6969/`

默认端口是6969，更改端口号按如下方式：

- Mac/Linux操作系统：打开`startup.sh`文件，修改`--server.port`参数值
- Windows操作系统：可执行：`java -jar gen.jar --server.port=端口号`

### docker运行

- 方式一：下载公共镜像

`docker pull tanghc2020/gen:latest`

下载完毕后，执行`docker run --name gen -p 6969:6969 -d <镜像ID>`

浏览器访问`http://ip:6969/`

后续更新替换jar文件和view文件夹即可。

- 方式二：本地构建镜像

clone代码，然后执行`docker-build.sh`脚本

执行`docker run --name gen -p 6969:6969 -d <镜像ID>`

## 其它

- [快速搭建SpringBoot+Mybatis应用](https://gitee.com/durcframework/code-gen/wikis/pages?sort_id=2478942&doc_id=27724)
- [更多模板](https://gitee.com/durcframework/code-gen/wikis/pages?sort_id=2979234&doc_id=27724)
- [代码生成器原理](https://gitee.com/durcframework/code-gen/wikis/pages?sort_id=3287812&doc_id=27724)

## 工程说明

- front：前端vue
- gen：后端服务
- db：数据库初始化文件
- script：辅助脚本

## 本地开发

- 运行`gen`下的`com.gitee.gen.GenApplication`（SpringBoot工程）
- 运行`front`下的前端项目，详见：[readme](./front/README.md)

## 参与贡献

欢迎贡献代码，完善功能，PR请提交到`pr`分支

## 自主构建

> 需要安装Maven3，Java8

- 自动构建[推荐]：

Mac/Linux系统可直接执行`build.sh`进行构建，构建结果在`dist/gen`文件夹下。

- 手动构建：
  
    > 前提：安装nodejs，Java8，maven3

`cd front`
    
    - 执行`npm install --registry=https://registry.npm.taobao.org`
    - 执行`npm run build:prod`
    
    `cd ..`
    
    - 执行`mvn clean package`，在`gen/target`下会生成一个`gen-1.0.0-SNAPSHOT.jar`（xx表示本号）
    - 将`gen-1.0.0-SNAPSHOT.jar`放在`dist/gen`下，确保jar和`view`在同一目录
    - 执行`java -jar gen-xx-SNAPSHOT.jar`
    - 浏览器访问`http://localhost:6969/`
## 构建多平台

- 安装多平台buildx : `docker buildx create --use --name m1_builder`

- 查看并启动 builder 实例：`docker buildx inspect --bootstrap`

- 一次打包多平台镜像并推送
    - 打包多平台镜像并推送：`docker buildx build -t tanghc2020/gen --platform=linux/amd64,linux/arm64/v8 . --push`
  - 或打包保存在本地
    - 打包x64平台镜像在本地：`docker buildx build -t tanghc2020/gen --platform=linux/amd64 -o type=docker .`
    - 打包arm64平台镜像在本地：`docker buildx build -t tanghc2020/gen --platform=linux/arm64/v8 -o type=docker .`
  - 快速运行：`docker  run -d -p 6969:6969 tanghc2020/gen`

## 效果图

![代码生成](https://images.gitee.com/uploads/images/2020/0724/180853_df66e76d_332975.png "gen7.png")

![生成结果](https://images.gitee.com/uploads/images/2020/0731/085506_9d66201f_332975.png "gen8.png")

弓长张/code-gen

简介

发行版

贡献者

近期动态

弓长张/code-gen .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

弓长张/code-gen