增加接口描述

zheng-upms/zheng-upms-server/src/main/java/com/zheng/upms/server/controller/ManageController.java

@@ -4,6 +4,8 @@ import com.zheng.common.base.BaseController;
 import com.zheng.upms.dao.model.*;
 import com.zheng.upms.rpc.api.UpmsApiService;
 import com.zheng.upms.rpc.api.UpmsSystemService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.subject.Subject;
 import org.slf4j.Logger;
@@ -22,6 +24,7 @@ import java.util.List;
  */
 @Controller
 @RequestMapping("/manage")
+@Api(value = "后台管理", description = "后台管理")
 public class ManageController extends BaseController {
 
 	private static Logger _log = LoggerFactory.getLogger(ManageController.class);
@@ -32,6 +35,7 @@ public class ManageController extends BaseController {
 	@Autowired
 	private UpmsApiService upmsApiService;
 
+	@ApiOperation(value = "后台首页")
 	@RequestMapping(value = "/index", method = RequestMethod.GET)
 	public String index(ModelMap modelMap) {
 		// 已注册系统

zheng-upms/zheng-upms-server/src/main/java/com/zheng/upms/server/controller/SSOController.java

@@ -7,6 +7,8 @@ import com.zheng.upms.server.util.SystemConstant;
 import com.zheng.upms.dao.model.UpmsSystemExample;
 import com.zheng.upms.rpc.api.UpmsSystemService;
 import com.zheng.upms.rpc.api.UpmsUserService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.apache.commons.lang.StringUtils;
 import org.apache.shiro.SecurityUtils;
 import org.apache.shiro.authc.IncorrectCredentialsException;
@@ -38,6 +40,7 @@ import java.util.UUID;
  */
 @Controller
 @RequestMapping("/sso")
+@Api(value = "单点登录管理", description = "单点登录管理")
 public class SSOController extends BaseController {
 
 	private final static Logger _log = LoggerFactory.getLogger(SSOController.class);
@@ -57,12 +60,7 @@ public class SSOController extends BaseController {
 	@Autowired
 	UpmsUserService upmsUserService;
 
-	/**
+	@ApiOperation(value = "认证中心首页")
-	 * 认证中心首页
-	 * @param request
-	 * @return
-	 * @throws Exception
-	 */
 	@RequestMapping(value = "/index", method = RequestMethod.GET)
 	public String index(HttpServletRequest request) throws Exception {
 		String system_name = request.getParameter("system_name");
@@ -80,10 +78,7 @@ public class SSOController extends BaseController {
 		return "redirect:/sso/login?backurl=" + URLEncoder.encode(backurl, "utf-8");
 	}
 
-	/**
+	@ApiOperation(value = "登录")
-	 * 登录页get
-	 * @return
-	 */
 	@RequestMapping(value = "/login", method = RequestMethod.GET)
 	public String login(HttpServletRequest request, HttpServletResponse response) {
 		// 分配单点登录sessionId，首次获取后缓存到cookie，防止session丢失
@@ -114,11 +109,7 @@ public class SSOController extends BaseController {
 		return "/sso/login";
 	}
 
-	/**
+	@ApiOperation(value = "登录")
-	 * 登录页post
-	 * @param request
-	 * @return
-	 */
 	@RequestMapping(value = "/login", method = RequestMethod.POST)
 	@ResponseBody
 	public Object login(HttpServletRequest request, HttpServletResponse response, ModelMap modelMap) {
@@ -187,11 +178,7 @@ public class SSOController extends BaseController {
 		return result;
 	}
 
-	/**
+	@ApiOperation(value = "校验token")
-	 * 校验token
-	 * @param request
-	 * @return
-	 */
 	@RequestMapping(value = "/token", method = RequestMethod.POST)
 	@ResponseBody
 	public String token(HttpServletRequest request) {
@@ -203,12 +190,7 @@ public class SSOController extends BaseController {
 		return "success";
 	}
 
-	/**
+	@ApiOperation(value = "退出登录")
-	 * 退出登录
-	 * @param request
-	 * @param response
-	 * @return
-	 */
 	@RequestMapping(value = "/logout", method = RequestMethod.GET)
 	public String logout(HttpServletRequest request, HttpServletResponse response) {
 		// shiro退出登录