From 6b1045f0af65dc382e9e53bf0401f3f821889391 Mon Sep 17 00:00:00 2001
From: Odboy <tianjun@odboy.cn>
Date: Fri, 30 Jan 2026 19:08:01 +0800
Subject: [PATCH] =?UTF-8?q?feat(table):=20=E6=B7=BB=E5=8A=A0=E8=A1=A8?=
 =?UTF-8?q?=E6=A0=BC=E6=8E=92=E5=BA=8F=E5=92=8C=E9=80=89=E6=8B=A9=E5=8A=9F?=
 =?UTF-8?q?=E8=83=BD=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在KitPageArgs中新增OrderBy排序参数类，支持字段转下划线和排序绑定
- 修改SystemDictService.searchDict方法，集成排序参数处理逻辑
- 更新CuteDragTable和CuteSimpleTable组件，添加排序和选择功能
- 新增表格上方工具栏插槽和选择计数显示
- 优化前端表格组件的排序事件处理和数据刷新逻辑
---
 .../views/components/dev/CuteDragTable.vue    | 76 +++++++++++++++++--
 .../views/components/dev/CuteSimpleTable.vue  | 74 ++++++++++++++++--
 .../componentsDemo/CuteDragTableDemo.vue      |  5 +-
 .../componentsDemo/CuteSimpleTableDemo.vue    | 50 ++++++++++--
 .../main/java/cn/odboy/base/KitPageArgs.java  | 53 +++++++++++--
 .../controller/SystemDictController.java      |  9 ++-
 .../system/service/SystemDictService.java     | 27 ++++---
 .../main/java/cn/odboy/base/KitPageArgs.java  | 53 ++++++++++++-
 .../controller/SystemDictController.java      |  2 +-
 .../system/service/SystemDictService.java     | 26 +++++--
 10 files changed, 323 insertions(+), 52 deletions(-)

diff --git a/cutejava-front/src/views/components/dev/CuteDragTable.vue b/cutejava-front/src/views/components/dev/CuteDragTable.vue
index c78129b0..26e4f96a 100644
--- a/cutejava-front/src/views/components/dev/CuteDragTable.vue
+++ b/cutejava-front/src/views/components/dev/CuteDragTable.vue
@@ -6,6 +6,19 @@
  -->
 <template>
   <div>
+    <el-row>
+      <el-col v-if="showSelect" :span="2" class="selection-box">
+        已选 <font class="selection-count">{{ crud.selection && crud.selection.length }}</font> 条
+      </el-col>
+      <el-col :span="11" style="text-align: left">
+        <!-- 通过  <template v-slot:batchArea> 插槽，数据表格上方左侧 添加 批量操作入口 -->
+        <slot name="batchArea" />
+      </el-col>
+      <el-col :span="11" style="text-align: left">
+        <!-- 通过  <template v-slot:toolArea> 插槽，数据表格上方右侧 添加 工具入口，比如导出 -->
+        <slot name="toolArea" />
+      </el-col>
+    </el-row>
     <el-table
       ref="table"
       v-loading="crud.loading"
@@ -17,9 +30,12 @@
       style="width: 100%;"
       :height="height"
       :max-height="height"
+      highlight-current-row
+      highlight-selection-row
+      @sort-change="onTableSortChange"
       @selection-change="onTableSelectionChange"
     >
-      <el-table-column v-if="mode === 'multi'" type="selection" width="55" />
+      <el-table-column v-if="showSelect" type="selection" width="55" />
       <slot />
       <el-pagination
         v-if="paging"
@@ -60,10 +76,10 @@ export default {
       required: false,
       default: null
     },
-    mode: {
-      type: String,
+    showSelect: {
+      type: Boolean,
       required: false,
-      default: 'none'
+      default: false
     },
     paging: {
       type: Boolean,
@@ -95,7 +111,9 @@ export default {
           console.log('on-page-change', currentPage, pageSize)
           // this.$emit('onPageChange', currentPage, pageSize, total)
           this.refresh()
-        }
+        },
+        orderBy: '',
+        selection: []
       }
     }
   },
