フォームアップロードは、HTML フォームを使用して指定されたバケットにオブジェクトをアップロードするメソッドです。最大ファイルサイズは 5 GB です。
注意事項
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、内部エンドポイントを使用します。サポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する場合は、「一般的なシナリオの設定例」をご参照ください。
フォームアップロードを実行するには、
oss:PutObject権限が必要です。詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。
サンプルコード
次のサンプルコードは、フォームアップロードの実行方法を示します。
import com.aliyun.oss.common.utils.BinaryUtil;
import com.aliyun.oss.internal.OSSUtils;
import com.aliyun.oss.model.Callback;
import org.apache.commons.codec.binary.Base64;
import javax.activation.MimetypesFileTypeMap;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.Map;
import com.aliyun.oss.ClientException;
public class PostObjectSample {
// アップロードするローカルファイルの完全なパスを指定します。
private String localFilePath = "yourLocalFile";
// 中国 (杭州) リージョンのエンドポイントを例として使用します。実際のエンドポイントを指定してください。
private String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// Alibaba Cloud アカウントの AccessKey ペアは、すべての API 操作に対する権限を持っています。AccessKey ペアの使用はリスクの高い操作です。Resource Access Management (RAM) ユーザーを使用して API 操作を呼び出すか、日常の O&M を実行することを推奨します。RAM ユーザーを作成するには、RAM コンソールにログインします。
String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");
// バケット名を指定します。
private String bucketName = "yourBucketName";
// オブジェクトの完全なパスを指定します。バケット名は含めないでください。
private String objectName = "yourObjectName";
// コールバックサーバーの URL を設定します。例：http://oss-demo.oss-cn-hangzhou.aliyuncs.com:23450 または http://127.0.0.1:9090。
private String callbackServerUrl = "yourCallbackServerUrl";
// コールバックリクエストの Host ヘッダーの値を設定します。例：oss-cn-hangzhou.aliyuncs.com。
private String callbackServerHost = "yourCallbackServerHost";
/**
* フォームアップロード。
* @throws Exception
*/
private void PostObject() throws Exception {
// URL にバケット名を追加します。URL のフォーマットは http://yourBucketName.oss-cn-hangzhou.aliyuncs.com です。
String urlStr = endpoint.replace("http://", "http://" + bucketName+ ".");
// フォームマップを設定します。
Map<String, String> formFields = new LinkedHashMap<String, String>();
// オブジェクト名を設定します。
formFields.put("key", this.objectName);
// Content-Disposition を設定します。
formFields.put("Content-Disposition", "attachment;filename="
+ localFilePath);
// コールバックパラメーターを設定します。
// Callback callback = new Callback();
// コールバックサーバーの URL を設定します。例：http://oss-demo.oss-cn-hangzhou.aliyuncs.com:23450 または http://127.0.0.1:9090。
// callback.setCallbackUrl(callbackServerUrl);
// コールバックリクエストの Host ヘッダーの値を設定します (例: oss-cn-hangzhou.aliyuncs.com)。
// callback.setCallbackHost(callbackServerHost);
// コールバックのリクエストボディの値を設定します。
// callback.setCallbackBody("{\\\"mimeType\\\":${mimeType},\\\"size\\\":${size}}");
// コールバックリクエストの Content-Type を設定します。
// callback.setCalbackBodyType(Callback.CalbackBodyType.JSON);
// コールバックリクエストのカスタムパラメーターを設定します。各パラメーターはキーと値のペアです。キーは x: で始まり、小文字である必要があります。
// callback.addCallbackVar("x:var1", "value1");
// callback.addCallbackVar("x:var2", "value2");
// フォームマップにコールバックパラメーターを設定します。
// setCallBack(formFields, callback);
// OSSAccessKeyId を設定します。
formFields.put("OSSAccessKeyId", accessKeyId);
String policy = "{\"expiration\": \"2120-01-01T12:00:00.000Z\",\"conditions\": [[\"content-length-range\", 0, 104857600]]}";
String encodePolicy = new String(Base64.encodeBase64(policy.getBytes()));
// ポリシーを設定します。
formFields.put("policy", encodePolicy);
// 署名を生成します。
String signaturecom = com.aliyun.oss.common.auth.ServiceSignature.create().computeSignature(accessKeySecret, encodePolicy);
// 署名を設定します。
formFields.put("Signature", signaturecom);
String ret = formUpload(urlStr, formFields, localFilePath);
System.out.println("Post Object [" + this.objectName + "] to bucket [" + bucketName + "]");
System.out.println("post reponse:" + ret);
}
private static String formUpload(String urlStr, Map<String, String> formFields, String localFile)
throws Exception {
String res = "";
HttpURLConnection conn = null;
String boundary = "9431149156168";
try {
URL url = new URL(urlStr);
conn = (HttpURLConnection) url.openConnection();
conn.setConnectTimeout(5000);
conn.setReadTimeout(30000);
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setRequestMethod("POST");
conn.setRequestProperty("User-Agent",
"Mozilla/5.0 (Windows; U; Windows NT 6.1; zh-CN; rv:1.9.2.6)");
conn.setRequestProperty("Content-Type",
"multipart/form-data; boundary=" + boundary);
OutputStream out = new DataOutputStream(conn.getOutputStream());
// フォームマップを走査し、データを読み取り、出力ストリームにデータを書き込みます。
if (formFields != null) {
StringBuffer strBuf = new StringBuffer();
Iterator<Map.Entry<String, String>> iter = formFields.entrySet().iterator();
int i = 0;
while (iter.hasNext()) {
Map.Entry<String, String> entry = iter.next();
String inputName = entry.getKey();
String inputValue = entry.getValue();
if (inputValue == null) {
continue;
}
if (i == 0) {
strBuf.append("--").append(boundary).append("\r\n");
strBuf.append("Content-Disposition: form-data; name=\""
+ inputName + "\"\r\n\r\n");
strBuf.append(inputValue);
} else {
strBuf.append("\r\n").append("--").append(boundary).append("\r\n");
strBuf.append("Content-Disposition: form-data; name=\""
+ inputName + "\"\r\n\r\n");
strBuf.append(inputValue);
}
i++;
}
out.write(strBuf.toString().getBytes());
}
// ファイル情報を読み取り、アップロードするファイルを出力ストリームに書き込みます。
File file = new File(localFile);
String filename = file.getName();
String contentType = new MimetypesFileTypeMap().getContentType(file);
if (contentType == null || contentType.equals("")) {
contentType = "application/octet-stream";
}
StringBuffer strBuf = new StringBuffer();
strBuf.append("\r\n").append("--").append(boundary)
.append("\r\n");
strBuf.append("Content-Disposition: form-data; name=\"file\"; "
+ "filename=\"" + filename + "\"\r\n");
strBuf.append("Content-Type: " + contentType + "\r\n\r\n");
out.write(strBuf.toString().getBytes());
DataInputStream in = new DataInputStream(new FileInputStream(file));
int bytes = 0;
byte[] bufferOut = new byte[1024];
while ((bytes = in.read(bufferOut)) != -1) {
out.write(bufferOut, 0, bytes);
}
in.close();
byte[] endData = ("\r\n--" + boundary + "--\r\n").getBytes();
out.write(endData);
out.flush();
out.close();
// 返されたデータを読み取ります。
strBuf = new StringBuffer();
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line = null;
while ((line = reader.readLine()) != null) {
strBuf.append(line).append("\n");
}
res = strBuf.toString();
reader.close();
reader = null;
} catch (ClientException e) {
System.err.println("Send post request exception: " + e);
System.err.println(e.getErrorCode()+" msg="+e.getMessage());
throw e;
} finally {
if (conn != null) {
conn.disconnect();
conn = null;
}
}
return res;
}
private static void setCallBack(Map<String, String> formFields, Callback callback) {
if (callback != null) {
String jsonCb = OSSUtils.jsonizeCallback(callback);
String base64Cb = BinaryUtil.toBase64String(jsonCb.getBytes());
formFields.put("callback", base64Cb);
if (callback.hasCallbackVar()) {
Map<String, String> varMap = callback.getCallbackVar();
for (Map.Entry<String, String> entry : varMap.entrySet()) {
formFields.put(entry.getKey(), entry.getValue());
}
}
}
}
public static void main(String[] args) throws Exception {
PostObjectSample ossPostObject = new PostObjectSample();
ossPostObject.PostObject();
}
}関連ドキュメント
フォームアップロードの API 操作の詳細については、「PostObject」をご参照ください。