Utility クラス
- java.
lang. Object - com.
microsoft. azure. storage. core. Utility
- com.
public class Utility
内部使用のために予約されています。 ユーティリティ メソッドを提供するクラス。
フィールドの概要
修飾子と型 | フィールドと説明 |
---|---|
final TimeZone |
GMT_ZONE
GMT タイム ゾーンへの参照を格納します。 |
final Locale |
LOCALE_US
米国ロケールへの参照を格納します。 |
final TimeZone |
UTC_ZONE
UTC タイム ゾーンへの参照を格納します。 |
メソッドの概要
フィールドの詳細
GMT_ZONE
public static final TimeZone GMT_ZONE= TimeZone.getTimeZone("GMT")
GMT タイム ゾーンへの参照を格納します。
LOCALE_US
public static final Locale LOCALE_US= Locale.US
米国ロケールへの参照を格納します。
UTC_ZONE
public static final TimeZone UTC_ZONE= TimeZone.getTimeZone("UTC")
UTC タイム ゾーンへの参照を格納します。
メソッドの詳細
analyzeStream
public static StreamMd5AndLength analyzeStream(final InputStream sourceStream, long writeLength, long abandonLength, final boolean rewindSourceStream, final boolean calculateMD5)
入力ストリームのサイズを決定し、必要に応じてストリームの MD5 ハッシュを計算します。
Parameters:
InputStream
測定するストリームを表す オブジェクト。
-1
読み取る場合は、この値を に設定します。 このパラメーターは、アップロードのしきい値をサポートするために提供されます。
true
ストリームを読み取った後に巻き戻す必要がある場合は 。それ以外の場合は false
。
true
MD5 ハッシュが計算される場合は 。それ以外の場合は false
。
Returns:
Throws:
assertContinuationType
public static void assertContinuationType(final ResultContinuation continuationToken, final ResultContinuationType continuationType)
継続トークンが指定した型であることをアサートします。
Parameters:
assertGreaterThanOrEqual
public static void assertGreaterThanOrEqual(final String param, final long value, final long min)
指定した値が最小値以上であることをアサートします。
Parameters:
String
パラメーターの名前を表す 。 パラメーターが範囲外の場合value
は例外メッセージ テキストになります。
assertInBounds
public static void assertInBounds(final String param, final long value, final long min, final long max)
指定した整数が有効な範囲内にあることをアサートします。
Parameters:
String
パラメーターの名前を表す 。 パラメーターが範囲外の場合value
は例外メッセージ テキストになります。
assertNotNull
public static void assertNotNull(final String param, final Object value)
値が ではないことをアサートします。
Parameters:
String
パラメーターの名前を表す 。 パラメーターが の場合value
null
は例外メッセージ テキストになります。
Object
指定したパラメーターの値を表す オブジェクト。 これは、 ではなく null
としてアサートされる値です。
assertNotNullOrEmpty
public static void assertNotNullOrEmpty(final String param, final String value)
指定した文字列が空でないことをアサートします。
Parameters:
String
パラメーターの名前を表す 。パラメーターが または空の文字列の場合はvalue
null
例外メッセージ テキストになります。
String
指定したパラメーターの値を表す 。 これは、空の文字列ではなくとして null
アサートされる値です。
binaryAppend
public static byte [] binaryAppend(byte[] arr1, byte[] arr2)
2 バイト配列を追加します。
Parameters:
Returns:
checkNullaryCtor
public static void checkNullaryCtor(Class> clazzType)
Parameters:
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(StringWriter outWriter)
指定した を持つ を返します。
Parameters:
StringWriter
インスタンスの作成に使用する XMLStreamWriter
。
Returns:
XMLStreamWriter
のインスタンスThrows:
determinePathStyleFromUri
public static boolean determinePathStyleFromUri(final URI baseURI)
指定した URI がパス スタイルの URI かどうかを示す値を返します。
Parameters:
java.net.URI
チェック対象の URI を表す値。
Returns:
true
指定した URI がパス スタイルの場合は 。それ以外の場合は false
。
encryptStreamIfUnderThreshold
public static long encryptStreamIfUnderThreshold(final InputStream sourceStream, final ByteArrayOutputStream targetStream, Cipher cipher, long writeLength, long abandonLength)
指定した長さまでの入力ストリームを暗号化します。 暗号化されたデータが破棄の長さよりも長い場合は、早期に終了します。
Parameters:
InputStream
測定するストリームを表す オブジェクト。
ByteArrayOutputStream
暗号化されたデータを書き込むストリームを表す オブジェクト。
Cipher
データの暗号化に使用する 。
-1
読み取る場合は、この値を に設定します。 このパラメーターは、アップロードのしきい値をサポートするために提供されます。
Returns:
Throws:
findAllPatternOccurences
public static List
パターンのすべての出現箇所についてバイト配列をスキャンします。出現スパンは重複しません。
Parameters:
Returns:
findPattern
public static int findPattern(byte[] array, byte[] pattern, int scanOffset)
指定されたオフセットから始めて、パターンの最初の出現箇所をバイト配列でスキャンします。
Parameters:
Returns:
formatETag
public static String formatETag(final String etag)
XML ストリーム リーダーから Etag 要素の文字データを読み取ります。
Parameters:
Returns:
String
Etag 要素の文字データを表す 。generateNewUnexpectedStorageException
public static StorageException generateNewUnexpectedStorageException(final Exception cause)
予期しないストレージ例外を返します。
Parameters:
Exception
予期しないエラーの原因となった最初の例外を表す オブジェクト。
Returns:
getGMTTime
public static String getGMTTime()
RFC1123 パターンを使用して、現在の GMT 日付/時刻文字列を返します。
Returns:
String
RFC1123 パターンを使用して現在の GMT 日付/時刻を表す 。getGMTTime
public static String getGMTTime(final Date date)
RFC1123 パターンを使用して、指定した値の GTM 日付/時刻文字列を返します。
Parameters:
Date
RFC1123 パターンで GMT の日付/時刻に変換する日付を表す オブジェクト。
Returns:
String
RFC1123 パターンを使用して、指定した値の GMT 日付/時刻を表す 。getJavaISO8601Time
public static String getJavaISO8601Time(Date date)
Java のバージョンの ISO8601 パターンを使用して、指定された値の UTC 日付/時刻文字列を返します。これはミリ秒単位の精度に制限されています。
Parameters:
Date
Java のバージョンの ISO8601 パターンで UTC 日付/時刻に変換する日付を表す オブジェクト。
Returns:
String
Java のバージョンの ISO8601 パターンを使用して、指定した値の UTC 日付/時刻を表す 。getJsonGenerator
public static JsonGenerator getJsonGenerator(OutputStream outStream)
指定した を持つ を返します。
Parameters:
OutputStream
インスタンスの作成に使用する JsonGenerator
。
Returns:
JsonGenerator
のインスタンスThrows:
getJsonGenerator
public static JsonGenerator getJsonGenerator(StringWriter strWriter)
指定した を持つ を返します。
Parameters:
StringWriter
インスタンスの作成に使用する JsonGenerator
。
Returns:
JsonGenerator
のインスタンスThrows:
getJsonParser
public static JsonParser getJsonParser(final InputStream inStream)
指定した を持つ を返します。 この JsonParser では、数値以外の数値を使用できます。
Parameters:
InputStream
インスタンスの作成に使用する JsonGenerator
。
Returns:
JsonGenerator
のインスタンス。Throws:
getJsonParser
public static JsonParser getJsonParser(final String jsonString)
指定した を持つ を返します。 この JsonParser では、数値以外の数値を使用できます。
Parameters:
String
インスタンスの作成に使用する JsonGenerator
。
Returns:
JsonGenerator
のインスタンス。Throws:
getListingLocationMode
public static RequestLocationMode getListingLocationMode(ResultContinuation token)
継続トークンを調べることで、リスト コマンドのターゲットとなる場所を決定します。
Parameters:
Returns:
getRemainingTimeout
public static int getRemainingTimeout(Long operationExpiryTimeInMs, Integer timeoutIntervalInMs)
操作の有効期限が切れるまでの残りの時間を表す値を返します。
Parameters:
Returns:
Throws:
getSAXParser
public static SAXParser getSAXParser()
名前空間を認識する を返します。
Returns:
SAXParser
名前空間に対応するインスタンスThrows:
getStandardHeaderValue
public static String getStandardHeaderValue(final HttpURLConnection conn, final String headerName)
指定した接続要求から標準ヘッダー値を返します。要求にヘッダー値が指定されていない場合は空の文字列を返します。
Parameters:
HttpURLConnection
要求を表す オブジェクト。
String
要求されるヘッダーの名前を表す 。
Returns:
String
ヘッダー値null
を表す 。 に対応するヘッダー値headerName
がない場合は 。getUTCTimeOrEmpty
public static String getUTCTimeOrEmpty(final Date value)
ISO8601 パターンを使用して、指定した値の UTC 日付/時刻を返します。
Parameters:
Date
ISO8601 パターンで UTC 日付/時刻に変換する日付を表す オブジェクト。 この値が の場合、このメソッドは null
空の文字列を返します。
Returns:
String
ISO8601 パターンを使用して指定した値の UTC 日付/時刻を表す 。 が の場合value
はnull
空の文字列。initIOException
public static IOException initIOException(final Exception ex)
指定した例外を使用して、 クラスのインスタンスを作成します。
Parameters:
Exception
IO 例外の作成に使用される例外を表す オブジェクト。
Returns:
java.io.IOException
作成された IO 例外を表す オブジェクト。isNullOrEmpty
public static boolean isNullOrEmpty(final String value)
指定した文字列が空かどうかを示す値を返します。
Parameters:
String
検査対象または空の null
。
Returns:
true
指定した値がまたは空の場合は 。それ以外の場合は null
。 false
isNullOrEmptyOrWhitespace
public static boolean isNullOrEmptyOrWhitespace(final String value)
指定した文字列が 、空、または空白であるかどうかを示す値を返します。
Parameters:
String
、空、または空白についてnull
調べられている 。
Returns:
true
指定した値が 、空、または空白の場合は 。それ以外の場合は null
。 false
logHttpError
public static void logHttpError(StorageException ex, OperationContext opContext)
解析された StorageException をシリアル化します。 例外が発生した場合は、空の文字列を返します。
Parameters:
logHttpRequest
public static void logHttpRequest(HttpURLConnection conn, OperationContext opContext)
HttpURLConnection 要求をログに記録します。 例外が発生した場合、何もログに記録されません。
Parameters:
logHttpResponse
public static void logHttpResponse(HttpURLConnection conn, OperationContext opContext)
HttpURLConnection 応答をログに記録します。 例外が発生した場合、何もログに記録されません。
Parameters:
parseAccountString
public static HashMap
接続文字列を解析し、その値をキーと値のペアのハッシュ マップとして返します。
Parameters:
String
解析する接続文字列を表す 。
Returns:
java.util.HashMap
接続文字列から解析されたキーと値のペアのハッシュ マップを表す オブジェクト。parseDate
public static Date parseDate(String dateString)
ISO8601 パターンの形式で日付を表す文字列型 (String) の場合、最大ミリ秒の精度で日付を表す Date が生成されます。
Parameters:
String
解釈される を指定します。 Date
Returns:
Date
オブジェクトparseDate
public static Date parseDate(String dateString, boolean dateBackwardCompatibility)
ISO8601 パターンの形式で日付を表す文字列型 (String) の場合、最大ミリ秒の精度で日付を表す Date が生成されます。 必要な場合を除き、代わりに を使用 parseDate(String dateString) します。
詳細については、こちらを参照してください。
Parameters:
String
解釈される を指定します。 Date
true
2.0.0 より前のバージョンのこのライブラリを使用して書き込まれた可能性がある日付の値を修正する。それ以外の場合は false
Returns:
Date
オブジェクトparseRFC1123DateFromStringInGMT
public static Date parseRFC1123DateFromStringInGMT(final String value)
RFC1123 パターンで指定された文字列の GMT 日付を返します。
Parameters:
String
解析する文字列を表す 。
Returns:
Date
RFC1123 パターンの GMT 日付を表す オブジェクト。Throws:
safeDecode
public static String safeDecode(final String stringToDecode)
指定した文字列をスペース文字に置き換えるのではなく、各文字を保持するように注意して、指定した文字列の安全なデコードを実行します。
Parameters:
String
デコードする文字列を表す 。
Returns:
String
デコードされた文字列を表す 。Throws:
safeEncode
public static String safeEncode(final String stringToEncode)
指定した文字列の安全なエンコードを実行します。文字を挿入するのではなく、スペース文字ごとに挿入するように注意してください。
Parameters:
String
エンコードする文字列を表す 。
Returns:
String
エンコードされた文字列を表す 。Throws:
safeRelativize
public static String safeRelativize(final URI baseURI, final URI toUri)
指定した 2 つの URI の相対差を決定します。
Parameters:
java.net.URI
相対にされるベース URI をtoUri
表す オブジェクト。
java.net.URI
を基準baseURI
にして作成する URI を表す オブジェクト。
Returns:
String
と のホスト名とスキームが同じbaseURI
toUri
かどうかに応じて、 の相対 URI toUri
baseURI
を表す 。それ自体の toUri
URI を表す 。 と toUri
のホスト名とスキームが同一のbaseURI
場合、このメソッドは、 にbaseURI
追加された場合に が生成toUri
されるように、エンコードされていない相対 URI を返します。 と toUri
のbaseURI
ホスト名またはスキームが同一でない場合、このメソッドは によってtoUri
指定されたエンコードされていない完全 URI を返します。Throws:
toUri
が無効な場合baseURI
。
splitOnPattern
public static List
Parameters:
stringJoin
public static String stringJoin(CharSequence delimiter, final String... strings)
Java 8 の String.join() に相当します。
Parameters:
Returns:
stringJoin
public static String stringJoin(CharSequence delimiter, Iterable
Java 8 の String.join() に相当します。
Parameters:
Returns:
trimEnd
protected static String trimEnd(final String value, final char trimChar)
指定した文字を文字列の末尾からトリミングします。
Parameters:
String
トリミングする文字列を表す 。
Returns:
trimStart
public static String trimStart(final String value)
文字列の先頭から空白文字をトリミングします。
Parameters:
String
トリミングする文字列を表す 。
Returns:
validateMaxExecutionTimeout
public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs)
最大実行時間を超えるかどうかを表す値を返します。
Parameters:
Returns:
true
最大実行時間を超える場合は 。それ以外の場合は false
。
validateMaxExecutionTimeout
public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs, long additionalInterval)
最大実行時間を超えるかどうかを表す値を返します。
Parameters:
Returns:
true
最大実行時間を超える場合は 。それ以外の場合は false
。
writeToOutputStream
public static StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options)
入力ストリームからデータを読み取り、出力ストリームに書き込み、書き込まれたデータの長さを計算し、必要に応じてデータの MD5 ハッシュを計算します。
Parameters:
InputStream
ソースとして使用する入力ストリームを表す オブジェクト。
OutputStream
変換先として使用する出力ストリームを表す オブジェクト。
true
入力ストリームを読み取る 前に 巻き戻す必要がある場合は 。それ以外の場合は false
true
MD5 ハッシュが計算される場合は 。それ以外の場合は false
。
Returns:
Throws:
writeToOutputStream
public static StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options, final Boolean shouldFlush)
入力ストリームからデータを読み取り、出力ストリームに書き込み、書き込まれたデータの長さを計算し、必要に応じてデータの MD5 ハッシュを計算します。
Parameters:
InputStream
ソースとして使用する入力ストリームを表す オブジェクト。
OutputStream
変換先として使用する出力ストリームを表す オブジェクト。
true
入力ストリームを読み取る 前に 巻き戻す必要がある場合は 。それ以外の場合は false
true
MD5 ハッシュが計算される場合は 。それ以外の場合は false
。
Returns:
Throws:
writeToOutputStream
public static StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options, final Boolean shouldFlush, StorageRequest, ?, Integer> request, StreamMd5AndLength descriptor)
入力ストリームからデータを読み取り、出力ストリームに書き込み、書き込まれたデータの長さを計算し、必要に応じてデータの MD5 ハッシュを計算します。
Parameters:
InputStream
ソースとして使用する入力ストリームを表す オブジェクト。
OutputStream
変換先として使用する出力ストリームを表す オブジェクト。
true
入力ストリームを読み取る 前に 巻き戻す必要がある場合は 。それ以外の場合は false
true
MD5 ハッシュが計算される場合は 。それ以外の場合は false
。
Returns:
Throws:
適用対象
Azure SDK for Java