软链接功能用于便捷访问Bucket内的常用Object。设置软链接后,您可以使用类似于Windows的快捷方式,通过软链接文件打开Object。
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见如何初始化Android端OSSClient实例。
创建软链接
以下代码用于创建软链接:
// 构建请求。
PutSymlinkRequest putSymlink = new PutSymlinkRequest();
// 填写Bucket名称。
putSymlink.setBucketName("yourBucketName");
// 设置软链接名称。
putSymlink.setObjectKey("yourSymLink");
// 指定软链接指向的目标Object名称。
putSymlink.setTargetObjectName("yourTargetObjectName");
ObjectMetadata metadata = new ObjectMetadata();
// 设置是否禁止覆盖同名Object。此处设置为true,表示禁止覆盖同名Object。
//metadata.setHeader("x-oss-forbid-overwrite", "true");
// 指定Object的访问权限。此处设置为private,表示私有权限。
//metadata.setHeader("x-oss-object-acl", "private");
// 指定Object存储类型。此处设置为Standard,表示标准存储。
//metadata.setHeader("x-oss-storage-class", "Standard");
putSymlink.setMetadata(metadata);
OSSAsyncTask task = oss.asyncPutSymlink(putSymlink, new OSSCompletedCallback<PutSymlinkRequest, PutSymlinkResult>() {
@Override
public void onSuccess(PutSymlinkRequest request, PutSymlinkResult result) {
Log.d("PutSymlink", "PutSymlink success");
}
@Override
public void onFailure(PutSymlinkRequest request, ClientException clientException,
ServiceException serviceException) {
// 请求异常。
if (clientException != null) {
// 客户端异常,例如网络异常等。
clientException.printStackTrace();
}
if (serviceException != null) {
// 服务端异常。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
task.waitUntilFinished();
获取软链接指向的目标文件名称
获取软链接要求您对该软链接有读权限。以下代码用于获取软链接指向的目标文件名称:
// 构建请求。
GetSymlinkRequest getSymlink = new GetSymlinkRequest();
// 填写Bucket名称。
getSymlink.setBucketName("yourBucketName");
// 填写软链接名称。
getSymlink.setObjectKey("yourSymLink");
OSSAsyncTask task = oss.asyncGetSymlink(getSymlink, new OSSCompletedCallback<GetSymlinkRequest,
GetSymlinkResult>() {
@Override
public void onSuccess(GetSymlinkRequest request, GetSymlinkResult result) {
OSSLog.logInfo("targ::"+result.getTargetObjectName());
}
@Override
public void onFailure(GetSymlinkRequest request, ClientException clientException,
ServiceException serviceException) {
OSSLog.logError("error: "+serviceException.getRawMessage());
}
});
task.waitUntilFinished();
相关文档
关于软链接的完整示例代码,请参见GitHub示例。
关于创建软链接的API接口说明,请参见PutSymlink。
关于获取软链接的API接口说明,请参见GetSymlink。
关于初始化OSSClient,请参见如何初始化Android端OSSClient实例。