1.控制台操作
首先介紹一下阿里雲OSS對象存儲的一些基本概念。
1.1 進入對象存儲界面
登錄阿里雲賬號,進入對象存儲界面,如圖所示。
進入后如圖所示。
1.2 OSS基本概念
這里不過多介紹如何在阿里雲上傳下載文件,這些操作基本上點一點都能找到。
1.2.1 Bucket
Bucket實質就是阿里雲OSS對象存儲的一個存儲空間,按照計算機理解的話可以理解為一個磁盤(不知道這樣比喻是否恰當)。
創建桶的過程很簡單,如圖所示,填寫對應內容即可。
這里需要注意,不同分區的Endpoint是不同的,Endpoint在后續API使用過程中會用到。至於存儲類型和讀寫權限相關設置,都結合自身情況來使用,這里以標准存儲和私有權限為例進行介紹。
1.2.2 AccessKey
AccessKey是訪問阿里雲API的秘鑰,這里也需要提前創建一份,創建后我們需要記住自己的AccessKey ID和Access Key Secret,如果忘記可以在如圖位置查詢。
2 API使用
2.1 API地址
一般使用對象存儲無非就是上傳和下載文件,完整API地址如下:
https://help.aliyun.com/document_detail/32015.html?spm=5176.8466032.bucket-object.1.33ac1450TuX65y
2.2 API使用准備
Java使用很簡單,直接在Maven中引用依賴,如下:
<dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>2.8.3</version> </dependency>
2.3 構建OSSClient實例
這里就需要用到我們上面提到的endpoint和AccessKey,構建實例內容如下所示。
// Endpoint以杭州為例,其它Region請按實際情況填寫。 String endpoint = "http://oss-cn-beijing.aliyuncs.com"; // 使用剛剛創建的accessKeyId和accessKeySecret String accessKeyId = "<yourAccessKeyId>"; String accessKeySecret = "<yourAccessKeySecret>"; // 創建OSSClient實例。 OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret); //todo 對OSS進行操作 // 關閉OSSClient。 ossClient.shutdown();
2.4 上傳文件
上傳文件常用的方式大致為兩種,一種是返回可以查看文件的地址,另外一種是通過地址可以直接下載文件。
2.4.1 上傳文件,返回可以預覽圖片的地址
上傳文件有一些需要注意的地方:
- 1.文件名不要重復,不然會覆蓋。
- 2.建議將不同日期的文件分別創建一個文件夾方便區分。
這里先以上傳本地桌面的一個圖片為例,上傳后在Bucket內自動創建日期格式yyyyMMdd的文件夾存放文件,文件名按照當前時間戳加隨機數的形式拼接,由於返回的URL是帶有簽名信息的,所以這里暫時設置過期時間為一小時,如果需要可以將時間加長。
完整內容如下所示:
import com.aliyun.oss.OSSClient; import java.io.File; import java.net.URL; import java.security.SecureRandom; import java.text.SimpleDateFormat; import java.util.Date; public class AliyunUpload { public static void main(String[] args) { SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd"); String endpoint = "http://oss-cn-beijing.aliyuncs.com"; String accessKeyId = "LTAIRr3alAhROGTA"; String accessKeySecret = "******"; String fileName = "/Users/dalaoyang/Desktop/aliyun.jpeg"; String bucketName = "dalaoyang-test"; // 獲取文件的后綴名 String suffixName = fileName.substring(fileName.lastIndexOf(".")); // 生成上傳文件名 String finalFileName = System.currentTimeMillis() + "" + new SecureRandom().nextInt(0x0400) + suffixName; String objectName = sdf.format(new Date()) + "/" + finalFileName; File file = new File(fileName); OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret); ossClient.putObject(bucketName, objectName, file); // 設置URL過期時間為1小時。 Date expiration = new Date(System.currentTimeMillis() + 3600 * 1000); // 生成以GET方法訪問的簽名URL,訪客可以直接通過瀏覽器訪問相關內容。 URL url = ossClient.generatePresignedUrl(bucketName, objectName, expiration); ossClient.shutdown(); System.out.println(url.toString()); } }
返回地址格式如下:
http://dalaoyang-test.oss-cn-beijing.aliyuncs.com/20190518/1558155342968407.jpeg?Expires=1558158948&OSSAccessKeyId=LTAIRr3alAhROGTA&Signature=%2BIjVpD%2BTWrRmSt4kU7axo6Cnqbw%3D
瀏覽器訪問如圖所示:
在阿里雲OSS中查看如圖所示,可以看到文件夾也對應的創建了。

2.4.2 上傳文件,返回可以直接下載圖片的地址
這個和上面其實類似,如果需要返回可以直接下載的地址的話,只要設置一下文件的contentDisposition為attachment;即可,完整內容如下:
import com.aliyun.oss.OSSClient; import com.aliyun.oss.model.ObjectMetadata; import java.io.File; import java.net.URL; import java.security.SecureRandom; import java.text.SimpleDateFormat; import java.util.Date; public class AliyunUpload { public static void main(String[] args) { SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd"); String endpoint = "http://oss-cn-beijing.aliyuncs.com"; String accessKeyId = "LTAIRr3alAhROGTA"; String accessKeySecret = "******"; String fileName = "/Users/dalaoyang/Desktop/WechatIMG4.png"; String bucketName = "dalaoyang-test"; // 獲取文件的后綴名 String suffixName = fileName.substring(fileName.lastIndexOf(".")); // 生成上傳文件名 String finalFileName = System.currentTimeMillis() + "" + new SecureRandom().nextInt(0x0400) + suffixName; String objectName = sdf.format(new Date()) + "/" + finalFileName; File file = new File(fileName); ObjectMetadata meta = new ObjectMetadata(); meta.setContentDisposition("attachment;"); OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret); ossClient.putObject(bucketName, objectName, file, meta); // 設置URL過期時間為1小時。 Date expiration = new Date(System.currentTimeMillis() + 3600 * 1000); // 生成以GET方法訪問的簽名URL,訪客可以直接通過瀏覽器訪問相關內容。 URL url = ossClient.generatePresignedUrl(bucketName, objectName, expiration); ossClient.shutdown(); System.out.println(url.toString()); } }
這次返回的地址在瀏覽器訪問直接下載下來了文件。
3 小結
對於阿里雲OSS操作還是有很多玩法的,比如上傳下載帶進度條,分段上傳等等,需要的話可以根據場景去玩。