@@ -109,6 +127,8 @@ export default {
   },
   methods: {
     refresh() {
+      this.crud.orderBy = ''
+      this.crud.selection = []
       this.initData()
       this.initDragTable()
     },
@@ -118,6 +138,10 @@ export default {
       if (this.paramsTransform) {
         params = this.paramsTransform(this.pageProps)
       }
+      // 排序字段
+      if (this.crud.orderBy) {
+        params.orderBy = this.crud.orderBy
+      }
       if (this.fetch) {
         try {
           this.crud.loading = true
@@ -134,14 +158,37 @@ export default {
             this.crud.dataSource = response.content
           }
           return response
+        } catch (e) {
+          console.error('CuteDragTable请求远程数据异常', e)
+          this.pageProps.total = 0
+          this.crud.dataSource = []
         } finally {
           this.crud.loading = false
         }
       }
     },
     onTableSelectionChange(selection) {
+      this.crud.selection = selection
       this.$emit('selection-change', selection)
     },
+    getDataSource() {
+      return this.crud.dataSource
+    },
+    onTableSortChange(sortProps) {
+      const prop = sortProps.prop
+      const order = sortProps.order
+      let result
+      if (order === 'ascending') {
+        result = { column: prop, orderType: 'asc' }
+      } else if (order === 'descending') {
+        result = { column: prop, orderType: 'desc' }
+      } else {
+        result = { column: prop, orderType: 'desc' }
+      }
+      // this.$emit('order-change', result)
+      this.crud.orderBy = result
+      this.refresh()
+    },
     initDragTable() {
       const that = this
       const table = that.$refs.table.$el.querySelectorAll('.el-table__body-wrapper > table > tbody')[0]
@@ -163,11 +210,24 @@ export default {
       data.forEach((item, index) => {
         item.orderNum = index + 1
       })
-    },
-    getDataSource() {
-      return this.crud.dataSource
     }
   }
 }
 </script>
 
+<style lang="scss" scoped>
+@import "~@/assets/styles/variables.scss";
+
+.selection-box {
+  text-align: left;
+  font-size: 12px;
+  padding-left: 10px;
+  min-height: 26.7px;
+  max-height: 26.7px;
+  padding-top: 7px;
+}
+
+.selection-count {
+  color: $menuActiveText;
+}
+</style>
diff --git a/cutejava-front/src/views/components/dev/CuteSimpleTable.vue b/cutejava-front/src/views/components/dev/CuteSimpleTable.vue
index 37ac7f3a..9bfcaa84 100644
--- a/cutejava-front/src/views/components/dev/CuteSimpleTable.vue
+++ b/cutejava-front/src/views/components/dev/CuteSimpleTable.vue
@@ -6,6 +6,19 @@
  -->
 <template>
   <div>
+    <el-row>
+      <el-col v-if="showSelect" :span="2" class="selection-box">
+        已选 <font class="selection-count">{{ crud.selection && crud.selection.length }}</font> 条
+      </el-col>
+      <el-col :span="11" style="text-align: left">
+        <!-- 通过  <template v-slot:batchArea> 插槽，数据表格上方左侧 添加 批量操作入口 -->
+        <slot name="batchArea" />
+      </el-col>
+      <el-col :span="11" style="text-align: right">
+        <!-- 通过  <template v-slot:toolArea> 插槽，数据表格上方右侧 添加 工具入口，比如导出 -->
+        <slot name="toolArea" />
+      </el-col>
+    </el-row>
     <el-table
       ref="table"
       v-loading="crud.loading"
@@ -17,9 +30,12 @@
       style="width: 100%;"
       :height="height"
       :max-height="height"
+      highlight-current-row
+      highlight-selection-row
+      @sort-change="onTableSortChange"
       @selection-change="onTableSelectionChange"
     >
-      <el-table-column v-if="mode === 'multi'" type="selection" width="55" />
+      <el-table-column v-if="showSelect" type="selection" width="55" />
       <slot />
     </el-table>
     <el-pagination
@@ -60,10 +76,10 @@ export default {
       required: false,
       default: null
     },
-    mode: {
-      type: String,
+    showSelect: {
+      type: Boolean,
       required: false,
-      default: 'none'
+      default: false
     },
     paging: {
       type: Boolean,
@@ -100,7 +116,9 @@ export default {
           console.log('on-page-change', currentPage, pageSize)
           // this.$emit('onPageChange', currentPage, pageSize, total)
           this.refresh()
-        }
+        },
+        orderBy: '',
+        selection: []
       }
     }
   },
