update 优化 统一补全代码注释

ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/core/OssClient.java

@@ -547,6 +547,9 @@ public class OssClient {
 
     /**
      * 检查配置是否相同
+     *
+     * @param properties OSS 配置
+     * @return 是否与当前客户端配置一致
      */
     public boolean checkPropertiesSame(OssProperties properties) {
         return this.properties.equals(properties);

ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/core/WriteOutSubscriber.java

@@ -10,6 +10,12 @@ import java.io.IOException;
 @FunctionalInterface
 public interface WriteOutSubscriber<T> {
 
+    /**
+     * 将订阅到的数据写出到目标对象。
+     *
+     * @param out 写出目标
+     * @throws IOException 写出异常
+     */
     void writeTo(T out) throws IOException;
 
 }

ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/exception/OssException.java

@@ -12,6 +12,11 @@ public class OssException extends RuntimeException {
     @Serial
     private static final long serialVersionUID = 1L;
 
+    /**
+     * 创建 OSS 业务异常。
+     *
+     * @param msg 异常消息
+     */
     public OssException(String msg) {
         super(msg);
     }

ruoyi-common/ruoyi-common-oss/src/main/java/org/dromara/common/oss/factory/OssFactory.java

@@ -27,7 +27,9 @@ public class OssFactory {
     private static final ReentrantLock LOCK = new ReentrantLock();
 
     /**
-     * 获取默认实例
+     * 获取默认 OSS 客户端实例。
+     *
+     * @return 默认 OSS 客户端
      */
     public static OssClient instance() {
         // 获取redis 默认类型
@@ -39,7 +41,10 @@ public class OssFactory {
     }
 
     /**
-     * 根据类型获取实例
+     * 根据配置键获取 OSS 客户端实例。
+     *
+     * @param configKey 配置键
+     * @return OSS 客户端
      */
     public static OssClient instance(String configKey) {
         String json = CacheUtils.get(CacheNames.SYS_OSS_CONFIG, configKey);