添加请求头

src/main/java/com/muyu/auth/controller/TokenController.java

@@ -1,15 +1,20 @@
 package com.muyu.auth.controller;
 
-import com.muyu.auth.form.LoginBody;
+
+import com.muyu.auth.form.LoginUserReq;
 import com.muyu.auth.form.RegisterBody;
+import com.muyu.auth.form.TokenResp;
 import com.muyu.auth.service.SysLoginService;
 import com.muyu.common.core.domain.Result;
+import com.muyu.common.core.text.Convert;
 import com.muyu.common.core.utils.JwtUtils;
 import com.muyu.common.core.utils.StringUtils;
 import com.muyu.common.security.auth.AuthUtil;
 import com.muyu.common.security.service.TokenService;
 import com.muyu.common.security.utils.SecurityUtils;
 import com.muyu.common.system.domain.LoginUser;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -18,12 +23,15 @@ import org.springframework.web.bind.annotation.RestController;
 
 import jakarta.servlet.http.HttpServletRequest;
 
+import java.util.Map;
+
 /**
  * token 控制
  *
  * @author muyu
  */
 @RestController
+@Tag(name = "鉴权接口",description = "鉴权相关控制层")
 public class TokenController {
     @Autowired
     private TokenService tokenService;
@@ -32,14 +40,22 @@ public class TokenController {
     private SysLoginService sysLoginService;
 
     @PostMapping("login")
-    public Result<?> login (@RequestBody LoginBody form) {
+    @Operation(summary = "登录接口",description = "登陆鉴权接口")
+    public Result<TokenResp> login (@RequestBody LoginUserReq form) {
         // 用户登录
         LoginUser userInfo = sysLoginService.login(form.getUsername(), form.getPassword());
         // 获取登录token
-        return Result.success(tokenService.createToken(userInfo));
+        Map<String, Object> tokenMap = tokenService.createToken(userInfo);
+        return Result.success(
+                TokenResp.builder()
+                        .accessToken(Convert.toStr(tokenMap.get("access_token")))
+                        .expiresIn(Convert.toLong(tokenMap.get("expires_in")))
+                        .build()
+        );
     }
 
     @DeleteMapping("logout")
+    @Operation(summary = "注销接口",description = "用户注销接口")
     public Result<?> logout (HttpServletRequest request) {
         String token = SecurityUtils.getToken(request);
         if (StringUtils.isNotEmpty(token)) {
@@ -53,6 +69,7 @@ public class TokenController {
     }
 
     @PostMapping("refresh")
+    @Operation(summary = "用户登录时间刷新",description = "用户登录时间刷新，可进行用户token续约")
     public Result<?> refresh (HttpServletRequest request) {
         LoginUser loginUser = tokenService.getLoginUser(request);
         if (StringUtils.isNotNull(loginUser)) {

src/main/java/com/muyu/auth/form/LoginUserReq.java

@@ -0,0 +1,32 @@
+package com.muyu.auth.form;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 用户登录对象
+ *
+ * @author muyu
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@Tag(name = "登录请求实体类")
+public class LoginUserReq {
+    /**
+     * 用户名
+     */
+    @Schema(title = "用户名称",type = "String",defaultValue = "admin",description = "登录用户名称")
+    private String username;
+
+    /**
+     * 用户密码
+     */
+    @Schema(title = "用户密码",type = "String",defaultValue = "admin123",description = "登录用户密码")
+    private String password;
+}

src/main/java/com/muyu/auth/form/TokenResp.java

@@ -0,0 +1,32 @@
+package com.muyu.auth.form;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Builder
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Tag(name = "token响应结果集",description = "包好token和token有限时间")
+public class TokenResp {
+    /**
+     * token令牌
+     */
+    @Schema(title = "token令牌",
+            type = "String",
+            defaultValue = "eyJ0e.eyJ1c2SJ9.MZmfhiY-gbbRp4ij",
+            description = "JWT令牌，包含头，载体，尾")
+    private String accessToken;
+    /**
+     * 有限时间
+     */
+    @Schema(title = "令牌有限时间",
+            type = "Long",
+            defaultValue = "720",
+            description = "过期时间，时间单位为分钟(MIN))")
+    private Long expiresIn;
+}