更新版本号 (#29)

Co-authored-by: liucheng.yao <[email protected]>

Author: summerboy2134

collections/_java-sdk/快速使用.md

@@ -1,4 +1,4 @@
---- 
+---
 title: '快速使用'
 sidebar:
  nav: java-sdk
@@ -22,17 +22,18 @@ sidebar:
 
 - **[ufile-client-java ](https://github.com/ucloud/ufile-sdk-java/tree/master/ufile/ufile-client-java/apidocs.zip)**
     - **[ufile-core ](https://github.com/ucloud/ufile-sdk-java/tree/master/ufile/ufile-core/apidocs.zip)**
-    
+
 ## 安装
 - Maven
 
-    您可以通过在pom.xml中添加以下依赖项，来配置您的Maven项目
+    您可以通过在pom.xml中添加以下依赖项，来配置您的Maven项目。添加依赖后，请执行项目刷新（如 IDEA 中点击 Reload Project）以使依赖生效。
 
     ``` xml
     <dependency>
         <groupId>cn.ucloud.ufile</groupId>
         <artifactId>ufile-client-java</artifactId>
-        <version>latest-release-version</version>
+        <!-- 当前推荐版本 -->
+        <version>2.7.4</version>
     </dependency>
     ```
 
@@ -51,11 +52,11 @@ sidebar:
 
 - 基本说明：
     - 所有API均包含同步执行(execute)和异步执行(executeAsync)两种执行方式。
-    
+
     - 同步执行会返回指定的业务结果类，若执行出错则会抛出UfileException为父类的异常；
-    
+
     - 异步执行需要传入UfileCallback<T>的回调接口，执行成功时会回调onResponse，泛型<T>为回调结果(即：同步执行的返回类型)，**值得注意的是，若Ufile Server业务错误，也会回调onResponse，请注意结果类中的信息**，若出现异常，则回调onError。
-    
+
     - 如果是上传下载等耗时API，建议使用异步执行(executeAsync)，并可以重写UfileCallback中的onProgress回调来进行进度监听
 
 ## 配置UfileClient
@@ -76,7 +77,7 @@ sidebar:
 // Bucket相关API的授权器
 BucketAuthorization BUCKET_AUTHORIZER = new UfileBucketLocalAuthorization(
             "Your PublicKey", "Your PrivateKey");
-            
+
 UfileClient.bucket(BUCKET_AUTHORIZER)
     .APIs       // Bucket相关操作API
     .execute() or executeAsync(UfileCallback<T>)
@@ -96,7 +97,7 @@ UfileClient.bucket(BUCKET_AUTHORIZER)
         e.printStackTrace();
     }
     ```
-    
+
 - 异步
 
     ``` java
@@ -105,12 +106,12 @@ UfileClient.bucket(BUCKET_AUTHORIZER)
         .executeAsync(new UfileCallback<BucketResponse>() {
             @Override
             public void onResponse(BucketResponse response) {
-                
+
             }
-        
+
             @Override
             public void onError(Request request, ApiError error, UfileErrorBean response) {
-                
+
             }
     });
     ```
@@ -123,7 +124,7 @@ UfileClient.bucket(BUCKET_AUTHORIZER)
 // 对象相关API的授权器
 ObjectAuthorization OBJECT_AUTHORIZER = new UfileObjectLocalAuthorization(
             "Your PublicKey", "Your PrivateKey");
-            
+
 /**
  * 您也可以创建远程对象相关API的授权器，远程授权器将签名私钥放于签名服务器上，更为安全
  * 远程签名服务端示例代码在 (https://github.com/ucloud/ufile-sdk-auth-server)
@@ -138,7 +139,7 @@ ObjectAuthorization OBJECT_AUTHORIZER = new UfileObjectRemoteAuthorization(
 // 对象操作需要ObjectConfig来配置您的地区和域名后缀
 ObjectConfig config = new ObjectConfig("your bucket region", "ufileos.com");
 
-/** 
+/**
  * 您也可以使用已登记的自定义域名
  * 注意'http://www.your_domain.com'指向的是某个特定的bucket+region+域名后缀，
  * eg：http://www.your_domain.com -> www.your_bucket.bucket_region.ufileos.com
@@ -148,7 +149,7 @@ ObjectConfig config = new ObjectConfig("http://www.your_domain.com");
 /**
  * ObjectConfig同时支持从本地文件来导入
  * 配置文件内容必须是含有以下参数的json字符串：
- *     {"Region":"","ProxySuffix":""} 
+ *     {"Region":"","ProxySuffix":""}
  *     或
  *     {"CustomDomain":""}
  */
@@ -169,7 +170,7 @@ UfileClient.object(OBJECT_AUTHORIZER, config)
 
     ``` java
     File file = new File("your file path");
-    
+
     try {
         PutObjectResultBean response = UfileClient.object(Constants.OBJECT_AUTHORIZER, config)
              .putObject(file, "mimeType")
@@ -189,7 +190,7 @@ UfileClient.object(OBJECT_AUTHORIZER, config)
              .setOnProgressListener(new OnProgressListener() {
                   @Override
                   public void onProgress(long bytesWritten, long contentLength) {
-                      
+
                   }
              })
              .execute();
@@ -204,7 +205,7 @@ UfileClient.object(OBJECT_AUTHORIZER, config)
 
     ``` java
     File file = new File("your file path");
-    
+
     UfileClient.object(OBJECT_AUTHORIZER, config)
          .putObject(file, "mimeType")
          .nameAs("save as keyName")
@@ -220,17 +221,17 @@ UfileClient.object(OBJECT_AUTHORIZER, config)
          .executeAsync(new UfileCallback<PutObjectResultBean>() {
              @Override
                 public void onProgress(long bytesWritten, long contentLength) {
-                    
+
                 }
-    
+
                 @Override
                 public void onResponse(PutObjectResultBean response) {
-                    
+
                 }
-    
+
                 @Override
                 public void onError(Request request, ApiError error, UfileErrorBean response) {
-                    
+
                 }
          });
     ```

collections/_java-sdk/获取文件基本信息.md

@@ -1,11 +1,11 @@
----  
+---
 title: '获取文件基本信息'
 sidebar:
   nav: java-sdk
 ---
-SDK 提供`HeadFile`方法获取文件基本信息。
+SDK 提供`ObjectProfile`方法获取文件基本信息。
 
-`HeadFile`方法请求的 US3 API 为 HEADFile，具体详见[HEADFileAPI文档](https://docs.ucloud.cn/api/ufile-api/head_file)。
+`ObjectProfile`方法请求的 US3 API 为 HEADFile，具体详见[HEADFileAPI文档](https://docs.ucloud.cn/api/ufile-api/head_file)。
 
 ### 文件基本信息说明
 
@@ -26,40 +26,30 @@ SDK 提供`HeadFile`方法获取文件基本信息。
 <div class="copyable" markdown="1">
 
 {% highlight go linenos %}
-package main
-
-import (
-	ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
-	"log"
-)
+public static void main(String[] args) {
+// 配置参数
+String keyName = "your-file-name.txt";
+String bucketName = "your-bucket-name";
+ObjectConfig config = new ObjectConfig("cn-sh2", "ufileos.com");
 
-const (
-	ConfigFile = "config.json"
-	KeyName = "FakeBigFile.txt"
-)
+        try {
+            // 获取文件头信息
+            ObjectProfile profile = UfileClient.object(Constants.OBJECT_AUTHORIZER, config)
+                    .objectProfile(keyName, bucketName)
+                    .execute();
 
-func main() {
+              System.out.println("Content-Type: " + profile.getContentType());
+              System.out.println("Content-Length: " + profile.getContentLength());
+              System.out.println("X-Ufile-Create-Time: " + profile.getCreateTime());
+              System.out.println("X-Ufile-Storage-Class: " + profile.getStorageType());
+              System.out.println("ETag: " + profile.geteTag());
+              System.out.println("Last-Modified: " + profile.getLastModified());
 
-	// 加载配置，创建请求
-	config, err := ufsdk.LoadConfig(ConfigFile)
-	if err != nil {
-		panic(err.Error())
-	}
-	req, err := ufsdk.NewFileRequest(config, nil)
-	if err != nil {
-		panic(err.Error())
-	}
-	// 获取文件基本信息，获取成功
-	err = req.HeadFile(KeyName)
-	if err != nil {
-		log.Fatalf("查询文件信息失败，具体错误详情：%s", err.Error())
-	}
-	// 若获取成功，返回的文件基本信息保存在req.LastResponseHeader中
-	log.Println("查询文件信息成功,返回信息为：")
-	for key, val := range req.LastResponseHeader {
-		log.Println(key, "：", val)
-	}
-}
+        } catch (Exception e) {
+            System.err.println("获取文件信息失败: " + e.getMessage());
+            e.printStackTrace();
+        }
+    }
 
 {% endhighlight %}
 </div>

collections/_js-sdk/分片上传.md

@@ -22,10 +22,14 @@ sidebar:
 - `Body`: 要上传的文件分片的内容
 - `ContentMD5`: 指定分片数据的 MD5 校验值
 
+### 注意
+在通过AWS SDK使用US3的分片上传服务时，一定要指定分片大小为8MB
+const partSize = 8 * 1024 * 1024; // 固定8MB
+
 ### 示例
 > 执行该示例前请确保配置文件的正确性<br>以下代码段需要在上下文中运行
 
-<div class="copyable" markdown="1">
+<div class="copyable" markdown="1">
 {% highlight javascript linenos %}
 function MultipartUpload() {
     const [bucketName, setBucketName] = useState("");
@@ -49,8 +53,8 @@ function MultipartUpload() {
         const partSize = 8 * 1024 * 1024; // 8MB
         const numParts = Math.ceil(selectedFile.size / partSize);
         let uploadId;
-        try {
-        
+        try {
+
         // 创建分片上传任务
             const createMultipartUploadResponse = await s3.send(
                 new CreateMultipartUploadCommand({
@@ -89,8 +93,8 @@ function MultipartUpload() {
                 if (!part.ETag) {
                     throw new Error(`Part ${part.PartNumber} 上传失败`);
                 }
-            });
-            
+            });
+
              // 完成分片上传
             await s3.send(
                 new CompleteMultipartUploadCommand({
@@ -107,8 +111,8 @@ function MultipartUpload() {
         } catch (error) {
             console.error("上传文件失败:", error);
             setUploadStatus("上传文件失败");
-            if (uploadId) {
-            
+            if (uploadId) {
+
             // 如果上传失败，中止上传
                 await s3.send(
                     new AbortMultipartUploadCommand({
@@ -121,5 +125,5 @@ function MultipartUpload() {
         }
     };
 
-{% endhighlight %}
-</div>
+{% endhighlight %}
+</div>

collections/_js-sdk/安装.md

@@ -5,8 +5,11 @@ sidebar:
 ---
 
 ## 环境准备
+对象存储提供了 AWS S3 兼容的 API，因此只需要进行简单的配置修改，即可使用 S3 SDK 的接口来访问对象存储系统中的文件。
+
 AWS SDK for JavaScript v3，推荐使用 ES6+ 版本的 JavaScript。在 Node.js 环境中，版本为 16.x 或更高。浏览器需支持基本的 HTML5 特性（支持 IE10 以上浏览器）
 
+AWS SDK版本是 3.627.0
 ## 下载SDK源码
 
 * [通过Github下载](https://github.com/aws/aws-sdk-js-v3)

collections/_node.js-sdk/分片上传.md

@@ -22,6 +22,10 @@ sidebar:
 - `Body`: 要上传的文件分片的内容
 - `ContentMD5`: 指定分片数据的 MD5 校验值
 
+### 注意
+在通过AWS SDK使用US3的分片上传服务时，一定要指定分片大小为8MB
+const partSize = 8 * 1024 * 1024; // 固定8MB
+
 ### 示例
 > 执行该示例前请确保配置文件的正确性<br>以下代码段需要在上下文中运行
 

collections/_node.js-sdk/安装.md

@@ -4,8 +4,12 @@ sidebar:
  nav: node.js-sdk
 ---
 ## 环境准备
+对象存储提供了 AWS S3 兼容的 API，因此只需要进行简单的配置修改，即可使用 S3 SDK 的接口来访问对象存储系统中的文件。
+
 AWS SDK for JavaScript v3，推荐使用 ES6+ 版本的 JavaScript。在 Node.js 环境中，版本为 16.x 或更高。浏览器需支持基本的 HTML5 特性（支持 IE10 以上浏览器）
 
+推荐AWS SDK版本是3.621.0
+
 ## 下载SDK源码
 
 * [通过Github下载](https://github.com/aws/aws-sdk-js-v3)

collections/_php-sdk/分片上传.md

@@ -19,6 +19,11 @@ sidebar:
 - `Body`: 要上传的文件分片的内容
 - `ContentMD5`: 指定分片数据的 MD5 校验值
 
+### 注意
+在通过AWS SDK使用US3的分片上传服务时，一定要指定分片大小为8MB
+$partSize = 8 * 1024 * 1024; // 固定8MB
+
+
 ### 示例
 > 执行该示例前请确保配置文件的正确性<br>以下代码段需要在上下文中运行
 

collections/_php-sdk/安装.md

@@ -5,8 +5,12 @@ sidebar:
 ---
 
 ## 环境准备
+对象存储提供了 AWS S3 兼容的 API，因此只需要进行简单的配置修改，即可使用 S3 SDK 的接口来访问对象存储系统中的文件。
+
 PHP SDK适用于PHP 5.3以上版本。本文以PHP 5.6.22为例。
 
+AWS SDK版本号: 3.320.4
+
 ### 安装环境
 
 您需要安装PHP和cURL扩展：