Object Storage Service:初期化 (Android SDK)

OSSClient の初期化

OSSClient は、次のいずれかの方法で作成できます。

OSSClient の設定

ClientConfiguration は OSSClient の設定クラスです。このクラスを使用して、プロキシ、接続タイムアウト、最大接続数などのパラメーターを設定できます。

次のコードは、ClientConfiguration を使用して OSSClient パラメーターを設定する方法を示しています。

// yourEndpoint を、バケットが配置されているリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
String endpoint = "yourEndpoint";
// STS サービスから取得した一時的な AccessKey ID と AccessKey Secret。
String accessKeyId = "yourAccessKeyId";
String accessKeySecret = "yourAccessKeySecret";
// STS サービスから取得したセキュリティトークン。
String securityToken = "yourSecurityToken";
// region を、バケットが配置されているリージョンに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。
String region = "yourRegion";

ClientConfiguration configuration = new ClientConfiguration();
// 同時リクエストの最大数を設定します。デフォルト値：5。
// configuration.setMaxConcurrentRequest(3);
// ソケットレイヤーでのデータ転送のタイムアウト期間を設定します。デフォルト値：60 秒。
// configuration.setSocketTimeout(50000);
// 接続確立のタイムアウト期間を設定します。デフォルト値：60 秒。
// configuration.setConnectionTimeout(50000);
// ログファイルのサイズを設定します。デフォルト値：5 MB。
// configuration.setMaxLogSize(3 * 1024 * 1024);
// リクエストが失敗した後の最大リトライ回数を設定します。デフォルト値：2。
// configuration.setMaxErrorRetry(3);
// リスト内の要素は CNAME 解析をスキップします。
// List<String> cnameExcludeList = new ArrayList<>();
// cnameExcludeList.add("cname");
// configuration.setCustomCnameExcludeList(cnameExcludeList);
// プロキシサーバーのホストアドレス。
// configuration.setProxyHost("yourProxyHost");
// プロキシサーバーのポート。
// configuration.setProxyPort(8080);
// ユーザーエージェント内の HTTP の User-Agent ヘッダー。
// configuration.setUserAgentMark("yourUserAgent");
// 巡回冗長検査 (CRC) を有効にするかどうかを指定します。デフォルト値：false。
// configuration.setCheckCRC64(true);
// HTTP リダイレクトを有効にするかどうかを指定します。デフォルト値：false。
// configuration.setFollowRedirectsEnable(true);
// カスタム OkHttpClient を設定します。
// OkHttpClient.Builder builder = new OkHttpClient.Builder();
// configuration.setOkHttpClient(builder.build());

OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(accessKeyId, accessKeySecret, securityToken);
configuration.setSignVersion(SignVersion.V4);
// OSSClient インスタンスを作成します。
OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
oss.setRegion(region);

ログ記録の有効化

モバイル端末の環境は複雑です。OSS SDK は、一部のリージョンや特定の期間に正しく動作しない場合があります。開発者が問題を特定しやすくするために、OSS SDK はログ記録機能が有効になった後、ログ情報をローカルに記録します。ログ記録を有効にするには、OSSClient を使用する前に初期化する必要があります。次のようにメソッドを呼び出します。

// ログスタイル。
// OSSLog.enableLog() を呼び出して、コンソールでログを表示できるようにします。
// ログファイルを携帯電話の内蔵 SD カードの \OSSLog\logs.csv パスに書き込むことができます。これはデフォルトで無効になっています。
// ログには、OSS 操作のリクエストデータ、レスポンスデータ、例外情報が記録されます。
// たとえば、requestId やレスポンスヘッダーなどです。
// 以下はログレコードのサンプルです。
// Android バージョン。
// android_version: 5.1  
// Android 携帯電話のモデル。
// mobile_model: XT1085
// ネットワークステータス。  
// network_state: connected
// ネットワーク接続タイプ。
// network_type: WIFI 
// 特定の操作動作情報。
// [2017-09-05 16:54:52] - Encounter local execpiton: //java.lang.IllegalArgumentException: The bucket name is invalid. 
// バケット名は次の要件を満たす必要があります： 
// 1) 小文字、数字、またはダッシュ (-) で構成されていること。 
// 2) 小文字または数字で始まること。 
// 3) 長さが 3 ～ 63 文字であること。 
//------>ログの終わり
// このメソッドを呼び出してログ記録を有効にします。
OSSLog.enableLog();              

同期インターフェイスと非同期インターフェイス