pageOption) {
+ this.pageOption.set(pageOption);
+ }
+
+ protected abstract void init(HttpServletRequest request, JSONObject requestParams);
+
+ /**
+ * 新增
+ *
+ * // * @param t 实体对象
+ */
+ @Operation(summary = "新增", description = "新增信息，对应后端的实体类")
+ @PostMapping("/add")
+ protected R add(@RequestAttribute() JSONObject requestParams) {
+ String body = requestParams.getStr("body");
+ if (JSONUtil.isTypeJSONArray(body)) {
+ JSONArray array = JSONUtil.parseArray(body);
+ return R.ok(Dict.create()
+ .set("id", service.addBatch(requestParams, array.toList(currentEntityClass()))));
+ } else {
+ return R.ok(Dict.create().set("id",
+ service.add(requestParams, requestParams.toBean(currentEntityClass()))));
+ }
+ }
+
+ /**
+ * 删除
+ *
+ * @param params 请求参数 ids 数组 或者按","隔开
+ */
+ @Operation(summary = "删除", description = "支持批量删除 请求参数 ids 数组 或者按\",\"隔开")
+ @PostMapping("/delete")
+ protected R delete(HttpServletRequest request, @RequestBody Map params,
+ @RequestAttribute() JSONObject requestParams) {
+ service.delete(requestParams, Convert.toLongArray(getIds(params)));
+ return R.ok();
+ }
+
+ /**
+ * 修改
+ *
+ * @param t 修改对象
+ */
+ @Operation(summary = "修改", description = "根据ID修改")
+ @PostMapping("/update")
+ protected R update(@RequestBody T t, @RequestAttribute() JSONObject requestParams) {
+ Long id = t.getId();
+ JSONObject info = JSONUtil.parseObj(JSONUtil.toJsonStr(service.getById(id)));
+ requestParams.forEach(info::set);
+ info.set("updateTime", new Date());
+ service.update(requestParams, JSONUtil.toBean(info, currentEntityClass()));
+ return R.ok();
+ }
+
+ /**
+ * 信息
+ *
+ * @param id ID
+ */
+ @Operation(summary = "信息", description = "根据ID查询单个信息")
+ @GetMapping("/info")
+ protected R info(@RequestAttribute() JSONObject requestParams,
+ @RequestParam() Long id,
+ @RequestAttribute(COOL_INFO_OP) CrudOption option) {
+ invokerTransformParam(option, requestParams);
+ T info = (T) service.info(requestParams, id);
+ invokerTransformValue(option, info);
+ return R.ok(info);
+ }
+
+ /**
+ * 列表查询
+ *
+ * @param requestParams 请求参数
+ */
+ @Operation(summary = "查询", description = "查询多个信息")
+ @PostMapping("/list")
+ protected R> list(@RequestAttribute() JSONObject requestParams,
+ @RequestAttribute(COOL_LIST_OP) CrudOption option) {
+ invokerTransformParam(option, requestParams);
+ QueryModeEnum queryModeEnum = option.getQueryModeEnum();
+ List list = (List) switch (queryModeEnum) {
+ case ENTITY_WITH_RELATIONS -> service.listWithRelations(requestParams, option.getQueryWrapper(currentEntityClass()));
+ case CUSTOM -> transformList(service.list(requestParams, option.getQueryWrapper(currentEntityClass()), option.getAsType()), option.getAsType());
+ default -> service.list(requestParams, option.getQueryWrapper(currentEntityClass()));
+ };
+ invokerTransformValue(option, list);
+ return R.ok(list);
+ }
+
+ /**
+ * 分页查询
+ *
+ * @param requestParams 请求参数
+ */
+ @Operation(summary = "分页", description = "分页查询多个信息")
+ @PostMapping("/page")
+ protected R> page(@RequestAttribute() JSONObject requestParams,
+ @RequestAttribute(COOL_PAGE_OP) CrudOption option) {
+ invokerTransformParam(option, requestParams);
+ Integer page = requestParams.getInt("page", 1);
+ Integer size = requestParams.getInt("size", 20);
+ QueryModeEnum queryModeEnum = option.getQueryModeEnum();
+ Object obj = switch (queryModeEnum) {
+ case ENTITY_WITH_RELATIONS -> service.pageWithRelations(requestParams, new Page<>(page, size), option.getQueryWrapper(currentEntityClass()));
+ case CUSTOM -> transformPage(service.page(requestParams, new Page<>(page, size), option.getQueryWrapper(currentEntityClass()), option.getAsType()), option.getAsType());
+ default -> service.page(requestParams, new Page<>(page, size), option.getQueryWrapper(currentEntityClass()));
+ };
+ Page pageResult = (Page) obj;
+ invokerTransformValue(option, pageResult.getRecords());
+ return R.ok(pageResult(pageResult));
+ }
+
+ /**
+ * 转换值，组装数据
+ */
+ private void invokerTransformValue(CrudOption option, Object obj) {
+ if (ObjUtil.isNotNull(option.getTransformValue())) {
+ if (obj instanceof List) {
+ ((List)obj).forEach(o -> {
+ option.getTransformValue().apply(o);
+ });
+ } else {
+ option.getTransformValue().apply(obj);
+ }
+ }
+ }
+
+ /**
+ * 转换入参
+ */
+ private void invokerTransformParam(CrudOption option, JSONObject obj) {
+ if (ObjUtil.isNotNull(option.getTransformParam())) {
+ option.getTransformParam().apply(obj);
+ }
+ }
+
+ /**
+ * 分页结果
+ *
+ * @param page 分页返回数据
+ */
+ protected PageResult pageResult(Page page) {
+ return PageResult.of(page);
+ }
+
+ public Class currentEntityClass() {
+ if (entityClass != null) {
+ return this.entityClass;
+ }
+ // 使用 获取泛型参数类型
+ Type type = TypeUtil.getTypeArgument(this.getClass(), 1); // 获取第二个泛型参数
+ if (type instanceof Class) {
+ entityClass = (Class) type;
+ return entityClass;
+ }
+ throw new IllegalStateException("Unable to determine entity class type");
+ }
+
+ protected List getIds(Map params) {
+ Object ids = params.get("ids");
+ CoolPreconditions.checkEmpty(ids, "ids 参数错误");
+ if (!(ids instanceof ArrayList)) {
+ ids = ids.toString().split(",");
+ }
+ return Convert.toList(Long.class, ids);
+ }
+
+ /**
+ * 适用于自定义返回值为 map，map 的key为数据库字段，转驼峰命名
+ */
+ protected List transformList(List records, Class asType) {
+ if (ObjUtil.isEmpty(asType) || !Map.class.isAssignableFrom(asType)) {
+ return records;
+ }
+ List
+
+
+## 运行
+
+### 环境要求
+
+- Java Graalvm 17+
+- Maven 3.6+
+
+### 配置
+
+修改数据库配置，配置文件位于`src/resources/application-local.yml`
+
+以 Mysql 为例，其他数据库适配中...
+
+Mysql(`>=5.7版本`)，建议 8.0，首次启动会自动初始化并导入数据
+
+```yaml
+# mysql，驱动已经内置，无需安装
+spring:
+ datasource:
+ url: jdbc:mysql://127.0.0.1:3306/cool?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2b8
+ username: root
+ password: 123456
+ driver-class-name: com.mysql.cj.jdbc.Driver
+```
+
+### 启动
+
+注：项目使用到了[Mybatis-Flex 的Apt功能](https://mybatis-flex.com/zh/others/apt.html)，如果启动报错，请先执行`mvn compile`编译
+
+1、启动文件：`src/main/java/com/cool/CoolApplication.java`
+
+2、启动完成后，访问：[http://localhost:8001](http://localhost:8001)
+
+3、如果看到以下界面，说明启动成功。这时候再启动前端项目即可，数据库会自动初始化，默认账号：admin，密码：123456
+
+
diff --git a/cool-admin-java/docker-compose.yml b/cool-admin-java/docker-compose.yml
new file mode 100644
index 0000000..7c9130b
--- /dev/null
+++ b/cool-admin-java/docker-compose.yml
@@ -0,0 +1,43 @@
+# 本地数据库环境
+# 数据存放在当前目录下的 data里
+# 推荐使用安装了docker扩展的vscode打开目录 在本文件上右键可以快速启动，停止
+# 如不需要相关容器开机自启动，可注释掉 restart: always
+# 如遇端口冲突 可调整ports下 :前面的端口号
+version: "3.9"
+
+services:
+ mysql:
+ image: mysql # 使用官方 MySQL 镜像，你可以根据需要选择版本
+ environment:
+ MYSQL_ROOT_PASSWORD: "123456" # 设置 root 用户密码
+ MYSQL_DATABASE: "cool" # 创建一个初始数据库
+ networks:
+ - backend
+ ports:
+ - "3306:3306" # 将主机的 3306 端口映射到容器的 3306 端口
+ volumes:
+ - mysql-data:/var/lib/mysql # 挂载数据卷以持久化数据
+
+ redis:
+ image: redis:latest
+ # command: --requirepass "12345678" # Uncomment if you need a password
+ restart: always
+ environment:
+ TZ: Asia/Shanghai # 指定时区
+ volumes:
+ - ./data/redis/:/data/
+ networks:
+ - backend
+ ports:
+ - 6379:6379
+
+
+networks:
+ backend:
+ driver: bridge
+
+volumes:
+ mysql-data:
+ driver: local
+ redis-data:
+ driver: local
\ No newline at end of file
diff --git a/cool-admin-java/pom.xml b/cool-admin-java/pom.xml
new file mode 100644
index 0000000..f43c908
--- /dev/null
+++ b/cool-admin-java/pom.xml
@@ -0,0 +1,213 @@
+
+