当前仓库属于关闭状态,部分功能使用受限,详情请查阅 仓库状态说明
31 Star 89 Fork 67

ztp / auto-code-admin
关闭

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 8.13 KB
一键复制 编辑 原始数据 按行查看 历史

auto-code-admin

欢迎使用auto-code-admin后台代码自动生成引擎 演示地址 账号 ztp 密码 111111(服务器在美国,有时访问可能比较慢.)

更新

2019-05-09: 版本 2.1.2

1.移除Swagger(这个东西代码入侵性太强.里面也有一些BUG), 如需使用请在自己的项目增加swagger jar包 然后将 globalConfig.sswagger 设置为true

2019-05-08: 版本 2.1.1

1.生成的bean不再忽略转译之前的get方法了

2.BaseDao,BaseService 增加 selectByConditionFirst方法.返回第一条记录

2019-03-22: 版本:2.1.0 生成代码增加可视化视图,不再需要写yaml文件配置了

2019-03-18 增加 swagger api支持

1.增加权限 auto-code-admin/update_sql/2019-03-18.sql
2. yaml 文件 globalConfig 增加  swagger: true 配置

项目介绍

项目实现的功能介绍

1.用户,角色,权限管理(权限控制到按钮)

2.图片管理

3.操作日志(针对于用户,每次点击的记录都会被记录)

4.报表管理

5.代码生成 (支持可视化生成单表, 一对一, 一对多 ,多对多代码.)

项目的优势在哪里

1.目前市面上的代码生成工具绝大多数仅仅支持生成单表,该项目支持 单表, 一对一, 一对多 ,多对多 以及所对应的页面生成.大大简化了开发的工作量

2.该项目仅仅只是帮你生成单表以及多表的增删改查,不做任何底层的改动.只要你知道怎么使用 spring boot+mybatis技术.就能看懂代码

什么情况选择该项目

1.该项目前后台代码一起生成.如果你是做后台.页面展示比较固定.该项目非常适合你

2.如果你们采用前后台分离.或者开发的页面模板不固定.请使用 auto-code 该项目. 这个项目只生成接口适用性很广.spring boot项目和传统的javaweb项目都适用.不管是一次开发还是二次开发, 只需要简单的集成一个jar包以及少量的配置.就能生成代码

为何会发起该项目?

绝大多数时候我们都是在做增删改查.每次创建一张表.然后我们需要重新写一次增删改查, 写虽然简单,不过极度耗时(controller,server,serverImpl,dao,xml) 所以才有了该项目,该项目能帮助我们减少后台开发的80%的工作量,让你专注于业务的实现.

软件架构

