Merge branch 'master' into master

Author: joshua.yin

.gitignore

@@ -1,8 +1,10 @@
 *.DS_Store
 out
-target/
+target
 .gradle
 .idea
-build/
+build
 *.iml
-classes/
+.classpath
+.project
+.settings/

README.md

@@ -1,4 +1,4 @@
-# UCloud Ufile SDK for Java
+# UCloud US3 (原名UFile) SDK for Java
 
 [![](https://img.shields.io/github/release/ucloud/ufile-sdk-java.svg)](https://github.com/ucloud/ufile-sdk-java)
 [![](https://img.shields.io/github/last-commit/ucloud/ufile-sdk-java.svg)](https://github.com/ucloud/ufile-sdk-java)
@@ -43,7 +43,7 @@
 ## 快速入门
 
 - 基本说明：
-    - 所有Ufile所有API均包含同步执行(execute)和异步执行(executeAsync)两种执行方式。
+    - 所有API均包含同步执行(execute)和异步执行(executeAsync)两种执行方式。
 
     - 同步执行会返回指定的业务结果类，若执行出错则会抛出UfileException为父类的异常；
 

ufile-sample-java/src/main/java/cn/ucloud/ufile/sample/object/ObjectETagSample.java

@@ -0,0 +1,91 @@
+package cn.ucloud.ufile.sample.object;
+
+import cn.ucloud.ufile.UfileClient;
+import cn.ucloud.ufile.api.object.ObjectConfig;
+import cn.ucloud.ufile.bean.ObjectProfile;
+import cn.ucloud.ufile.exception.UfileClientException;
+import cn.ucloud.ufile.exception.UfileServerException;
+import cn.ucloud.ufile.sample.Constants;
+import cn.ucloud.ufile.util.Etag;
+import cn.ucloud.ufile.util.JLog;
+
+import java.io.*;
+
+/**
+ * @author: clark.liu
+ * @E-mail: clark.liu@ucloud.cn
+ * @date: 2021-02-23
+ */
+public class ObjectETagSample {
+    private static final String TAG = "GetObjectETagSample";
+    private static ObjectConfig config = new ObjectConfig("cn-sh2", "ufileos.com");
+
+    public static void main(String[] args) {
+        computeLocalFileETag();
+        // computeLocalFileETagUseStream();
+        // getBucketObjectETag();
+        // compareETag();
+    }
+
+    public static void computeLocalFileETag() {
+        String path = "";
+        try {
+            File file = new File(path);
+            Etag etag = Etag.etag(file);
+            JLog.D(TAG, String.format("ETag is [%s]: file path [%s]", etag.geteTag(), path));
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
+    }
+
+    public static void computeLocalFileETagUseStream() {
+        String path = "";
+        try {
+            InputStream in = new FileInputStream(path);
+            Etag etag = Etag.etag(in);
+            JLog.D(TAG, String.format("ETag is [%s]: file path [%s]", etag.geteTag(), path));
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
+    }
+
+    public static void getBucketObjectETag() {
+        String keyName = "";
+        String bucketName = "";
+
+        try {
+            ObjectProfile objectProfile = UfileClient.object(Constants.OBJECT_AUTHORIZER, config)
+                    .objectProfile(keyName, bucketName).execute();
+
+            if (objectProfile == null) {
+                JLog.D(TAG, String.format("key [%s] may be not exist", keyName));
+                return;
+            }
+
+            JLog.D(TAG, String.format("key [%s] ETag: %s", keyName, objectProfile.geteTag()));
+        } catch (UfileClientException e) {
+            e.printStackTrace();
+        } catch (UfileServerException e) {
+            e.printStackTrace();
+        }
+    }
+
+    public static void compareETag() {
+        String keyName = "";
+        String bucketName = "";
+        String localpath = "";
+
+        try {
+            File f = new File(localpath);
+            if (UfileClient.object(Constants.OBJECT_AUTHORIZER, config).compareEtag(f, keyName, bucketName)) {
+                JLog.D(TAG, "ETag compare success");
+            } else {
+                JLog.D(TAG, "ETag compare fail");
+            }
+        } catch (UfileClientException e) {
+            e.printStackTrace();
+        } catch (UfileServerException e) {
+            e.printStackTrace();
+        }
+    }
+}