@@ -117,6 +135,8 @@ export default {
   },
   methods: {
     refresh() {
+      this.crud.orderBy = ''
+      this.crud.selection = []
       this.initData()
     },
     async initData() {
@@ -125,6 +145,10 @@ export default {
       if (this.paramsTransform) {
         params = this.paramsTransform(this.pageProps)
       }
+      // 排序字段
+      if (this.crud.orderBy) {
+        params.orderBy = this.crud.orderBy
+      }
       if (this.fetch) {
         try {
           this.crud.loading = true
@@ -141,15 +165,55 @@ export default {
             this.crud.dataSource = response.content
           }
           return response
+        } catch (e) {
+          console.error('CuteSimpleTable请求远程数据异常', e)
+          this.pageProps.total = 0
+          this.crud.dataSource = []
         } finally {
           this.crud.loading = false
         }
       }
     },
     onTableSelectionChange(selection) {
+      this.crud.selection = selection
       this.$emit('selection-change', selection)
+    },
+    getDataSource() {
+      return this.crud.dataSource
+    },
+    onTableSortChange(sortProps) {
+      const prop = sortProps.prop
+      const order = sortProps.order
+      let result
+      if (order === 'ascending') {
+        result = { column: prop, orderType: 'asc' }
+      } else if (order === 'descending') {
+        result = { column: prop, orderType: 'desc' }
+      } else {
+        result = { column: prop, orderType: 'desc' }
+      }
+      // this.$emit('order-change', result)
+      this.crud.orderBy = result
+      this.refresh()
     }
   }
 }
 </script>
 
+<style lang="scss" scoped>
+@import "~@/assets/styles/variables.scss";
+
+.selection-box {
+  text-align: left;
+  font-size: 12px;
+  padding-left: 10px;
+  min-height: 26.7px;
+  max-height: 26.7px;
+  padding-top: 7px;
+}
+
+.selection-count {
+  color: $menuActiveText;
+}
+</style>
+
diff --git a/cutejava-front/src/views/componentsDemo/CuteDragTableDemo.vue b/cutejava-front/src/views/componentsDemo/CuteDragTableDemo.vue
index 2cddea96..700dc1c6 100644
--- a/cutejava-front/src/views/componentsDemo/CuteDragTableDemo.vue
+++ b/cutejava-front/src/views/componentsDemo/CuteDragTableDemo.vue
@@ -9,6 +9,7 @@
         label-position="right"
         label-width="80px"
         :rules="form.rules"
+        size="mini"
       >
         <el-form-item label="模糊查询" prop="blurry">
           <el-input v-model="form.model.blurry" clearable />
@@ -24,9 +25,9 @@
     <!-- params-transform: 组装查询参数 -->
     <!-- responseTransform: 组装表格对象。对响应结果做处理 -->
     <!-- primary-key: 主键 -->
-    <!-- data-source: 数据源。当data-source不为空时，以data-source的数据为主 -->
-    <!-- mode: 模式。不传默认，传multi为多选 -->
+    <!-- showSelect: 是否多选。不传默认false，传true为多选 -->
     <!-- @selection-change: 当且仅当mode为multi时启用 -->
+    <!-- @order-change: 当排序字段被单击，el-table-column 需添加 sortable="custom" 属性 -->
     <cute-drag-table
       ref="instance"
       :fetch="curd.fetch"
diff --git a/cutejava-front/src/views/componentsDemo/CuteSimpleTableDemo.vue b/cutejava-front/src/views/componentsDemo/CuteSimpleTableDemo.vue
index de662333..b22ddbfb 100644
--- a/cutejava-front/src/views/componentsDemo/CuteSimpleTableDemo.vue
+++ b/cutejava-front/src/views/componentsDemo/CuteSimpleTableDemo.vue
@@ -9,6 +9,7 @@
         label-position="right"
         label-width="80px"
         :rules="form.rules"
+        size="mini"
       >
         <el-form-item label="模糊查询" prop="blurry">
           <el-input v-model="form.model.blurry" clearable />