1.基于 springboot 2.0.7+mybatis+mysql
2.基于代码生成引擎做了页面的生成扩展 auto-code [源码地址](https://gitee.com/ztp/auto-code)
3.模板引擎-> thymeleaf 
4.前端主要使用layui
5.前端后台框架layuiAdmin  https://github.com/coderyangjie/layuiAdmin

项目模块介绍

auto-code-admin(根节点)
  -auto-code-generator  代码生成配置
  -auto-code-common ->一些公共的类,以及配置
  -auto-code-sys ->系统设置,权限,日志模块
  -auto-code-charts ->报表模块
  -auto-code-web ->发布模块(该模块聚合以上模块进行发布,如果报表模块不想使用直接在pom.xml将该模块注释掉就好.)

安装教程

1.安装jdk1.8+, mysql5.0+,maven,git 
2.下载源码
3. 导入 auto-code-admin 下的 auto_code.sql 初始化数据库
4. 修改 auto-code-web/application-dev.properties 中的数据库连接以及用户名密码
5. auto-code-admin 打开cmd密令 执行 mvn clean package
6. auto-code-admin/auto-code-web/target 找到jar包 执行 java -jar auto-code-web.jar
7. 访问 http://localhost:8080

代码生成教程

登录之后点击 代码生成页面.然后就可以生成代码了 更多配置请参见

登录

生成代码注意事项

1.多表支持无限级联生成. 比如 用户和收货地址对应,用户表和班级对应...

2.创建表结构时如果写上表与字段的注释将大大增加程序的可读性.我会将注释写到bean上面. 以及页面上.没有写注释还需要页面修改对应的值.会加大工作量.举例:


CREATE TABLE `test_code` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '测试生成代码',
  `name` varchar(50) DEFAULT NULL COMMENT '名称',
  `age` int(3) DEFAULT NULL COMMENT '年龄',
  `status` int(2) DEFAULT NULL COMMENT '{"name":"状态","1":"启用","0":"禁用"}',
  `birthday` date DEFAULT NULL COMMENT '生日',
  `remarks` text COMMENT '备注',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8 COMMENT='测试生成代码'

3.如果注释为json键值对字符串我将会在实体类生成一个字典方法 如: {"name":"状态","1":"启用","0":"禁用"} 将会在实体类里面生成如下,同时页面展示的名称将是 "状态"

public String getStatus_(){
    if(MyStringUtils.isEmpty(status)){
         return "";
    }else if(status.equals("1")){
        return "启用";
    }else if(status.equals("0")){
        return "禁用";
    }
    return "";
}

页面展示 select

进阶篇

如何进行项目集群

集群非常简单只需要简单的几部就能完成

1.安装redis

2.修改 auto-code-admin/pom.xml

<dependency>
    <groupId>com.zengtengpeng</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>1.0.2</version>
</dependency>

3.修改 auto-code-web/application-dev.properties 配置文件 增加redis配置

#单Redis节点模式
redisson.singleServerConfig.address=127.0.0.1:6379
server.port=8070

4.在启动类上面加上 @EnableRedissonHttpSession 注解

@SpringBootApplication
@EnableRedissonHttpSession
public class RedissonApplication {

    public static void main(String[] args) {
        SpringApplication.run(RedissonApplication.class, args);
    }

}

5.为何不使用 spring-boot-starter-data-redis 做集群?

用spring-boot-starter-data-redis做集群也是可以的,不过该项目使用的是jedis客户端做的集群, 往往项目一旦做了集群意味着要开始做分布式锁了.jedis在2.10.6版本以下会造成死锁. 之后才增加了一个一个方法修复这个问题,然后这个锁只是单机的.redlock他是没有实现的. 真正实现了redlock 的只有redssion. 本项目就是在redssion上做的一个starter. 只需要一个简单的注解 @Lock 就是实现 可重入锁,公平锁,联锁,红锁,读写锁.支持各种集群模式.同时也支持MQ,以及存储数据. 详情请参见:redisson-spring-boot-starter源码地址

权限机制的实现

本项目采用拦截器管理权限 具体实现 com.zengtengpeng.interceptor.UserInterceptor

1.具体怎么实现?  权限默认采用@RequestMapping映射值作为权限校验.
2.如果两个url想采用一个权限怎么办? 使用 com.zengtengpeng.common.annotation.Auth 注解, 
值为 另外一个权限url.这样他们就共享同一个授权了,如果不写值默认只要登录就有该权限.
3.如果该方法不需要登录就能访问怎么办? com.zengtengpeng.common.annotation.Pass 
注解标注在方法上.该方法就不需要授权

配置参数介绍

基础请参照参数 auto-code,admin在基础参数的基础上扩展了两个特有的参数

参数名 默认值 介绍
authParentId 添加权限到表的父id.如果为空则不自动生成权限
thymeleafPath templates thymeleaf 放置页面的文件目录

如何升级

1.下载项目后,自己的代码请放到 auto-code-web子模块或者自己重新新建模块
2.更新请将 auto-code-common,auto-code-generator,auto-code-sys 覆盖成最新的代码就行.
3.如果数据库有更新我会在上面更新介绍更新的SQL文件
Java
1
https://gitee.com/ztp/auto-code-admin.git
git@gitee.com:ztp/auto-code-admin.git
ztp
auto-code-admin
auto-code-admin
master

搜索帮助