From 6719277a05aeaa99a77dbb96f5b196fa32d6b5e1 Mon Sep 17 00:00:00 2001
From: wanggeng <450292408@qq.com>
Date: Sun, 4 Sep 2022 15:13:53 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=96=87=E6=A1=A3=EF=BC=8C?=
 =?UTF-8?q?=E8=B0=83=E6=95=B4=E7=9B=AE=E5=BD=95=E7=BB=93=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../wgink/code/backend/service/user-expand.md | 103 ++++++++++++++++++
 .../layui/util/layui-input-tree.md            |   0
 .../{ => frontend}/layui/util/layui-select.md |   0
 3 files changed, 103 insertions(+)
 create mode 100644 docs/src/main/resources/doc/wgink/code/backend/service/user-expand.md
 rename docs/src/main/resources/doc/wgink/code/{ => frontend}/layui/util/layui-input-tree.md (100%)
 rename docs/src/main/resources/doc/wgink/code/{ => frontend}/layui/util/layui-select.md (100%)

diff --git a/docs/src/main/resources/doc/wgink/code/backend/service/user-expand.md b/docs/src/main/resources/doc/wgink/code/backend/service/user-expand.md
new file mode 100644
index 00000000..b279c8ce
--- /dev/null
+++ b/docs/src/main/resources/doc/wgink/code/backend/service/user-expand.md
@@ -0,0 +1,103 @@
+# 用户属性拓展
+
+描述：拓展用户账号的属性，根据需要完善用户属性
+
+## 如何实现
+
+### 1. 创建实体类
+
+继承`ink.wgink.pojo.dtos.user.UserDTO`
+
+示例
+
+```java
+public class UserExpandDTO extends UserDTO {
+
+    private String userExpandId;
+    // TODO 其他属性
+    
+    public String getUserExpandId() {
+        return userExpandId == null ? "" : userExpandId.trim();
+    }
+
+    public void setUserExpandId(String userExpandId) {
+        this.userExpandId = userExpandId;
+    }
+
+    // TODO get set
+}
+```
+
+### 2. 添加Dao层接口
+
+接口中有数据持久化的方法
+
+示例
+
+```java
+
+```
+
+### 3. 添加Mapper
+
+示例
+
+```xml
+
+```
+
+### 4. 创建接口
+
+创建的接口继承`ink.wgink.interfaces.user.IUserExpandBaseService`。
+
+接口接收泛型`<UserExpandDTO extends UserDTO>`
+
+接口中有如下方法
+
+- getRoute：获取列表路径
+- get：通过用户ID获取详情
+- getByUsername：通过用户名获取详情
+- listByUserIds：通过用户ID列表获取列表
+- listByUsernames：通过用户名列表获取列表
+- list：列表
+- listPage：分页列表
+- listPageByIds：通过用户ID列表获取分页列表
+- listPageByExcludeIds：查询用户ID列表之外的分页列表
+- countDateRange：统计开始与结束时间内的总量
+- count：统计总量
+- listByKeywords：通过关键字获取列表
+
+根据业务添加对应的方法，如：update(更新)
+
+示例
+
+```java
+public interface IUserExpandService extends IUserExpandBaseService<UserExpandDTO> {
+
+    /**
+     * 更新
+     *
+     * @param userId
+     * @param userExpandVO
+     */
+    void update(String userId, UserExpandVO userExpandVO);
+
+}
+```
+
+## 实现接口
+
+根据需要实现对应的方法
+
+```java
+@Service
+public class UserExpandServiceImpl extends DefaultBaseService implements IUserExpandService {
+
+    // TODO 其他方法省略
+
+    @Override
+    public void update(String userId, UserExpandVO userExpandVO) {
+
+    }
+}
+```
\ No newline at end of file
diff --git a/docs/src/main/resources/doc/wgink/code/layui/util/layui-input-tree.md b/docs/src/main/resources/doc/wgink/code/frontend/layui/util/layui-input-tree.md
similarity index 100%
rename from docs/src/main/resources/doc/wgink/code/layui/util/layui-input-tree.md
rename to docs/src/main/resources/doc/wgink/code/frontend/layui/util/layui-input-tree.md
diff --git a/docs/src/main/resources/doc/wgink/code/layui/util/layui-select.md b/docs/src/main/resources/doc/wgink/code/frontend/layui/util/layui-select.md
similarity index 100%
rename from docs/src/main/resources/doc/wgink/code/layui/util/layui-select.md
rename to docs/src/main/resources/doc/wgink/code/frontend/layui/util/layui-select.md