From 9f2f393d3fc75fdbd865af7e1c59dae6cb93536c Mon Sep 17 00:00:00 2001
From: thinkgem <thinkgem@163.com>
Date: Tue, 24 May 2022 22:27:36 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0@Api=E4=B8=AD=E6=96=87?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/com/jeesite/modules/sys/web/AreaController.java   | 2 ++
 .../main/java/com/jeesite/modules/sys/web/CacheController.java  | 2 ++
 .../java/com/jeesite/modules/sys/web/CompanyController.java     | 2 ++
 .../main/java/com/jeesite/modules/sys/web/LogController.java    | 2 ++
 .../main/java/com/jeesite/modules/sys/web/LoginController.java  | 2 ++
 .../main/java/com/jeesite/modules/sys/web/OfficeController.java | 2 ++
 .../main/java/com/jeesite/modules/sys/web/OnlineController.java | 2 ++
 .../main/java/com/jeesite/modules/sys/web/PostController.java   | 2 ++
 .../main/java/com/jeesite/modules/sys/web/SsoController.java    | 2 ++
 .../com/jeesite/modules/sys/web/user/CorpAdminController.java   | 2 ++
 .../com/jeesite/modules/sys/web/user/EmpUserController.java     | 2 ++
 .../com/jeesite/modules/sys/web/user/SecAdminController.java    | 2 ++
 .../java/com/jeesite/modules/sys/web/user/UserController.java   | 1 +
 13 files changed, 25 insertions(+)

diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/AreaController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/AreaController.java
index 538db2af..d31edb94 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/AreaController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/AreaController.java
@@ -10,6 +10,7 @@ import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -40,6 +41,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2014-8-19
  */
 @Controller
+@Api(tags = "Area - 行政区划")
 @RequestMapping(value = "${adminPath}/sys/area")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class AreaController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/CacheController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/CacheController.java
index 9bdd08da..14a66c15 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/CacheController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/CacheController.java
@@ -2,6 +2,7 @@ package com.jeesite.modules.sys.web;
 
 import javax.annotation.PostConstruct;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.Logical;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.stereotype.Controller;
@@ -21,6 +22,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 20167-8-27
  */
 @Controller
