From 237ea8fcd87ae6db9c9830fdc251bb96a09e3f89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=92=B1=E6=B6=9B?= <15850646081@163.com>
Date: Tue, 8 Oct 2024 19:47:18 +0800
Subject: [PATCH] =?UTF-8?q?=E4=B8=9A=E5=8A=A1=E7=BA=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../salary/service/auth/AuthService.java      | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/src/com/engine/salary/service/auth/AuthService.java b/src/com/engine/salary/service/auth/AuthService.java
index fd45761f4..ad09913d6 100644
--- a/src/com/engine/salary/service/auth/AuthService.java
+++ b/src/com/engine/salary/service/auth/AuthService.java
@@ -17,13 +17,53 @@ import java.util.List;
  **/
 public interface AuthService {
 
+    /**
+     * 单一对象权限识别
+     *
+     * @param t          对象实体
+     * @param filterType 数据过滤方式，默认采用“数据&功能权限”方式过滤
+     * @param clazz      反射类，需加@Auth注解定义权限项
+     * @param <T>        对象泛型
+     * @return 是否有权限
+     */
     <T> boolean auth(T t, AuthFilterTypeEnum filterType, Class<T> clazz);
 
+    /**
+     * 对象权限识别
+     *
+     * @param list       对象集合
+     * @param filterType <></>数据过滤方式，默认采用“数据&功能权限”方式过滤
+     * @param clazz      反射类，需加@Auth注解定义权限项
+     * @param <T>        对象泛型
+     * @return 有权限的对象集合
+     */
     <T> List<T> auth(List<T> list, AuthFilterTypeEnum filterType, Class<T> clazz);
 
+    /**
+     * 对象权限识别
+     *
+     * @param list       对象集合
+     * @param filterType 数据过滤方式，默认采用“数据&功能权限”方式过滤
+     * @param clazz      反射类，需加@Auth注解定义权限项
+     * @param page       页面标识，用于获取权限项
+     * @param <T>        对象泛型
+     * @return 有权限的对象集合
+     */
     <T> List<T> auth(List<T> list, AuthFilterTypeEnum filterType, Class<T> clazz, String page);
 
+    /**
+     * 单页权限识别
+     *
+     * @param page 页面标识，用于获取权限项
+     * @return 权限树
+     */
     Permission permission(String page);
 
+    /**
+     * 权限树
+     *
+     * @param param 查询参数
+     * @return 权限树
+     */
     AuthTreeDTO tree(AuthTreeQueryParam param);
 }