EzAdmin 低代码开发工具

一、快速开始

Maven 依赖

根据您的 Java 版本选择对应的依赖：

<!-- Java 17 -->
<dependency>
    <groupId>io.github.ezadmin126</groupId>
    <artifactId>ezadmin-java17-spring-starter</artifactId>
    <version>3.0.7</version>
</dependency>

<!-- Java 8 -->
<dependency>
    <groupId>io.github.ezadmin126</groupId>
    <artifactId>ezadmin-java8-spring-starter</artifactId>
    <version>3.0.7</version>
</dependency>

启用配置

在 Spring Boot 主类上添加 @EnableEzadmin 注解：

@SpringBootApplication
@EnableEzadmin
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

application.yml 配置

在 application.yml 中配置 EzAdmin 相关参数：

topezadmin:
  # 缓存开关，开发时建议设为 false
  cacheFlag: false

  # 数据源配置（多个用逗号分隔）
  datasourceBeanNames: 'dataSource'

  # 文件上传配置
  uploadPath: /data/upload
  downloadUrl: /core/downloadDesc.html?fileId=
  uploadUrl: /system/upload.html

  # 日志配置
  logType: 1000-10000

  # 界面配置
  adminStyle: layui
  layout: fluid

  # 系统路由配置
  clearUrl: /topezadmin/clearCache.html
  signoutUrl: /login/signout.html
  indexUrl: /doc/index.html
  navUrl: /laynavs.html

  # AI 功能配置（可选）
  apiUrl: https://api.deepseek.com/v1/chat/completions
  apiKey: sk-xxxxxxxxxxxxxxxx
  model: deepseek-chat
  temperature: 0.8
 

二、配置格式

JSON 配置文件存放路径：

