update 优化 统一补全代码注释

ruoyi-common/ruoyi-common-social/src/main/java/org/dromara/common/social/config/SocialAutoConfiguration.java

@@ -9,12 +9,18 @@ import org.springframework.context.annotation.Bean;
 
 /**
  * Social 配置属性
+ *
  * @author thiszhc
  */
 @AutoConfiguration
 @EnableConfigurationProperties(SocialProperties.class)
 public class SocialAutoConfiguration {
 
+    /**
+     * 注册第三方授权状态缓存实现。
+     *
+     * @return 授权状态缓存
+     */
     @Bean
     public AuthStateCache authStateCache() {
         return new AuthRedisStateCache();

ruoyi-common/ruoyi-common-social/src/main/java/org/dromara/common/social/utils/SocialUtils.java

@@ -23,6 +23,16 @@ public class SocialUtils  {
 
     private static final AuthRedisStateCache STATE_CACHE = SpringUtils.getBean(AuthRedisStateCache.class);
 
+    /**
+     * 执行第三方登录授权回调。
+     *
+     * @param source 社交平台类型
+     * @param code 授权码
+     * @param state 状态值
+     * @param socialProperties 社交平台配置
+     * @return 授权响应
+     * @throws AuthException 授权异常
+     */
     @SuppressWarnings("unchecked")
     public static AuthResponse<AuthUser> loginAuth(String source, String code, String state, SocialProperties socialProperties) throws AuthException {
         AuthRequest authRequest = getAuthRequest(source, socialProperties);
@@ -32,6 +42,14 @@ public class SocialUtils  {
         return authRequest.login(callback);
     }
 
+    /**
+     * 根据平台类型构建授权请求实例。
+     *
+     * @param source 社交平台类型
+     * @param socialProperties 社交平台配置
+     * @return 授权请求
+     * @throws AuthException 授权异常
+     */
     public static AuthRequest getAuthRequest(String source, SocialProperties socialProperties) throws AuthException {
         SocialLoginConfigProperties obj = socialProperties.getType().get(source);
          if (ObjectUtil.isNull(obj)) {