Object Storage Service：OSS Java SDK快速入門

前提條件

• 已註冊阿里雲帳號。

• 已開通OSS服務。

• 已建立有OSS系統管理權限的RAM使用者AccessKey。

  使用ROS指令碼快速建立有OSS系統管理權限的RAM使用者AccessKey

  在Resource Orchestration Service控制台的建立資源棧頁面的安全確認下，勾選確認，然後單擊建立。

  

  建立完成後，在輸出中，複製建立的AccessKey。

  

配置憑證

使用RAM使用者AccessKey配置環境變數。

安裝SDK

1. 已安裝Java 7 及以上版本。

   通過以下命令查看Java版本。

   java -version

   如果當前計算環境沒有Java或版本低於Java 7，請下載Java。

2. 安裝OSS Java SDK。

   在pom.xml中添加以下依賴。

   <dependency>
       <groupId>com.aliyun.oss</groupId>
       <artifactId>aliyun-sdk-oss</artifactId>
       <version>3.17.4</version>
   </dependency>

   如果使用的是Java 9及以上的版本，則需要添加以下JAXB相關依賴。

   <dependency>
       <groupId>javax.xml.bind</groupId>
       <artifactId>jaxb-api</artifactId>
       <version>2.3.1</version>
   </dependency>
   <dependency>
       <groupId>javax.activation</groupId>
       <artifactId>activation</artifactId>
       <version>1.1.1</version>
   </dependency>
   <!-- no more than 2.3.3-->
   <dependency>
       <groupId>org.glassfish.jaxb</groupId>
       <artifactId>jaxb-runtime</artifactId>
       <version>2.3.3</version>
   </dependency>

運行樣本

運行以下程式碼範例以體驗OSS的完整使用流程：建立一個Bucket、上傳檔案、下載檔案、列舉檔案以及刪除檔案和Bucket。

import java.io.*;
import java.util.Random;
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
import com.aliyun.oss.model.OSSObject;
import com.aliyun.oss.model.ObjectListing;
import com.aliyun.oss.model.OSSObjectSummary;

public class OssJavaSdkQuickStart {
    /** 產生一個唯一的 Bucket 名稱 */
    public static String generateUniqueBucketName(String prefix) {
        // 擷取目前時間戳
        String timestamp = String.valueOf(System.currentTimeMillis());
        // 產生一個 0 到 9999 之間的隨機數
        Random random = new Random();
        int randomNum = random.nextInt(10000); // 產生一個 0 到 9999 之間的隨機數
        // 串連以形成一個唯一的 Bucket 名稱
        return prefix + "-" + timestamp + "-" + randomNum;
    }

    public static void main(String[] args) throws com.aliyuncs.exceptions.ClientException {
        // 設定 OSS Endpoint 和 Bucket 名稱
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        String bucketName = generateUniqueBucketName("demo");
        // 替換為您的 Bucket 地區
        String region = "cn-hangzhou";
        // 建立 OSSClient 執行個體
        EnvironmentVariableCredentialsProvider credentialsProvider =
                CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .region(region)
                .build();
        try {
            // 1. 建立儲存空間（Bucket）
            ossClient.createBucket(bucketName);
            System.out.println("1. Bucket " + bucketName + " 建立成功。");
            // 2. 上傳檔案
            String objectName = "exampledir/exampleobject.txt";
            String content = "Hello OSS";
            ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(content.getBytes()));
            System.out.println("2. 檔案 " + objectName + " 上傳成功。");
            // 3. 下載檔案
            OSSObject ossObject = ossClient.getObject(bucketName, objectName);
            InputStream contentStream = ossObject.getObjectContent();
            BufferedReader reader = new BufferedReader(new InputStreamReader(contentStream));
            String line;
            System.out.println("3. 下載的檔案內容：");
            while ((line = reader.readLine()) != null) {
                System.out.println(line);
            }
            contentStream.close();
            // 4. 列出檔案
            System.out.println("4. 列出 Bucket 中的檔案：");
            ObjectListing objectListing = ossClient.listObjects(bucketName);
            for (OSSObjectSummary objectSummary : objectListing.getObjectSummaries()) {
                System.out.println(" - " + objectSummary.getKey() + " (大小 = " + objectSummary.getSize() + ")");
            }
            // 5. 刪除檔案
            ossClient.deleteObject(bucketName, objectName);
            System.out.println("5. 檔案 " + objectName + " 刪除成功。");
            // 6. 刪除儲存空間（Bucket）
            ossClient.deleteBucket(bucketName);
            System.out.println("6. Bucket " + bucketName + " 刪除成功。");
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException | IOException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

成功的返回樣本如下：

1. Bucket demo-1731651903982-4074 建立成功。
2. 檔案 exampledir/exampleobject.txt 上傳成功。
3. 下載的檔案內容：
Hello OSS
4. 列出 Bucket 中的檔案：
 - exampledir/exampleobject.txt (大小 = 9)
5. 檔案 exampledir/exampleobject.txt 刪除成功。
6. Bucket demo-1731651903982-4074 刪除成功。