すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:フォームアップロード

最終更新日:Dec 15, 2023

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」をご参照ください。