Merge branch 'master' into QRTC-1875

Author: QN-zhangzhuo

.codebeatsettings

@@ -0,0 +1,6 @@
+{
+  "JAVA": {
+    "TOO_MANY_IVARS": [8, 15, 20, 25],
+    "ARITY": [5, 10, 15, 20]
+  }
+}

CHANGELOG.md

@@ -1,4 +1,8 @@
 # Changelog
+
+## 7.10.1 (2022-04-25)
+* 对象存储，补充 stat api 可查看对象元数据信息
+
 ## 7.10.0 （2022-04-15）
 * 对象存储，新增支持 [深度归档存储类型](https://developer.qiniu.com/kodo/3956/kodo-category#deep_archive)
 

src/main/java/com/qiniu/common/Constants.java

@@ -9,7 +9,7 @@ public final class Constants {
     /**
      * 版本号
      */
-    public static final String VERSION = "7.10.0";
+    public static final String VERSION = "7.10.1";
     /**
      * 块大小，不能改变
      */

src/main/java/com/qiniu/storage/model/FileInfo.java

@@ -30,6 +30,13 @@ public final class FileInfo {
      */
     public long putTime;
 
+    /**
+     * 归档/深度归档存储文件的解冻状态，归档/深度归档文件冻结时，不返回该字段。
+     * 1 表示解冻中
+     * 2 表示解冻完成
+     */
+    public Integer restoreStatus;
+
     /**
      * 文件的mimeType
      */
@@ -61,6 +68,48 @@ public final class FileInfo {
      */
     public String md5;
 
+    /**
+     * 文件过期删除日期，int64 类型，Unix 时间戳格式，具体文件过期日期计算参考 生命周期管理。
+     * 文件在设置过期时间后才会返回该字段（通过生命周期规则设置文件过期时间，仅对该功能发布后满足规则条件新上传文件返回该字段；
+     * 历史文件想要返回该字段需要在功能发布后可通过 修改文件过期删除时间 API 或者 修改文件生命周期 API 指定过期时间；对于已
+     * 经设置过过期时间的历史文件，到期都会正常过期删除，只是服务端没有该字段返回)
+     *
+     * 例如：值为1568736000的时间，表示文件会在2019/9/18当天内删除。
+     */
+    public Long expiration;
+
+
+    /**
+     * 文件生命周期中转为低频存储的日期，int64 类型，Unix 时间戳格式 ，具体日期计算参考 生命周期管理。
+     * 文件在设置转低频后才会返回该字段（通过生命周期规则设置文件转低频，仅对该功能发布后满足规则条件新上传文件返回该字段；
+     * 历史文件想要返回该字段需要在功能发布后可通过 修改文件生命周期 API 指定转低频时间；对于已经设置过转低频时间的历史文
+     * 件，到期都会正常执行，只是服务端没有该字段返回)
+     *
+     * 例如：值为1568736000的时间，表示文件会在2019/9/18当天转为低频存储类型。
+     */
+    public Long transitionToIA;
+
+    /**
+     * 文件生命周期中转为归档存储的日期，int64 类型，Unix 时间戳格式 ，具体日期计算参考 生命周期管理。
+     * 文件在设置转归档后才会返回该字段（通过生命周期规则设置文件转归档，仅对该功能发布后满足规则条件新上传文件返回该字段；
+     * 历史文件想要返回该字段需要在功能发布后可通过 修改文件生命周期 API 指定转归档时间；对于已经设置过转归档时间的历史文
+     * 件，到期都会正常执行，只是服务端没有该字段返回)
+     *
+     * 例如：值为1568736000的时间，表示文件会在2019/9/18当天转为归档存储类型。
+     */
+    @SerializedName("transitionToARCHIVE")
+    public Long transitionToArchive;
+
+    /**
+     * 文件生命周期中转为深度归档存储的日期，int64 类型，Unix 时间戳格式 ，具体日期计算参考 生命周期管理。
+     * 文件在设置转深度归档后才会返回该字段（通过生命周期规则设置文件转深度归档，仅对该功能发布后满足规则条件新上传文件返回该字段；
+     * 历史文件想要返回该字段需要在功能发布后可通过 修改文件生命周期 API 指定转深度归档时间；对于已经设置过转深度归档时间的历史文
+     * 件，到期都会正常执行，只是服务端没有该字段返回)
+     *
+     * 例如：值为1568736000的时间，表示文件会在2019/9/18当天转为深度归档存储类型。
+     */
+    public Long transitionToDeepArchive;
+
     /**
      * 自定义 meta data 数据
      */

src/test/java/test/com/qiniu/storage/BucketTest2.java

@@ -18,6 +18,14 @@
 import test.com.qiniu.ResCode;
 import test.com.qiniu.TestConfig;
 
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.io.IOException;
 import java.text.SimpleDateFormat;
 import java.util.*;
@@ -215,6 +223,60 @@ public void testListMarkerV2() {
     @Test
     @Tag("IntegrationTest")
     public void testStat() {
+        String ruleName = "javaStatusRule";
+        String copyKey = TestConfig.testBucket_z0 + "_status_copy";
+
+        try {
+            bucketManager.deleteBucketLifecycleRule(TestConfig.testBucket_z0, ruleName);
+        } catch (QiniuException e) {
+            e.printStackTrace();
+        }
+
+        try {
+            bucketManager.copy(TestConfig.testBucket_z0, TestConfig.testKey_z0, TestConfig.testBucket_z0, copyKey, true);
+            bucketManager.changeType(TestConfig.testBucket_z0, copyKey, StorageType.Archive);
+            bucketManager.restoreArchive(TestConfig.testBucket_z0, copyKey, 1);
+            FileInfo info = bucketManager.stat(TestConfig.testBucket_z0, copyKey);
+            assertNotNull(info.hash);
+            assertNotNull(info.mimeType);
+            assertNotNull(info.restoreStatus);
+
+            bucketManager.delete(TestConfig.testBucket_z0, copyKey);
+            BucketLifeCycleRule rule = new BucketLifeCycleRule(ruleName, "");
+            rule.setToLineAfterDays(1);
+            rule.setToArchiveAfterDays(2);
+            rule.setToDeepArchiveAfterDays(3);
+            rule.setDeleteAfterDays(4);
+            bucketManager.putBucketLifecycleRule(TestConfig.testBucket_z0, rule);
+            bucketManager.copy(TestConfig.testBucket_z0, TestConfig.testKey_z0, TestConfig.testBucket_z0, copyKey, true);
+            bucketManager.deleteAfterDays(TestConfig.testBucket_z0, copyKey, 1);
+            info = bucketManager.stat(TestConfig.testBucket_z0, copyKey);
+            assertNotNull(info.hash);
+            assertNotNull(info.mimeType);
+            assertNotNull(info.expiration);
+//            assertNotNull(info.transitionToIA);
+//            assertNotNull(info.transitionToArchive);
+//            assertNotNull(info.transitionToDeepArchive);
+        } catch (QiniuException e) {
+            e.printStackTrace();
+            fail("status change type fail:" + e);
+        } finally {
+            try {
+                bucketManager.deleteBucketLifecycleRule(TestConfig.testBucket_z0, ruleName);
+            } catch (QiniuException e) {
+                e.printStackTrace();
+            }
+        }
+
+        try {
+            FileInfo info = bucketManager.stat(TestConfig.testBucket_z0, copyKey);
+            assertNotNull(info.hash);
+            assertNotNull(info.mimeType);
+            assertNotNull(info.expiration);
+        } catch (QiniuException e) {
+            fail("status fail:" + e);
+        }
+
         // test exists
         Map<String, String> bucketKeyMap = new HashMap<String, String>();
         bucketKeyMap.put(TestConfig.testBucket_z0, TestConfig.testKey_z0);