Merge pull request #136 from aliyun/releaseInfo

release 2.8.5 info

README-CN.md

@@ -16,14 +16,6 @@ OSS Android SDK依赖于[okhttp](https://github.com/square/okhttp)。
 
 在项目中使用时，您可以把下载得到的jar包引入工程，也可以通过maven依赖。
 
-### 直接引入jar包
-
-当您下载了OSS Android SDK的zip包后，进行以下步骤(对Android studio或者Eclipse都适用):
-
-* 在官网[点击查看](https://help.aliyun.com/document_detail/oss/sdk/sdk-download/android.html)下载sdk包
-* 解压后在libs目录下得到jar包，目前包括aliyun-oss-sdk-android-2.3.0.jar、okhttp-3.x.x.jar、okio-1.x.x.jar
-* 将以上3个jar包导入工程的libs目录
-
 ### 通过jcenter获取依赖
 
 ```
@@ -50,6 +42,11 @@ $ ./gradlew releaseJar
 $ cd build/libs && ls
 ```
 
+### 直接引入上面编译好的jar包
+
+* 首先进入到build/libs目录下得到jar包，目前包括aliyun-oss-sdk-android-2.8.5.jar、okhttp-3.x.x.jar、okio-1.x.x.jar
+* 将以上3个jar包导入工程的libs目录
+
 ### Javadoc
 
 [点击查看](http://aliyun.github.io/aliyun-oss-android-sdk/)

changelog.txt

@@ -15,7 +15,13 @@ http://www.aliyun.com
 Github地址：https://github.com/aliyun/aliyun-oss-android-sdk
 
 
-更新日志:
+更新日志:
+
+2018/08/09
+- release 2.8.5
+1.add api which named putSymlink;
+2.add api which named getSymlink;
+3.add api which named restoreObect;
 
 2018/07/06
 - release 2.8.4

oss-android-sdk/build.gradle

@@ -14,8 +14,8 @@ android {
     defaultConfig {
         minSdkVersion 14
         targetSdkVersion 25
-        versionCode 36
-        versionName "2.8.4"
+        versionCode 37
+        versionName "2.8.5"
     }
 
     buildTypes {

oss-android-sdk/src/main/java/com/alibaba/sdk/android/oss/OSS.java

@@ -332,7 +332,10 @@ public DeleteBucketResult deleteBucket(DeleteBucketRequest request)
      * Asynchronously get bucket info
      *
      * @param request
+     *             A {@link GetBucketInfoRequest} instance which specifies the bucket
+     *            name.
      * @param completedCallback
+     *            A {@link OSSCompletedCallback<GetBucketInfoRequest, GetBucketInfoResult>} instance that specifies callback functions
      * @return
      */
     public OSSAsyncTask<GetBucketInfoResult> asyncGetBucketInfo(
@@ -341,9 +344,10 @@ public OSSAsyncTask<GetBucketInfoResult> asyncGetBucketInfo(
     /**
      * Gets the Bucket's basic information as well as its ACL.
      *
-     * @param bucketName
-     *            The bucket name。
-     * @return A BucketInfo instance.
+     * @param request
+     *             A {@link GetBucketInfoRequest} instance which specifies the bucket
+     *            name.
+     * @return A {@link GetBucketInfoResult} instance.
      * @throws ClientException
      *             OSS Client side exception.
      * @throws ServiceException
@@ -682,16 +686,86 @@ public boolean doesObjectExist(String bucketName, String objectKey)
 
     public ImagePersistResult imagePersist(ImagePersistRequest request) throws ClientException, ServiceException;
 
+    /**
+     * Synchronously creates a symbol link to a target file under the bucket---this is not
+     * supported for archive class bucket.
+     *
+     * @param request
+     *            A {@link PutSymlinkRequest} instance that specifies the
+     *            bucket name, symlink name.
+     * @throws ClientException
+     *             OSS Client side exception.
+     * @throws ServiceException
+     *             OSS Server side exception.
+     * @return An instance of PutSymlinkResult
+     */
     public PutSymlinkResult putSymlink(PutSymlinkRequest request) throws ClientException, ServiceException;
 
+    /**
+     * Asynchronously creates a symbol link to a target file under the bucket---this is not
+     * supported for archive class bucket.
+     *
+     * @param request
+     *            A {@link PutSymlinkRequest} instance that specifies the
+     *            bucket name, symlink name.
+     * @param completedCallback
+     *            A {@link OSSCompletedCallback<PutSymlinkRequest, PutSymlinkResult>} instance that specifies callback functions
+     * @return A {@link OSSAsyncTask<PutSymlinkResult>} instance.
+     */
     public OSSAsyncTask<PutSymlinkResult> asyncPutSymlink(PutSymlinkRequest request, OSSCompletedCallback<PutSymlinkRequest, PutSymlinkResult> completedCallback);
 
+    /**
+     * Synchronously gets the symlink information for the given symlink name.
+     *
+     * @param request
+     *            A {@link GetSymlinkRequest} instance which specifies the bucket
+     *            name and symlink name.
+     * @return The symlink information, including the target file name and its
+     *         metadata.
+     * @throws ClientException
+     *             OSS Client side exception.
+     * @throws ServiceException
+     *             OSS Server side exception.
+     * @return A {@link GetSymlinkResult} instance.
+     */
     public GetSymlinkResult getSymlink(GetSymlinkRequest request) throws ClientException, ServiceException;
 
+    /**
+     * Asynchronously gets the symlink information for the given symlink name.
+     *
+     * @param request
+     *            A {@link GetSymlinkRequest} instance which specifies the bucket
+     *            name and symlink name.
+     * @param completedCallback
+     *            A {@link OSSCompletedCallback<GetSymlinkRequest, GetSymlinkResult>} instance that specifies callback functions
+     * @return A {@link OSSAsyncTask<GetSymlinkResult>} instance.
+     */
     public OSSAsyncTask<GetSymlinkResult> asyncGetSymlink(GetSymlinkRequest request, OSSCompletedCallback<GetSymlinkRequest, GetSymlinkResult> completedCallback);
 
+    /**
+     * Synchronously restores the object of archive storage. The function is not applicable to
+     * Normal or IA storage. The restoreObject() needs to be called prior to
+     * calling getObject() on an archive object.
+     *
+     * @param request
+     *            A {@link RestoreObjectRequest} instance that specifies the bucket
+     *            name and object key.
+     * @return A {@link RestoreObjectResult} instance.
+     */
     public RestoreObjectResult restoreObject(RestoreObjectRequest request) throws ClientException, ServiceException;
 
+    /**
+     * Asynchronously restores the object of archive storage. The function is not applicable to
+     * Normal or IA storage. The restoreObject() needs to be called prior to
+     * calling getObject() on an archive object.
+     *
+     * @param request
+     *            A {@link RestoreObjectRequest} instance that specifies the bucket
+     *            name and object key.
+     * @param completedCallback
+     *            A {@link OSSCompletedCallback<RestoreObjectRequest, RestoreObjectResult>} instance that specifies callback functions
+     * @return A {@link OSSAsyncTask<RestoreObjectResult>} instance.
+     */
     public OSSAsyncTask<RestoreObjectResult> asyncRestoreObject(RestoreObjectRequest request, OSSCompletedCallback<RestoreObjectRequest, RestoreObjectResult> completedCallback);
 
 }

oss-android-sdk/src/main/java/com/alibaba/sdk/android/oss/common/OSSConstants.java

@@ -5,7 +5,7 @@
  */
 public final class OSSConstants {
 
-    public static final String SDK_VERSION = "2.8.4";
+    public static final String SDK_VERSION = "2.8.5";
     public static final String DEFAULT_OSS_ENDPOINT = "http://oss-cn-hangzhou.aliyuncs.com";
 
     public static final String DEFAULT_CHARSET_NAME = "utf-8";

project.properties

@@ -2,7 +2,7 @@
 project.name=aliyun-oss-sdk-android
 project.groupId=com.aliyun.dpa
 project.artifactId=oss-android-sdk
-project.version=2.8.4
+project.version=2.8.5
 project.packaging=aar
 project.siteUrl=https://github.com/aliyun/aliyun-oss-android-sdk
 project.gitUrl=https://github.com/aliyun/aliyun-oss-android-sdk.git