auto-code-admin

欢迎使用 auto-code-admin 后台代码自动生成引擎演示地址账号 ztp 密码 111111

项目实现的功能介绍

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 "";
}

页面展示

进阶篇

如何进行项目集群

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

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文件

auto-code-admin后台代码自动生成引擎