@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.11

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-session/references/assets}/08_/344/270/211/345/271/263/345/217/260/346/234/215/345/212/241-3.3/344/274/232/350/257/235/344/277/241/346/201/257-SessionUtils.md

@@ -1,349 +1,349 @@
----
-name: SessionUtils 会话工具类
-source-file: 公共资产清单
-source-section: 3.3.1 SessionUtils会话工具类
-keywords: [Session, 会话, 当前用户, getUserId, getDeptId, getOrgId, getRootOrgId, getRoleCodes, getTenantId, getEmpId]
-use-cases: [获取当前登录用户信息, 获取部门组织架构信息, 权限判断, 多租户识别, 审计日志记录]
-related: [09, 10, 11]
----
-
-# SessionUtils 会话工具类
-
-> **原文章节**：`公共资产清单 → 3.3.1 SessionUtils会话工具类`
-> **行号范围**：L1313–L1636
-
-## 🎯 一句话
-提供 21 个方法获取当前登录会话的用户ID、姓名、人员、部门、组织、角色、权限、租户、IP 等完整会话信息。
-
-## 📋 接口/方法清单
-
-完整包路径：`com.meritdata.cloud.utils.SessionUtils`
-
-会话工具类，获取当前登录用户的相关信息
-
-### 3.3.1.1 获取当前登录用户的用户ID
-
-方法：`getUserId()`
-
-入参：无
-
-返回：String (pf_user_info表的id字段)
-
-使用场景：获取当前登录用户的ID
-
-示例：`String userId = sessionUtils.getUserId();`
-
-### 3.3.1.2 获取当前登录用户的用户名
-
-方法：`getUserName()` / `getCurrentUserName()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户的用户名
-
-示例：`String userName = sessionUtils.getUserName();`
-
-### 3.3.1.3 获取当前登录用户的人员ID
-
-方法：`getEmpId()`
-
-入参：无
-
-返回：String (pf_org_user表的id字段)
-
-使用场景：获取当前登录人员的ID
-
-示例：
-```java
-@Autowired
-private SessionUtils sessionUtils;
-
-String empId = sessionUtils.getEmpId();
-```
-
-### 3.3.1.4 获取当前登录用户的人员姓名
-
-方法：`getEmpName()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户的人员姓名
-
-示例：
-```java
-String empName = sessionUtils.getEmpName();
-```
-
-### 3.3.1.5 获取当前登录用户的人员编号
-
-方法：`getEmpCode()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录人员的人员编号
-
-示例：
-```java
-String empCode = sessionUtils.getEmpCode();
-```
-
-### 3.3.1.6 获取当前登录用户所属部门的部门ID
-
-方法：`getDeptId()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户所属部门的部门ID
-
-示例：
-```java
-String deptId = sessionUtils.getDeptId();
-```
-
-### 3.3.1.7 获取当前登录用户所属部门的部门编码
-
-方法：`getDeptCode()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户所属部门的部门编码
-
-示例：
-```java
-String deptCode = sessionUtils.getDeptCode();
-```
-
-### 3.3.1.8 获取当前登录用户所属部门的部门名称
-
-方法：`getDeptName()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户所属部门的部门名称
-
-示例：
-```java
-String deptName = sessionUtils.getDeptName();
-```
-
-### 3.3.1.9 获取当前登录用户所属部门的部门对象
-
-方法：`getDept()`
-
-入参：无
-
-返回：Organization
-
-使用场景：获取当前登录用户所属部门的部门对象
-
-示例：
-```java
-Organization dept = sessionUtils.getDept();
-String deptId = dept.getId();
-String deptName = dept.getName();
-```
-
-### 3.3.1.10 获取当前登录用户所属组织的组织ID
-
-方法：`getOrgId()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户所属组织的组织ID
-
-示例：
-```java
-String orgId = sessionUtils.getOrgId();
-```
-
-### 3.3.1.11 获取当前登录用户所属组织的组织名称
-
-方法：`getOrgName()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前登录用户所属组织的组织名称
-
-示例：
-```java
-String orgName = sessionUtils.getOrgName();
-```
-
-### 3.3.1.12 获取当前登录用户所属组织的组织层级编码
-
-方法：`getOrgDlevelCode()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前组织的层级编码
-
-示例：
-```java
-String dlevelCode = sessionUtils.getOrgDlevelCode();
-```
-
-### 3.3.1.13 获取当前登录用户所属组织的根组织ID
-
-方法：`getRootOrgId()`
-
-入参：无
-
-返回：String
-
-使用场景：获取根组织ID
-
-示例：
-```java
-String rootOrgId = sessionUtils.getRootOrgId();
-```
-
-### 3.3.1.14 获取当前登录用户所属组织的根组织对象
-
-方法：`getRootOrg()`
-
-入参：无
-
-返回：Organization
-
-使用场景：获取当前登录用户所属组织的根组织对象
-
-示例：
-```java
-Organization rootOrg = sessionUtils.getRootOrg();
-String rootOrgName = rootOrg.getName();
-```
-
-### 3.3.1.15 获取当前登录用户的系统角色编码列表
-
-方法：`getSysRoleCodes()`
-
-入参：无
-
-返回：List<String>
-
-使用场景：获取当前用户的系统角色编码列表
-
-示例：
-```java
-List<String> sysRoleCodes = sessionUtils.getSysRoleCodes();
-for (String roleCode : sysRoleCodes) {
-    System.out.println("系统角色: " + roleCode);
-}
-```
-
-### 3.3.1.16 获取当前登录用户的角色编码列表
-
-方法：`getRoleCodes()`
-
-入参：无
-
-返回：List<String>
-
-使用场景：获取当前用户的所有角色编码
-
-示例：
-```java
-List<String> roleCodes = sessionUtils.getRoleCodes();
-```
-
-### 3.3.1.17 获取当前登录用户的角色名称列表
-
-方法：`getRoleNames()`
-
-入参：无
-
-返回：List<String>
-
-使用场景：获取当前用户的所有角色名称
-
-示例：
-```java
-List<String> roleNames = sessionUtils.getRoleNames();
-```
-
-### 3.3.1.18 获取当前登录用户的权限ID列表
-
-方法：`getAuthoritiesIds()`
-
-入参：无
-
-返回：List<String>
-
-使用场景：获取当前用户的所有权限ID
-
-示例：
-```java
-List<String> authoritiesIds = sessionUtils.getAuthoritiesIds();
-```
-
-### 3.3.1.19 获取当前登录用户所属的租户ID
-
-方法：`getTenantId()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前用户所属租户ID
-
-示例：
-```java
-String tenantId = sessionUtils.getTenantId();
-```
-
-### 3.3.1.20 获取当前登录用户的当前登录IP
-
-方法：`getCurrentLoginIp()`
-
-入参：无
-
-返回：String
-
-使用场景：获取当前用户的当前登录IP
-
-示例：
-```java
-String loginIp = sessionUtils.getCurrentLoginIp();
-```
-
-### 3.3.1.21 获取当前登录用户的整个用户对象
-
-方法：`getPrincipal()`
-
-入参：无
-
-返回：User
-
-使用场景：获取当前用户的整个用户对象
-
-示例：`User user = sessionUtils.getPrincipal();`
-
-## 💡 使用建议
-
-1. **统一在 SessionUtils 注入**：所有业务 Controller/Service 优先调用 `SessionUtils` 自动注入的 Spring Bean，避免在多个位置重复解析 Token。
-2. **审计场景必填**：操作日志、审批流、消息通知都需要记录 `getUserId()` / `getEmpId()` / `getCurrentLoginIp()` 用于审计。
-3. **多租户隔离**：`getTenantId()` 是数据隔离核心字段，所有租户级业务查询必须传该值（与 `ISecurityAuthService` 配合）。
-
-## 🔗 相关章节
-
-- `09_三平台服务-3.3在线用户-IUserOnlineTime.md`（在线用户踢出）
-- `10_三平台服务-3.4多系统集成+3.5数据密级.md`（多系统集成 + 数据密级）
-- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（服务通知）
+---
+name: SessionUtils 会话工具类
+source-file: 公共资产清单
+source-section: 3.3.1 SessionUtils会话工具类
+keywords: [Session, 会话, 当前用户, getUserId, getDeptId, getOrgId, getRootOrgId, getRoleCodes, getTenantId, getEmpId]
+use-cases: [获取当前登录用户信息, 获取部门组织架构信息, 权限判断, 多租户识别, 审计日志记录]
+related: [09, 10, 11]
+---
+
+# SessionUtils 会话工具类
+
+> **原文章节**：`公共资产清单 → 3.3.1 SessionUtils会话工具类`
+> **行号范围**：L1313–L1636
+
+## 🎯 一句话
+提供 21 个方法获取当前登录会话的用户ID、姓名、人员、部门、组织、角色、权限、租户、IP 等完整会话信息。
+
+## 📋 接口/方法清单
+
+完整包路径：`com.meritdata.cloud.utils.SessionUtils`
+
+会话工具类，获取当前登录用户的相关信息
+
+### 3.3.1.1 获取当前登录用户的用户ID
+
+方法：`getUserId()`
+
+入参：无
+
+返回：String (pf_user_info表的id字段)
+
+使用场景：获取当前登录用户的ID
+
+示例：`String userId = sessionUtils.getUserId();`
+
+### 3.3.1.2 获取当前登录用户的用户名
+
+方法：`getUserName()` / `getCurrentUserName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户的用户名
+
+示例：`String userName = sessionUtils.getUserName();`
+
+### 3.3.1.3 获取当前登录用户的人员ID
+
+方法：`getEmpId()`
+
+入参：无
+
+返回：String (pf_org_user表的id字段)
+
+使用场景：获取当前登录人员的ID
+
+示例：
+```java
+@Autowired
+private SessionUtils sessionUtils;
+
+String empId = sessionUtils.getEmpId();
+```
+
+### 3.3.1.4 获取当前登录用户的人员姓名
+
+方法：`getEmpName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户的人员姓名
+
+示例：
+```java
+String empName = sessionUtils.getEmpName();
+```
+
+### 3.3.1.5 获取当前登录用户的人员编号
+
+方法：`getEmpCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录人员的人员编号
+
+示例：
+```java
+String empCode = sessionUtils.getEmpCode();
+```
+
+### 3.3.1.6 获取当前登录用户所属部门的部门ID
+
+方法：`getDeptId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门ID
+
+示例：
+```java
+String deptId = sessionUtils.getDeptId();
+```
+
+### 3.3.1.7 获取当前登录用户所属部门的部门编码
+
+方法：`getDeptCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门编码
+
+示例：
+```java
+String deptCode = sessionUtils.getDeptCode();
+```
+
+### 3.3.1.8 获取当前登录用户所属部门的部门名称
+
+方法：`getDeptName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属部门的部门名称
+
+示例：
+```java
+String deptName = sessionUtils.getDeptName();
+```
+
+### 3.3.1.9 获取当前登录用户所属部门的部门对象
+
+方法：`getDept()`
+
+入参：无
+
+返回：Organization
+
+使用场景：获取当前登录用户所属部门的部门对象
+
+示例：
+```java
+Organization dept = sessionUtils.getDept();
+String deptId = dept.getId();
+String deptName = dept.getName();
+```
+
+### 3.3.1.10 获取当前登录用户所属组织的组织ID
+
+方法：`getOrgId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属组织的组织ID
+
+示例：
+```java
+String orgId = sessionUtils.getOrgId();
+```
+
+### 3.3.1.11 获取当前登录用户所属组织的组织名称
+
+方法：`getOrgName()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前登录用户所属组织的组织名称
+
+示例：
+```java
+String orgName = sessionUtils.getOrgName();
+```
+
+### 3.3.1.12 获取当前登录用户所属组织的组织层级编码
+
+方法：`getOrgDlevelCode()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前组织的层级编码
+
+示例：
+```java
+String dlevelCode = sessionUtils.getOrgDlevelCode();
+```
+
+### 3.3.1.13 获取当前登录用户所属组织的根组织ID
+
+方法：`getRootOrgId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取根组织ID
+
+示例：
+```java
+String rootOrgId = sessionUtils.getRootOrgId();
+```
+
+### 3.3.1.14 获取当前登录用户所属组织的根组织对象
+
+方法：`getRootOrg()`
+
+入参：无
+
+返回：Organization
+
+使用场景：获取当前登录用户所属组织的根组织对象
+
+示例：
+```java
+Organization rootOrg = sessionUtils.getRootOrg();
+String rootOrgName = rootOrg.getName();
+```
+
+### 3.3.1.15 获取当前登录用户的系统角色编码列表
+
+方法：`getSysRoleCodes()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的系统角色编码列表
+
+示例：
+```java
+List<String> sysRoleCodes = sessionUtils.getSysRoleCodes();
+for (String roleCode : sysRoleCodes) {
+    System.out.println("系统角色: " + roleCode);
+}
+```
+
+### 3.3.1.16 获取当前登录用户的角色编码列表
+
+方法：`getRoleCodes()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有角色编码
+
+示例：
+```java
+List<String> roleCodes = sessionUtils.getRoleCodes();
+```
+
+### 3.3.1.17 获取当前登录用户的角色名称列表
+
+方法：`getRoleNames()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有角色名称
+
+示例：
+```java
+List<String> roleNames = sessionUtils.getRoleNames();
+```
+
+### 3.3.1.18 获取当前登录用户的权限ID列表
+
+方法：`getAuthoritiesIds()`
+
+入参：无
+
+返回：List<String>
+
+使用场景：获取当前用户的所有权限ID
+
+示例：
+```java
+List<String> authoritiesIds = sessionUtils.getAuthoritiesIds();
+```
+
+### 3.3.1.19 获取当前登录用户所属的租户ID
+
+方法：`getTenantId()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前用户所属租户ID
+
+示例：
+```java
+String tenantId = sessionUtils.getTenantId();
+```
+
+### 3.3.1.20 获取当前登录用户的当前登录IP
+
+方法：`getCurrentLoginIp()`
+
+入参：无
+
+返回：String
+
+使用场景：获取当前用户的当前登录IP
+
+示例：
+```java
+String loginIp = sessionUtils.getCurrentLoginIp();
+```
+
+### 3.3.1.21 获取当前登录用户的整个用户对象
+
+方法：`getPrincipal()`
+
+入参：无
+
+返回：User
+
+使用场景：获取当前用户的整个用户对象
+
+示例：`User user = sessionUtils.getPrincipal();`
+
+## 💡 使用建议
+
+1. **统一在 SessionUtils 注入**：所有业务 Controller/Service 优先调用 `SessionUtils` 自动注入的 Spring Bean，避免在多个位置重复解析 Token。
+2. **审计场景必填**：操作日志、审批流、消息通知都需要记录 `getUserId()` / `getEmpId()` / `getCurrentLoginIp()` 用于审计。
+3. **多租户隔离**：`getTenantId()` 是数据隔离核心字段，所有租户级业务查询必须传该值（与 `ISecurityAuthService` 配合）。
+
+## 🔗 相关章节
+
+- `09_三平台服务-3.3在线用户-IUserOnlineTime.md`（在线用户踢出）
+- `10_三平台服务-3.4多系统集成+3.5数据密级.md`（多系统集成 + 数据密级）
+- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（服务通知）