添加代码风格文档

common/src/main/java/org/jiayunet/pojo/PageParam.java

@@ -0,0 +1,32 @@
+package org.jiayunet.pojo;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import lombok.Data;
+
+import javax.validation.constraints.Max;
+import javax.validation.constraints.Min;
+
+/**
+ * 通用分页查询参数
+ *
+ * @author zk
+ */
+@Data
+public class PageParam {
+
+    /** 当前页码，从1开始 */
+    @Min(value = 1, message = "页码最小为1")
+    private Integer pageNum = 1;
+
+    /** 每页条数 */
+    @Min(value = 1, message = "每页条数最小为1")
+    @Max(value = 100, message = "每页条数最大为100")
+    private Integer pageSize = 10;
+
+    /**
+     * 构建 MyBatis-Plus 分页对象
+     */
+    public <T> Page<T> toPage() {
+        return new Page<>(pageNum, pageSize);
+    }
+}

common/src/main/java/org/jiayunet/pojo/PageResult.java

@@ -0,0 +1,43 @@
+package org.jiayunet.pojo;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+/**
+ * 通用分页结果
+ *
+ * @author zk
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class PageResult<T> {
+
+    /** 当前页码 */
+    private Long pageNum;
+
+    /** 每页条数 */
+    private Long pageSize;
+
+    /** 总记录数 */
+    private Long total;
+
+    /** 数据列表 */
+    private List<T> list;
+
+    /**
+     * 从 MyBatis-Plus 分页对象构建
+     */
+    public static <T> PageResult<T> from(Page<T> page) {
+        PageResult<T> result = new PageResult<>();
+        result.setPageNum(page.getCurrent());
+        result.setPageSize(page.getSize());
+        result.setTotal(page.getTotal());
+        result.setList(page.getRecords());
+        return result;
+    }
+}