HTMLフォームを使用して、最大5 GBのサイズのオブジェクトをバケットにアップロードできます。 このアップロード方法は、フォームアップロードと呼ばれます。 このトピックでは、Object Storage Service (OSS) でフォームアップロードを実行する方法について説明します。
使用上の注意
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSecurity Token Service (STS) を使用してOSSClientインスタンスを作成する場合は、「OSSClientインスタンスの作成」をご参照ください。
フォームのアップロードを実行するには、
oss:PutObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
例
次のサンプルコードは、フォームのアップロードを実行する方法の例を示します。
impor t com.aliyun.oss.com mon.utils.BinaryUtil;
com.aliyun.oss.int ernal.OSSUtilsをインポートします。com.aliyun.oss.mo del.Callbackをインポートします。impor t org.apache.com mons.codec.binary.Base64;
javax.activation.MimetypesFileTypeMapをインポートします。java.io.* をインポートします。impor t java.net.HttpURLConnection;
impor t java.net.URL;
java.util.Iteratorをインポートします。java.util.LinkedHashMapをインポートします。java.util.Mapをインポートします。com.aliyun.oss.ClientExceptionをインポートします。public class PostObjectSample {
// アップロードするローカルファイルのフルパスを指定します。
プライベート文字列localFilePath = "yourLocalFile";
// この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。
private String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// Alibaba CloudアカウントのAccessKeyペアには、すべてのAPI操作に対する権限があります。 これらの資格情報を使用してOSSで操作を実行することは、リスクの高い操作です。 RAMユーザーを使用してAPI操作を呼び出したり、ルーチンのO&Mを実行することを推奨します。RAMユーザーを作成するには、RAMコンソールにログインします。
文字列accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
文字列accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
プライベート文字列bucketName = "yourBucketName";
// オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。
プライベート文字列objectName = "yourObjectName";
// コールバック要求を送信するサーバーのURLを指定します。 例: http://oss-demo.oss-cn-hangzhou.aliyuncs.com:23450またはhttp:// 127.0.0.1:9090
プライベート文字列callbackServerUrl = "yourCallbackServerUrl";
// コールバック要求のHostヘッダーを指定します。 例: oss-cn-hangzhou.aliyuncs.com。
プライベート文字列callbackServerHost = "yourCallbackServerHost";
/**
* フォームのアップロードを実行します。
* @throws Exception
*/
private void PostObject() throws Exception {
// Add the bucket name to the URL. The URL format is http://yourBucketName.oss-cn-hangzhou.aliyuncs.com.
文字列urlStr = endpoint.replace("http://", "http://" + bucketName + ".");
// フォームのMapを指定します。
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);
// コールバック要求に含まれるbodyフィールドの値を指定します。
// callback.setCallbackBody("{\\\" mimeType \\\ ":${ mimeType },\\\" size \\\ ":${ size}}");
// コールバック要求でContent-Typeを指定します。
// callback.setCalbackBodyType(Callback.CalbackBodyType.JSON);
// コールバック要求のカスタムパラメータを指定します。 各カスタムパラメータは、キーと値のペアで構成されます。 キーはx: で始まり、小文字でなければなりません。
// callback.addCallbackVar("x:var1", "value1");
// callback.addCallbackVar("x:var2", "value2");
// フォームのMapでコールバックパラメーターを指定します。
// 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());
// フォームのすべてのMapデータを再帰的に読み取り、そのデータを出力ストリームに書き込みます。
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;
} 最後に{
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> エントリ: varMap.entrySet()) {
formFields.put(entry.getKey(), entry.getValue());
}
}
}
}
public static void main(String[] args) throws Exception {
PostObjectSample ossPostObject = new PostObjectSample();
ossPostObject.PostObject();
}
}参考資料
フォームアップロードを実行するために呼び出すことができるAPI操作の詳細については、「PostObject」をご参照ください。