iot-manage/jeecg-boot

Jeecg-Boot 低代码开发平台

当前最新版本： 3.4.0（发布日期：20220808）

后端技术架构

• 基础框架：Spring Boot 2.6.6

• 持久层框架：Mybatis-plus 3.5.1

• 安全框架：Apache Shiro 1.8.0，Jwt 3.11.0

• 数据库连接池：阿里巴巴Druid 1.1.22

• 缓存框架：redis

• 日志打印：logback

• 其他：fastjson，poi，Swagger-ui，quartz, lombok（简化代码）等。

开发环境

• 语言：Java 8

• IDE(JAVA)： Eclipse安装lombok插件 或者 IDEA

• 依赖管理：Maven

• 数据库：MySQL5.7+ & Oracle 11g & SqlServer & postgresql & 国产等更多数据库

• 缓存：Redis

技术文档

• 在线演示 ： http://boot.jeecg.com

• 在线文档： http://doc.jeecg.com

• 常见问题： http://jeecg.com/doc/qa

• QQ交流群 ： ⑤860162132、④774126647(满)、③816531124(满)、②769925425(满)、①284271917(满)

Docker镜像启动后台

• Docker镜像单体启动 ： http://doc.jeecg.com/2043889
• Docker镜像微服务启动： http://doc.jeecg.com/3040737

下面是单体启动步骤：

注意： 如果本地安装了mysql和redis,启动容器前先停掉本地服务，不然会端口冲突。
       net stop redis
       net stop mysql
 
# 1.配置host
    127.0.0.1   jeecg-boot-redis
    127.0.0.1   jeecg-boot-mysql
    127.0.0.1   jeecg-boot-system
  
# 2.修改application-dev.yml文件的数据库和redis链接
    修改数据库连接和redis连接，将连接改成host方式

# 3.进jeecg-boot根目录，执行maven命令
    mvn clean package

# 4.启动镜像组
    docker-compose up -d

# 5.访问后台项目（等待2分钟左右后）
    http://localhost:8080/jeecg-boot/doc.html

其他： 重新构建镜像组（当你改变本地代码，也可重新构建镜像）

   docker-compose build

专项文档

一、查询过滤器用法

QueryWrapper<?> queryWrapper = QueryGenerator.initQueryWrapper(?, req.getParameterMap());

代码示例：

	@GetMapping(value = "/list")
	public Result<IPage<JeecgDemo>> list(JeecgDemo jeecgDemo, @RequestParam(name = "pageNo", defaultValue = "1") Integer pageNo, 
	                                     @RequestParam(name = "pageSize", defaultValue = "10") Integer pageSize,
			HttpServletRequest req) {
		Result<IPage<JeecgDemo>> result = new Result<IPage<JeecgDemo>>();
		
		//调用QueryGenerator的initQueryWrapper
		QueryWrapper<JeecgDemo> queryWrapper = QueryGenerator.initQueryWrapper(jeecgDemo, req.getParameterMap());
		
		Page<JeecgDemo> page = new Page<JeecgDemo>(pageNo, pageSize);
		IPage<JeecgDemo> pageList = jeecgDemoService.page(page, queryWrapper);
		result.setSuccess(true);
		result.setResult(pageList);
		return result;
	}

• 查询规则 (本规则不适用于高级查询,高级查询有自己对应的查询类型可以选择 )

查询模式	用法	说明
模糊查询	支持左右模糊和全模糊 需要在查询输入框内前或后带*或是前后全部带*
取非查询	在查询输入框前面输入! 则查询该字段不等于输入值的数据(数值类型不支持此种查询,可以将数值字段定义为字符串类型的)
> >= < <=	同取非查询 在输入框前面输入对应特殊字符即表示走对应规则查询
in查询	若传入的数据带,(逗号) 则表示该查询为in查询
多选字段模糊查询	上述4 有一个特例，若某一查询字段前后都带逗号 则会将其视为走这种查询方式 ,该查询方式是将查询条件以逗号分割再遍历数组 将每个元素作like查询 用or拼接,例如 现在name传入值 ,a,b,c, 那么结果sql就是 name like '%a%' or name like '%b%' or name like '%c%'

二、AutoPoi(EXCEL工具类-EasyPOI衍变升级重构版本）

在线文档

三、代码生成器

功能说明： 一键生成的代码（包括：controller、service、dao、mapper、entity、vue）

• 模板位置： src/main/resources/jeecg/code-template
• 技术文档： http://doc.jeecg.com/2043916

四、编码排重使用示例

重复校验效果：

1.引入排重接口,代码如下:

import { duplicateCheck } from '@/api/api'

2.找到编码必填校验规则的前端代码,代码如下:

<a-input placeholder="请输入编码" v-decorator="['code', validatorRules.code ]"/>

code: {
            rules: [
              { required: true, message: '请输入编码!' },
              {validator: this.validateCode}
            ]
          },

3.找到rules里validator对应的方法在哪里,然后使用第一步中引入的排重校验接口.
以用户online表单编码为示例,其中四个必传的参数有:

  {tableName:表名,fieldName:字段名,fieldVal:字段值,dataId:表的主键},

具体使用代码如下:

    validateCode(rule, value, callback){
        let pattern = /^[a-z|A-Z][a-z|A-Z|\d|_|-]{0,}$/;
        if(!pattern.test(value)){
          callback('编码必须以字母开头，可包含数字、下划线、横杠');
        } else {
          var params = {
            tableName: "onl_cgreport_head",
            fieldName: "code",
            fieldVal: value,
            dataId: this.model.id
          };
          duplicateCheck(params).then((res)=>{
            if(res.success){
             callback();
            }else{
              callback(res.message);
            }
          })
        }
      },