@@ -28,18 +29,26 @@
     <!-- params-transform: 组装查询参数 -->
     <!-- responseTransform: 组装表格对象。对响应结果做处理 -->
     <!-- primary-key: 主键 -->
-    <!-- mode: 模式。不传默认，传multi为多选 -->
+    <!-- showSelect: 是否多选。不传默认false，传true为多选 -->
     <!-- @selection-change: 当且仅当mode为multi时启用 -->
+    <!-- @order-change: 当排序字段被单击，el-table-column 需添加 sortable="custom" 属性 -->
     <cute-simple-table
       ref="instance"
       :fetch="curd.fetch"
       :params-transform="curd.paramsTransform"
       primary-key="id"
       :page-props="curd.pageProps"
+      show-select
     >
+      <template v-slot:batchArea>
+        <cute-button type="primary">批量绑定</cute-button>
+      </template>
+      <template v-slot:toolArea>
+        <cute-button type="primary">导出</cute-button>
+      </template>
       <el-table-column prop="name" label="名称" />
       <el-table-column prop="description" label="描述" />
-      <el-table-column prop="createTime" label="创建时间" :formatter="FormatRowDateTimeStr" />
+      <el-table-column prop="createTime" label="创建时间" sortable="custom" :formatter="FormatRowDateTimeStr" />
       <el-table-column prop="createBy" label="创建人" />
       <el-table-column label="操作" width="150" min-width="150" fixed="right">
         <template slot-scope="scope">
@@ -50,7 +59,13 @@
         </template>
       </el-table-column>
     </cute-simple-table>
-    <cute-form-dialog ref="dialogForm" :model="createFormModel" :rules="createFormRules" title="演示:表单对话框" @submit="onDialogFormSubmit">
+    <cute-form-dialog
+      ref="dialogForm"
+      :model="createFormModel"
+      :rules="createFormRules"
+      title="演示:表单对话框"
+      @submit="onDialogFormSubmit"
+    >
       <el-form-item label="活动名称" prop="name" label-width="100px">
         <el-input v-model="createFormModel.name" placeholder="请输入" style="width: 100%" />
       </el-form-item>
@@ -61,7 +76,14 @@
         </el-select>
       </el-form-item>
     </cute-form-dialog>
-    <cute-form-drawer ref="drawerFrom" :model="createFormModel" :rules="createFormRules" title="演示:表单抽屉" @submit="onDrawerFormSubmit">
+    <cute-form-drawer
+      ref="drawerFrom"
+      :model="createFormModel"
+      :rules="createFormRules"
+      title="演示:表单抽屉"
+      width="45%"
+      @submit="onDrawerFormSubmit"
+    >
       <el-form-item label="活动名称" prop="name" label-width="100px">
         <el-input v-model="createFormModel.name" placeholder="请输入" style="width: 100%" />
       </el-form-item>
@@ -71,6 +93,12 @@
           <el-option label="区域二" value="beijing" />
         </el-select>
       </el-form-item>
+      <el-form-item label="活动模式" prop="modeList" label-width="100px">
+        <cute-transfer v-model="createFormModel.modeList" :data-source="modeDataSource">
+          <el-table-column prop="name" label="姓名" />
+          <el-table-column prop="description" label="备注" />
+        </cute-transfer>
+      </el-form-item>
     </cute-form-drawer>
   </div>
 </template>
@@ -81,12 +109,21 @@ import DictService from '@/api/system/dict'
 import CuteFormDialog from '@/views/components/dev/CuteFormDialog'
 import CuteFormDrawer from '@/views/components/dev/CuteFormDrawer'
 import { FormatRowDateTimeStr } from '@/utils/CsUtil'