• 列表配置：topezadmin/config/layui/dsl/list/*.json
• 表单配置：topezadmin/config/layui/dsl/form/*.json

列表配置结构

{
  "id": "列表ID",
  "name": "列表名称",
  "dataSource": "数据源Bean名称",
  "initApi": "自定义接口(可选)",
  "hideSearch": false,

  "body": {
    "emptyShow": "-",
    "showIndex": true,
    "selectable": true,
    "rowActionWidth": 175
  },

  "tabList": [],
  "search": [{"row": []},{"row": []}],
  "column": [],
  "tableButton": [],
  "rowButton": [],

  "express": {
    "main": "查询SQL表达式",
    "orderBy": "order by xxx",
    "groupBy": "group by xxx",
    "count": "自定义count语句"
  }
}

表单配置结构

{
  "id": "表单ID",
  "name": "表单名称",
  "dataSource": "数据源Bean名称",
  "successUrl": "保存成功后跳转URL",

  "cardList": [{
    "type": "card",
    "label": "卡片标题",
    "fieldList": [{"row": []},{"row": []}],
    "buttonList": []
  }],

  "buttonList": [],
  "initExpress": [],
  "submitExpress": [],
  "deleteExpress": [],
  "statusExpress": []
}

三、组件配置

基本结构

{
  "item_name": "字段名（大写）",
  "label": "显示名称",
  "component": "组件类型",
  "alias": "SQL别名(可选)",
  "jdbcType": "数据类型(可选)",
  "operator": "操作符(可选)",

  "initData": {
    "dataJson": [{"label":"选项1","value":"1"}],
    "dataSql": "SELECT value,label FROM table",
    "dataSource": "数据源名称"
  },

  "props": {
    // Layui 原生属性或自定义属性
  }
}

props 通用属性

所有组件的 props 都支持以下通用属性：

jQuery Validate 验证配置

通过 props.validate 可以配置更复杂的表单验证规则：

{
  "props": {
    "validate": {
      "rule": {
        "required": true,
        "minlength": 2,
        "maxlength": 20,
        "range": [0, 100],
        "email": true,
        "url": true,
        "number": true,
        "digits": true
      },
      "message": {
        "required": "此字段不能为空",
        "minlength": "至少输入2个字符",
        "maxlength": "最多输入20个字符",
        "range": "请输入0-100之间的数字",
        "email": "请输入有效的邮箱地址",
        "url": "请输入有效的URL",
        "number": "请输入数字",
        "digits": "请输入整数"
      }
    }
  }
}

常用验证规则：

• required: 必填验证
• email: 邮箱格式
• url: URL格式
• number: 数字
• digits: 整数
• minlength / maxlength: 长度限制
• min / max: 数值范围
• range: 数值范围（数组形式）
• uploadMin / uploadMax: 上传文件数量限制（仅 upload 组件）

组件类型

点击组件名称可查看详细文档 （展开/收起）

{
  "item_name": "NAME",
  "label": "姓名",
  "component": "input",
  "props": {
    "placeholder": "请输入姓名",
    "lay-verify": "required",
    "maxlength": 20
  }
}

{
  "item_name": "AGE",
  "label": "年龄",
  "component": "input",
  "props": {
    "placeholder": "请输入年龄",
    "type": "number",
    "validate": {
      "rule": {
        "required": true,
        "range": [0, 150],
        "digits": true
      },
      "message": {
        "required": "年龄不能为空",
        "range": "请输入0-150之间的数字",
        "digits": "请输入整数"
      }
    }
  }
}

{
  "item_name": "REMARK",
  "label": "备注",
  "component": "textarea",
  "props": {
    "placeholder": "请输入备注",
    "rows": 5
  }
}

{
  "item_name": "ID",
  "label": "ID",
  "component": "hidden",
}

{
  "item_name": "CONTENT",
  "label": "内容",
  "component": "tinymce",
  "props": {
    "height": 400
  }
}

{
  "item_name": "STATUS",
  "label": "状态",
  "component": "select",
  "initData": {
    "dataJson": [
      {"label": "启用", "value": "1"},
      {"label": "禁用", "value": "0"}
    ]
  },
  "props": {
    "lay-verify": "required",
    "placeholder": "请选择状态"
  }
}

{
  "item_name": "TAGS",
  "label": "标签",
  "component": "select-multiple",
  "operator": "in",
  "initData": {
    "dataSource": "dataSource",
    "dataSql": "SELECT id value, name label FROM tags"
  }
}

{
  "item_name": "REGION_ID",
  "label": "地区",
  "component": "cascader",
  "initData": {
    "dataJson": [
      {
        "label": "北京市",
        "value": "110000",
        "children": [
          {"label": "东城区", "value": "110101"}
        ]
      }
    ]
  }
}

{
  "item_name": "GENDER",
  "label": "性别",
  "component": "radio",
  "initData": {
    "dataJson": [
      {"label": "男", "value": "1"},
      {"label": "女", "value": "2"}
    ]
  }
}

{
  "item_name": "HOBBIES",
  "label": "爱好",
  "component": "checkbox",
  "initData": {
    "dataJson": [
      {"label": "阅读", "value": "1"},
      {"label": "运动", "value": "2"},
      {"label": "旅游", "value": "3"}
    ]
  }
}

{
  "item_name": "CREATE_TIME",
  "label": "创建时间",
  "component": "date",
  "props": {
    "type": "datetime",
    "format": "yyyy-MM-dd HH:mm:ss"
  }
}

{
  "item_name": "AVATAR",
  "label": "头像",
  "component": "upload",
  "props": {
    "accept": "images",
    "multiple": false,
    "size": 2048,
    "description": "支持jpg、png格式，大小不超过2MB"
  }
}

{
  "item_name": "PRODUCT_IMAGES",
  "label": "产品图片",
  "component": "upload",
  "props": {
    "accept": "images",
    "multiple": true,
    "validate": {
      "rule": {
        "uploadMin": 1,
        "uploadMax": 10
      },
      "message": {
        "uploadMin": "至少上传1张图片",
        "uploadMax": "最多上传10张图片"
      }
    }
  }
}

{
  "item_name": "EDIT",
  "label": "编辑",
  "component": "button-normal",
  "props": {
    "opentype": "MODAL",
    "windowname": "编辑用户",
    "url": "/topezadmin/form/page-user-form?id={{=d.ID}}",
    "area": ["60%", "80%"]
  }
}

{
  "item_name": "ADD",
  "label": "新增",
  "component": "button-toolbar",
  "props": {
    "opentype": "MODAL",
    "windowname": "新增用户",
    "url": "/topezadmin/form/page-user-form",
    "area": ["60%", "80%"]
  }
}

{
  "item_name": "STATUS",
  "label": "状态",
  "component": "tdSelect",
  "initData": {
    "dataJson": [
      {"label": "启用", "value": "1"},
      {"label": "禁用", "value": "0"}
    ]
  }
}

按钮 opentype 属性

四、表达式系统

内置函数

表达式示例

列表查询：

StringBuilder sql = new StringBuilder();
sql.append("SELECT ID, NAME, STATUS FROM users WHERE delete_flag=0");
return search(sql); // 系统会自动拼接搜索条件

表单保存：

if(!isNotBlank("ID")) {
    // 新增
    param = new InsertParam();
    param.table("users");
    param.add("#{NAME}");
    param.add("#{STATUS}");
    param.add("#{CREATE_TIME,value=NOW()}");
    return insertSimple(param);
} else {
    // 更新
    param = new UpdateParam();
    param.table("users");
    param.add("#{NAME}");
    param.add("#{STATUS}");
    param.where("id=#{ID}");
    return updateSimple(param);
}

五、完整示例

最小列表配置

{
  "id": "user-list",
  "name": "用户列表",
  "dataSource": "dataSource",

  "body": {
    "showIndex": true,
    "selectable": true
  },

  "search": [

             {"row": [{
    "item_name": "NAME",
    "label": "姓名",
    "component": "input",
    "operator": "like"
  }, {
    "item_name": "STATUS",
    "label": "状态",
    "component": "select",
    "operator": "eq",
    "initData": {
      "dataJson": [
        {"label": "启用", "value": "1"},
        {"label": "禁用", "value": "0"}
      ]
    }
  }]}
                ],

  "column": [{
    "item_name": "ID",
    "label": "ID",
    "props": {"width": 80}
  }, {
    "item_name": "NAME",
    "label": "姓名"
  }, {
    "item_name": "STATUS",
    "label": "状态",
    "component": "tdSelect",
    "initData": {
      "dataJson": [
        {"label": "启用", "value": "1"},
        {"label": "禁用", "value": "0"}
      ]
    }
  }],

  "tableButton": [{
    "item_name": "add",
    "label": "新增",
    "component": "button-toolbar",
    "props": {
      "opentype": "MODAL",
      "windowname": "新增用户",
      "url": "/topezadmin/form/page-user-form",
      "area": ["60%", "80%"]
    }
  }],

  "rowButton": [{
    "item_name": "edit",
    "label": "编辑",
    "component": "button-normal",
    "props": {
      "opentype": "MODAL",
      "windowname": "编辑用户",
      "url": "/topezadmin/form/page-user-form?id={{=d.ID}}",
      "area": ["60%", "80%"]
    }
  }, {
    "item_name": "delete",
    "label": "删除",
    "component": "button-normal",
    "props": {
      "opentype": "CONFIRM_AJAX",
      "url": "/topezadmin/form/delete-user-form?id={{=d.ID}}"
    }
  }],

  "express": {
    "main": "return search('SELECT ID, NAME, STATUS FROM users WHERE 1=1')",
    "orderBy": "ORDER BY ID DESC"
  }
}

最小表单配置

{
  "id": "user-form",
  "name": "用户表单",
  "dataSource": "dataSource",

  "cardList": [{
    "type": "card",
    "label": "基本信息",
    "fieldList": [
           {"row": [{
      "item_name": "ID",
      "label": "ID",
      "component": "hidden",
    }, {
      "item_name": "NAME",
      "label": "姓名",
      "component": "input",
      "props": {
        "placeholder": "请输入姓名",
        "lay-verify": "required",
        "validate": {
          "rule": {"required": true, "minlength": 2},
          "message": {
            "required": "姓名不能为空",
            "minlength": "姓名至少2个字符"
          }
        }
      }
    }, {
      "item_name": "STATUS",
      "label": "状态",
      "component": "select",
      "initData": {
        "dataJson": [
          {"label": "启用", "value": "1"},
          {"label": "禁用", "value": "0"}
        ]
      },
      "props": {
        "lay-verify": "required"
      }
    }]
  }]}

                ],

  "initExpress": [
    "return selectOne('SELECT ID, NAME, STATUS FROM users WHERE id=${ID}')"
  ],

  "submitExpress": [
    "if(!isNotBlank('ID')) {",
    "  param = new InsertParam();",
    "  param.table('users');",
    "  param.add('#{NAME}');",
    "  param.add('#{STATUS}');",
    "  param.add('#{CREATE_TIME,value=NOW()}');",
    "  return insertSimple(param);",
    "} else {",
    "  param = new UpdateParam();",
    "  param.table('users');",
    "  param.add('#{NAME}');",
    "  param.add('#{STATUS}');",
    "  param.add('#{UPDATE_TIME,value=NOW()}');",
    "  param.where('ID=#{ID}');",
    "  return updateSimple(param);",
    "}"
  ],

  "deleteExpress": [
    "return update('UPDATE users SET delete_flag=1 WHERE ID=#{ID}')"
  ]
}

六、路由规则

七、注意事项

• 字段命名规范：item_name 必须大写，且与数据库字段名保持一致
• 数据格式：initData 支持 dataJson（静态）和 dataSql（动态）两种方式
• 模板语法：支持 laytpl 模板语法，如 {{=d.field}}
• 属性兼容：props 支持所有 Layui 原生属性及第三方插件属性
• 表达式引擎：基于 QLExpress，支持 Java 语法和 SQL 拼接
• 多数据源：默认使用配置的 dataSource，可在 initData 中指定其他数据源
• 验证规则：支持 jQuery Validate 的所有验证规则

八、AI开发流程说明