+@Api(tags = "Cache - 缓存管理")
 @RequestMapping(value = "${adminPath}/sys/cache")
 public class CacheController extends BaseController {
 
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/CompanyController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/CompanyController.java
index f8019142..64a65274 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/CompanyController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/CompanyController.java
@@ -9,6 +9,7 @@ import java.util.Map;
 
 import javax.servlet.http.HttpServletRequest;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -38,6 +39,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2014-8-19
  */
 @Controller
+@Api(tags = "Company - 公司管理")
 @RequestMapping(value = "${adminPath}/sys/company")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class CompanyController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/LogController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/LogController.java
index 97f6405e..bf0f6257 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/LogController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/LogController.java
@@ -7,6 +7,7 @@ package com.jeesite.modules.sys.web;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -27,6 +28,7 @@ import com.jeesite.modules.sys.service.LogService;
  * @version 2013-6-2
  */
 @Controller
+@Api(tags = "Log - 访问日志")
 @RequestMapping(value = "${adminPath}/sys/log")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class LogController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/LoginController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/LoginController.java
index 0edb747b..f22004ef 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/LoginController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/LoginController.java
@@ -11,6 +11,7 @@ import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
 import com.jeesite.modules.sys.utils.CorpUtils;
+import io.swagger.annotations.Api;
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.authz.AuthorizationInfo;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
@@ -44,6 +45,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2020-9-19
  */
 @Controller
+@Api(tags = "Login - 登录公共")
 @RequestMapping(value = "${adminPath}")
 @ConditionalOnProperty(name="user.enabled", havingValue="true", matchIfMissing=true)
 public class LoginController extends BaseController{
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/OfficeController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/OfficeController.java
index d8ec4536..9aa60c99 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/OfficeController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/OfficeController.java
@@ -9,6 +9,7 @@ import java.util.Map;
 
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -41,6 +42,7 @@ import com.jeesite.modules.sys.web.user.EmpUserController;
  * @version 2014-8-19
  */
 @Controller
+@Api(tags = "Office - 组织机构")
 @RequestMapping(value = "${adminPath}/sys/office")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class OfficeController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/OnlineController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/OnlineController.java
index b0d14fdd..c338a1ea 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/OnlineController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/OnlineController.java
@@ -13,6 +13,7 @@ import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.apache.shiro.session.Session;
 import org.apache.shiro.subject.PrincipalCollection;
@@ -42,6 +43,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2022-3-10
  */
 @Controller
+@Api(tags = "Online - 在线用户")
 @RequestMapping(value = "${adminPath}/sys/online")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class OnlineController extends BaseController{
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/PostController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/PostController.java
index 6c9427de..c2cbc22c 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/PostController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/PostController.java
@@ -10,6 +10,7 @@ import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -36,6 +37,7 @@ import com.jeesite.modules.sys.service.PostService;
  * @version 2017-03-25
  */
 @Controller
+@Api(tags = "Post - 岗位管理")
 @RequestMapping(value = "${adminPath}/sys/post")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class PostController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/SsoController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/SsoController.java
index 1e550657..cf79cdcb 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/SsoController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/SsoController.java
@@ -7,6 +7,7 @@ package com.jeesite.modules.sys.web;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.commons.lang3.StringUtils;
 import org.apache.shiro.authc.AuthenticationException;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -32,6 +33,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2020-9-19
  */
 @Controller
+@Api(tags = "SSO - 单点登录")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class SsoController extends BaseController{
 	
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/CorpAdminController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/CorpAdminController.java
index c144cf19..81ea1013 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/CorpAdminController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/CorpAdminController.java
@@ -10,6 +10,7 @@ import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.apache.shiro.session.Session;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -43,6 +44,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2017-03-26
  */
 @Controller
+@Api(tags = "CorpAdmin - 租户管理员管理")
 @RequestMapping(value = "${adminPath}/sys/corpAdmin")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class CorpAdminController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/EmpUserController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/EmpUserController.java
index c88eef3a..7c5a9c47 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/EmpUserController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/EmpUserController.java
@@ -10,6 +10,7 @@ import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.Logical;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.apache.shiro.subject.Subject;
@@ -61,6 +62,7 @@ import com.jeesite.modules.sys.utils.UserUtils;
  * @version 2017-03-26
  */
 @Controller
+@Api(tags = "EmpUser - 员工用户管理")
 @RequestMapping(value = "${adminPath}/sys/empUser")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class EmpUserController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/SecAdminController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/SecAdminController.java
index d54a8d2e..e7bd0361 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/SecAdminController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/SecAdminController.java
@@ -9,6 +9,7 @@ import java.util.List;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
@@ -35,6 +36,7 @@ import com.jeesite.modules.sys.utils.ModuleUtils;
  * @version 2017-12-12
  */
 @Controller
+@Api(tags = "SecAdmin - 二级管理员管理")
 @RequestMapping(value = "${adminPath}/sys/secAdmin")
 @ConditionalOnProperty(name={"user.enabled","web.core.enabled"}, havingValue="true", matchIfMissing=true)
 public class SecAdminController extends BaseController {
diff --git a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/UserController.java b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/UserController.java
index 1f914169..992dfe8f 100644
--- a/modules/core/src/main/java/com/jeesite/modules/sys/web/user/UserController.java
+++ b/modules/core/src/main/java/com/jeesite/modules/sys/web/user/UserController.java
@@ -7,6 +7,7 @@ package com.jeesite.modules.sys.web.user;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
 import org.apache.shiro.authz.annotation.RequiresPermissions;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;