+import CuteButton from '@/views/components/dev/CuteButton.vue'
+import CuteTransfer from '@/views/components/dev/CuteTransfer.vue'
 
 export default {
   name: 'CuteSimpleTableDemo',
-  components: { CuteFormDrawer, CuteFormDialog, CuteSimpleTable },
+  components: { CuteTransfer, CuteButton, CuteFormDrawer, CuteFormDialog, CuteSimpleTable },
   data() {
     return {
+      modeDataSource: [
+        { id: 1, name: '小明', description: '小明牛P' },
+        { id: 2, name: '小明', description: '小明牛P' },
+        { id: 3, name: '小明', description: '小明牛P' },
+        { id: 4, name: '小明', description: '小明牛P' },
+        { id: 5, name: '小明', description: '小明牛P' }
+      ],
       form: {
         model: {
           blurry: ''
@@ -137,7 +174,8 @@ export default {
       },
       createFormModel: {
         name: '',
-        region: ''
+        region: '',
+        modeList: []
       },
       createFormRules: {
         name: [
diff --git a/cutejava-springboot3/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java b/cutejava-springboot3/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
index 96fdf401..572b5189 100644
--- a/cutejava-springboot3/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
+++ b/cutejava-springboot3/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
@@ -15,13 +15,13 @@
  */
 package cn.odboy.base;
 
+import cn.hutool.core.util.StrUtil;
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import io.swagger.annotations.ApiModelProperty;
-import java.io.Serializable;
+
 import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.NoArgsConstructor;
+import lombok.*;
 
 /**
  * 数据分页参数
@@ -32,7 +32,8 @@ import lombok.NoArgsConstructor;
 @Data
 @NoArgsConstructor
 @AllArgsConstructor
-public class KitPageArgs<T> implements Serializable {
+@EqualsAndHashCode(callSuper = false)
+public class KitPageArgs<T> extends KitObject {
 
   @NotNull(message = "参数page不能为空")
   @Min(value = 1, message = "参数page最小值为1")
@@ -43,4 +44,46 @@ public class KitPageArgs<T> implements Serializable {
   @ApiModelProperty(value = "每页数据量", example = "10")
   private Integer size;
   private T args;
+  @ApiModelProperty(value = "排序参数")
+  private OrderBy orderBy;
+
+  @Setter
+  public static class OrderBy extends KitObject {
+
+    /**
+     * 排序列名称
+     */
+    private String column;
+    /**
+     * 排序方式
+     */
+    private String orderType;
+
+    /**
+     * 字段属性转下划线
+     *
+     * @return /
+     */
+    public String getColumn() {
+      return StrUtil.toUnderlineCase(this.column);
+    }
+
+    /**
+     * 是否顺序排序
+     *
+     * @return /
+     */
+    public boolean isAsc() {
+      return "asc".equals(this.orderType);
+    }
+
+    /**
+     * 绑定 QueryWrapper，应用排序条件
+     *
+     * @param wrapper QueryWrapper<T>
+     */
+    public <T> void bindWrapper(QueryWrapper<T> wrapper) {
+      wrapper.orderBy(true, this.isAsc(), this.getColumn());
+    }
+  }
 }
diff --git a/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java b/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
index c7be0e7e..1aeb4366 100644
--- a/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
+++ b/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
@@ -25,6 +25,10 @@ import cn.odboy.system.service.SystemDictService;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import io.swagger.annotations.Api;
 import io.swagger.annotations.ApiOperation;
+import java.util.List;
+import java.util.Set;
+
+import jakarta.servlet.http.HttpServletResponse;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.access.prepost.PreAuthorize;
@@ -34,9 +38,6 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
-import jakarta.servlet.http.HttpServletResponse;
-import java.util.List;
-import java.util.Set;
 
 @RestController
 @Api(tags = "系统：字典管理")
@@ -67,7 +68,7 @@ public class SystemDictController {
   @PreAuthorize("@el.check('dict:list')")
   public ResponseEntity<KitPageResult<SystemDictTb>> queryDictByArgs(@Validated @RequestBody KitPageArgs<SystemQueryDictArgs> pageArgs) {
     Page<SystemDictTb> page = new Page<>(pageArgs.getPage(), pageArgs.getSize());
-    return ResponseEntity.ok(systemDictService.searchDict(pageArgs.getArgs(), page));
+    return ResponseEntity.ok(systemDictService.searchDict(pageArgs.getArgs(), page, pageArgs.getOrderBy()));
   }
 
   @OperationLog
diff --git a/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java b/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
index c1b81e1b..f504c359 100644
--- a/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
+++ b/cutejava-springboot3/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
@@ -17,6 +17,7 @@ package cn.odboy.system.service;
 
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.StrUtil;
+import cn.odboy.base.KitPageArgs;
 import cn.odboy.base.KitPageResult;
 import cn.odboy.system.dal.dataobject.SystemDictTb;
 import cn.odboy.system.dal.model.export.SystemDictExportRowVo;
@@ -28,11 +29,12 @@ import cn.odboy.util.KitBeanUtil;
 import cn.odboy.util.KitPageUtil;
 import cn.odboy.util.xlsx.KitExcelExporter;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import jakarta.servlet.http.HttpServletResponse;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
-import jakarta.servlet.http.HttpServletResponse;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Set;
@@ -85,14 +87,19 @@ public class SystemDictService {
   /**
    * 分页查询
    *
-   * @param args 条件
-   * @param page 分页参数
+   * @param args    条件
+   * @param page    分页参数
+   * @param orderBy 排序参数
    * @return /
    */
-  public KitPageResult<SystemDictTb> searchDict(SystemQueryDictArgs args, Page<SystemDictTb> page) {
-    LambdaQueryWrapper<SystemDictTb> wrapper = new LambdaQueryWrapper<>();
-    this.injectQueryParams(args, wrapper);
-    Page<SystemDictTb> selectPage = systemDictMapper.selectPage(page, wrapper);
+  public KitPageResult<SystemDictTb> searchDict(SystemQueryDictArgs args, Page<SystemDictTb> page, KitPageArgs.OrderBy orderBy) {
+    QueryWrapper<SystemDictTb> wrapper = new QueryWrapper<>();
+    if (orderBy != null) {
+      orderBy.bindWrapper(wrapper);
+    }
+    LambdaQueryWrapper<SystemDictTb> lambda = wrapper.lambda();
+    this.injectQueryParams(args, lambda);
+    Page<SystemDictTb> selectPage = systemDictMapper.selectPage(page, lambda);
     return KitPageUtil.toPage(selectPage);
   }
 
@@ -150,8 +157,10 @@ public class SystemDictService {
    */
   private void injectQueryParams(SystemQueryDictArgs args, LambdaQueryWrapper<SystemDictTb> wrapper) {
     if (args != null) {
-      wrapper.and(StrUtil.isNotBlank(args.getBlurry()), c -> c.like(SystemDictTb::getName, args.getBlurry()).or()
-          .like(SystemDictTb::getDescription, args.getBlurry()));
+      wrapper.and(
+          StrUtil.isNotBlank(args.getBlurry()),
+          c -> c.like(SystemDictTb::getName, args.getBlurry()).or().like(SystemDictTb::getDescription, args.getBlurry())
+      );
     }
   }
 }
diff --git a/cutejava/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java b/cutejava/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
index 51236a15..542fae60 100644
--- a/cutejava/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
+++ b/cutejava/cutejava-framework/src/main/java/cn/odboy/base/KitPageArgs.java
@@ -15,13 +15,15 @@
  */
 package cn.odboy.base;
 
+import cn.hutool.core.util.StrUtil;
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import io.swagger.annotations.ApiModelProperty;
+
 import java.io.Serializable;
 import javax.validation.constraints.Min;
 import javax.validation.constraints.NotNull;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.NoArgsConstructor;
+
+import lombok.*;
 
 /**
  * 数据分页参数
@@ -32,7 +34,8 @@ import lombok.NoArgsConstructor;
 @Data
 @NoArgsConstructor
 @AllArgsConstructor
-public class KitPageArgs<T> implements Serializable {
+@EqualsAndHashCode(callSuper = false)
+public class KitPageArgs<T> extends KitObject {
 
   @NotNull(message = "参数page不能为空")
   @Min(value = 1, message = "参数page最小值为1")
@@ -43,4 +46,46 @@ public class KitPageArgs<T> implements Serializable {
   @ApiModelProperty(value = "每页数据量", example = "10")
   private Integer size;
   private T args;
+  @ApiModelProperty(value = "排序参数")
+  private OrderBy orderBy;
+
+  @Setter
+  public static class OrderBy extends KitObject {
+
+    /**
+     * 排序列名称
+     */
+    private String column;
+    /**
+     * 排序方式
+     */
+    private String orderType;
+
+    /**
+     * 字段属性转下划线
+     *
+     * @return /
+     */
+    public String getColumn() {
+      return StrUtil.toUnderlineCase(this.column);
+    }
+
+    /**
+     * 是否顺序排序
+     *
+     * @return /
+     */
+    public boolean isAsc() {
+      return "asc".equals(this.orderType);
+    }
+
+    /**
+     * 绑定 QueryWrapper，应用排序条件
+     *
+     * @param wrapper QueryWrapper<T>
+     */
+    public <T> void bindWrapper(QueryWrapper<T> wrapper) {
+      wrapper.orderBy(true, this.isAsc(), this.getColumn());
+    }
+  }
 }
diff --git a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
index 314123b3..4fc465c7 100644
--- a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
+++ b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
@@ -67,7 +67,7 @@ public class SystemDictController {
   @PreAuthorize("@el.check('dict:list')")
   public ResponseEntity<KitPageResult<SystemDictTb>> queryDictByArgs(@Validated @RequestBody KitPageArgs<SystemQueryDictArgs> pageArgs) {
     Page<SystemDictTb> page = new Page<>(pageArgs.getPage(), pageArgs.getSize());
-    return ResponseEntity.ok(systemDictService.searchDict(pageArgs.getArgs(), page));
+    return ResponseEntity.ok(systemDictService.searchDict(pageArgs.getArgs(), page, pageArgs.getOrderBy()));
   }
 
   @OperationLog
diff --git a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
index b2bd737c..1c19b442 100644
--- a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
+++ b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/service/SystemDictService.java
@@ -17,6 +17,7 @@ package cn.odboy.system.service;
 
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.StrUtil;
+import cn.odboy.base.KitPageArgs;
 import cn.odboy.base.KitPageResult;
 import cn.odboy.system.dal.dataobject.SystemDictTb;
 import cn.odboy.system.dal.model.export.SystemDictExportRowVo;
@@ -28,10 +29,12 @@ import cn.odboy.util.KitBeanUtil;
 import cn.odboy.util.KitPageUtil;
 import cn.odboy.util.xlsx.KitExcelExporter;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
+
 import javax.servlet.http.HttpServletResponse;
 import java.util.ArrayList;
 import java.util.List;
@@ -85,14 +88,19 @@ public class SystemDictService {
   /**
    * 分页查询
    *
-   * @param args 条件
-   * @param page 分页参数
+   * @param args    条件
+   * @param page    分页参数
+   * @param orderBy 排序参数
    * @return /
    */
-  public KitPageResult<SystemDictTb> searchDict(SystemQueryDictArgs args, Page<SystemDictTb> page) {
-    LambdaQueryWrapper<SystemDictTb> wrapper = new LambdaQueryWrapper<>();
-    this.injectQueryParams(args, wrapper);
-    Page<SystemDictTb> selectPage = systemDictMapper.selectPage(page, wrapper);
+  public KitPageResult<SystemDictTb> searchDict(SystemQueryDictArgs args, Page<SystemDictTb> page, KitPageArgs.OrderBy orderBy) {
+    QueryWrapper<SystemDictTb> wrapper = new QueryWrapper<>();
+    if (orderBy != null) {
+      orderBy.bindWrapper(wrapper);
+    }
+    LambdaQueryWrapper<SystemDictTb> lambda = wrapper.lambda();
+    this.injectQueryParams(args, lambda);
+    Page<SystemDictTb> selectPage = systemDictMapper.selectPage(page, lambda);
     return KitPageUtil.toPage(selectPage);
   }
 
@@ -150,8 +158,10 @@ public class SystemDictService {
    */
   private void injectQueryParams(SystemQueryDictArgs args, LambdaQueryWrapper<SystemDictTb> wrapper) {
     if (args != null) {
-      wrapper.and(StrUtil.isNotBlank(args.getBlurry()), c -> c.like(SystemDictTb::getName, args.getBlurry()).or()
-          .like(SystemDictTb::getDescription, args.getBlurry()));
+      wrapper.and(
+          StrUtil.isNotBlank(args.getBlurry()),
+          c -> c.like(SystemDictTb::getName, args.getBlurry()).or().like(SystemDictTb::getDescription, args.getBlurry())
+      );
     }
   }
 }