com.iijgio.dag.services.storage.internal

Class ServiceUtils

java.lang.Object

com.iijgio.dag.services.storage.internal.ServiceUtils

public class ServiceUtils
extends Object

IIJ GIOストレージ＆アナリシスサービス SDK全体で使用する一般的なユーティリティ

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ServiceUtils.RetryableDownloadTask IIJ GIOストレージ＆アナリシスサービスから指定したファイルにダウンロードする タスク用のインターフェイス。インテグリティチェックがダウンロードしたファイルに関して 失敗した後に、一度だけリトライするメカニズムを有効にします。

Field Summary

Fields

Modifier and Type	Field and Description
protected static DateUtils	dateUtils

Constructor Summary

Constructors

Constructor and Description
ServiceUtils()

Method Summary

Modifier and Type	Method and Description
static URL	convertRequestToUrl(Request<?> request) 指定されたリクエストオブジェクトを、エンドポイント・パラメタなどから URLオブジェクトに変換します。
static void	downloadObjectToFile(StorageObject storageObject, File destinationFile, boolean performIntegrityCheck) IIJ GIOストレージ＆アナリシスサービスのオブジェクトを指定したファイルにしてダウンロードします。 Storage.getObject(com.iijgio.dag.services.storage.model.GetObjectRequest)から返されます。
static String	formatIso8601Date(Date date)
static String	formatRfc822Date(Date date)
static byte[]	fromBase64(String b64Data) Base64エンコードされた文字列をオリジナルのバイトデータへ変換します
static byte[]	fromHex(String hexData) Hex形式のデータ文字列をオリジナルのバイトデータへ変換します。
static boolean	isMultipartUploadETag(String eTag) 指定したETagがマルチパートアップロードから来たものであれば、trueを返します。
static String	join(List<String> strings) 指定された文字列の配列を結合し、カンマ区切りとして、一つの文字列として返します
static Date	parseIso8601Date(String dateString)
static Date	parseRfc822Date(String dateString)
static String	removeQuotes(String s) 指定された文字列の前後のクオート(")を削除し、新たな文字列として返します。
static StorageObject	retryableDownloadObjectToFile(File file, ServiceUtils.RetryableDownloadTask retryableDownloadTask) IIJ GIOストレージ＆アナリシスサービスに保存されたオブジェクトを取得し、 指定したファイルに保存してダウンロードします。 このメソッドは、インテグリティチェックがダウンロードしたファイルに対して失敗した後、 もう一度リトライするメカニズムを持っています。null値のオブジェクトを取得した後 直ちにそれを返します。(getObjectリクエストが指定した制約に合わなかった場合)
static String	toBase64(byte[] data) バイトデータをBase64エンコードされた文字列へ変換します
static byte[]	toByteArray(String s) 安全に文字列をバイト配列へ変換します。 まず、サポートするデフォルトエンコーディング(UTF-8)で変換を行い、何らかの理由で デフォルトエンコーディングがサポートされない場合は、システムのデフォルト エンコーディングへフォールバックします。
static String	urlEncode(String s) 指定された文字列をURLエンコードし、それを返します。 指定されたすべてのキーはURLエンコードが必要です。URLエンコードされたキーは サインする文字列で必要です(正規化されたリソースパス)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dateUtils

protected static final DateUtils dateUtils

Constructor Detail

ServiceUtils

public ServiceUtils()

Method Detail

parseIso8601Date

public static Date parseIso8601Date(String dateString)
                             throws ParseException

Throws:

ParseException

formatIso8601Date

public static String formatIso8601Date(Date date)

parseRfc822Date

public static Date parseRfc822Date(String dateString)
                            throws ParseException

Throws:

ParseException

formatRfc822Date

public static String formatRfc822Date(Date date)

isMultipartUploadETag

public static boolean isMultipartUploadETag(String eTag)

指定したETagがマルチパートアップロードから来たものであれば、trueを返します。

Parameters:

eTag - 検証するETag

Returns:

指定したETagがマルチパートアップロードから来たものであれば、true。 そうではなく、シングルパートのアップロードであるオブジェクトに属していればfalse。

fromHex

public static byte[] fromHex(String hexData)

Hex形式のデータ文字列をオリジナルのバイトデータへ変換します。

Parameters:

hexData - デコードするHex形式の文字列

Returns:

Hex形式の文字列からデコードされたデータ

toBase64

public static String toBase64(byte[] data)

バイトデータをBase64エンコードされた文字列へ変換します

Parameters:

data - Base64エンコードするデータ

Returns:

Base64エンコードされた文字列

fromBase64

public static byte[] fromBase64(String b64Data)

Base64エンコードされた文字列をオリジナルのバイトデータへ変換します

Parameters:

b64Data - デコードするBase64文字列

Returns:

Base64文字列からデコードされたバイトデータ

toByteArray

public static byte[] toByteArray(String s)

安全に文字列をバイト配列へ変換します。 まず、サポートするデフォルトエンコーディング(UTF-8)で変換を行い、何らかの理由で デフォルトエンコーディングがサポートされない場合は、システムのデフォルト エンコーディングへフォールバックします。

Parameters:

s - バイト配列に変換する文字列

Returns:

指定された文字列を変換したバイト配列

removeQuotes

public static String removeQuotes(String s)

指定された文字列の前後のクオート(")を削除し、新たな文字列として返します。

Parameters:

s - 前後のクオートをチェックする文字列

Returns:

指定された文字列から前後のクオートを削除された新規文字列

convertRequestToUrl

public static URL convertRequestToUrl(Request<?> request)

指定されたリクエストオブジェクトを、エンドポイント・パラメタなどから URLオブジェクトに変換します。

Parameters:

request - URLに変換するリクエストオブジェクト

Returns:

指定されたリクエストで定義されているURL

Throws:

IIJGIOClientException - リクエストがURLに変換できない場合

urlEncode

public static String urlEncode(String s)

指定された文字列をURLエンコードし、それを返します。 指定されたすべてのキーはURLエンコードが必要です。URLエンコードされたキーは サインする文字列で必要です(正規化されたリソースパス)

Parameters:

s - URLエンコードする文字列

Returns:

新たなURLエンコードされた文字列

join

public static String join(List<String> strings)

指定された文字列の配列を結合し、カンマ区切りとして、一つの文字列として返します

Parameters:

strings - カンマ区切り文字列として結合する文字列の配列

Returns:

文字列の配列を結合し、カンマ区切りとした新規文字列

downloadObjectToFile

public static void downloadObjectToFile(StorageObject storageObject,
                                        File destinationFile,
                                        boolean performIntegrityCheck)

IIJ GIOストレージ＆アナリシスサービスのオブジェクトを指定したファイルにしてダウンロードします。 Storage.getObject(com.iijgio.dag.services.storage.model.GetObjectRequest)から返されます。

Parameters:

storageObject - オブジェクトのデータを含む入力ストリームへの参照を持つ IIJ GIOストレージ＆アナリシスサービスのオブジェクト

destinationFile - オブジェクトのデータを格納するファイル

performIntegrityCheck - インテグリティチェックを行うかどうかを示すブール値

retryableDownloadObjectToFile

public static StorageObject retryableDownloadObjectToFile(File file,
                                                          ServiceUtils.RetryableDownloadTask retryableDownloadTask)

IIJ GIOストレージ＆アナリシスサービスに保存されたオブジェクトを取得し、 指定したファイルに保存してダウンロードします。 このメソッドは、インテグリティチェックがダウンロードしたファイルに対して失敗した後、 もう一度リトライするメカニズムを持っています。null値のオブジェクトを取得した後 直ちにそれを返します。(getObjectリクエストが指定した制約に合わなかった場合)

Parameters:

file - オブジェクトを保存するファイル

retryableDownloadTask - このメソッドに対して、ユーザが呼び出すサイトで可視である全ての変数へアクセスすることを許可する ServiceUtils.RetryableDownloadTaskインターフェイスの実装

Returns:

対象のオブジェクト