クラス DataSize

java.lang.ObjectSE
org.springframework.util.unit.DataSize
実装されているすべてのインターフェース:
SerializableSE, ComparableSE<DataSize>
public final class DataSize extends ObjectSE implements ComparableSE<DataSize>, SerializableSE
データサイズ (例: '12MB')。このクラスはデータサイズをバイト単位でモデル化し、不変かつスレッドセーフです。

このクラスで使用される用語と単位は、2 の累乗による乗算を示すバイナリプレフィックスに基づいています。詳細については、次の表と DataUnit の Javadoc を参照してください。

期間 データサイズ バイト単位のサイズ
バイト 1B1
キロバイト 1KB1,024
メガバイト 1MB1,048,576
ギガバイト 1GB1,073,741,824
テラバイト 1TB1,099,511,627,776
導入:
5.1
作成者:
Stephane Nicoll, Sam Brannen
関連事項:

  • メソッドの詳細

    • ofBytes

      public static DataSize ofBytes(long bytes)
      指定されたバイト数を表す DataSize を取得します。
      パラメーター:
      bytes - 正または負のバイト数
      戻り値:
      DataSize

    • ofKilobytes

      public static DataSize ofKilobytes(long kilobytes)
      指定されたキロバイト数を表す DataSize を取得します。
      パラメーター:
      kilobytes - 正または負のキロバイト数
      戻り値:
      DataSize

    • ofMegabytes

      public static DataSize ofMegabytes(long megabytes)
      指定されたメガバイト数を表す DataSize を取得します。
      パラメーター:
      megabytes - 正または負のメガバイト数
      戻り値:
      DataSize

    • ofGigabytes

      public static DataSize ofGigabytes(long gigabytes)
      指定されたギガバイト数を表す DataSize を取得します。
      パラメーター:
      gigabytes - 正または負のギガバイト数
      戻り値:
      DataSize

    • ofTerabytes

      public static DataSize ofTerabytes(long terabytes)
      指定されたテラバイト数を表す DataSize を取得します。
      パラメーター:
      terabytes - 正または負のテラバイト数
      戻り値:
      DataSize

    • of

      public static DataSize of(long amount, DataUnit unit)
      指定された DataUnit の金額を表す DataSize を取得します。
      パラメーター:
      amount - 正または負の単位で測定されたサイズの量
      戻り値:
      対応する DataSize

    • parse

      public static DataSize parse(CharSequenceSE text)
      単位が指定されていない場合は、DataUnit.BYTES を使用して "5MB" などのテキスト文字列から DataSize を取得します。

      Examples

      テキスト 解析対象 バイト単位のサイズ
      "20"20 バイト 20
      "20B"20 バイト 20
      "12KB"12 キロバイト 12,288
      "5MB"5 メガバイト 5,242,880

      上記の例で使用されている用語と単位は、2 進接頭辞に基づいていることに注意してください。詳細については、クラスレベルの Javadoc を参照してください。

      パラメーター:
      text - 解析するテキスト
      戻り値:
      解析された DataSize
      関連事項:

    • parse

      public static DataSize parse(CharSequenceSE text, @Nullable DataUnit defaultUnit)
      単位が指定されていない場合は、指定されたデフォルトの DataUnit を使用して、"5MB" などのテキスト文字列から DataSize を取得します。

      文字列は数字で始まり、オプションで、サポートされている接尾辞の 1 つに一致する単位が続きます。

      ユニットもデフォルトの DataUnit も指定されていない場合は、DataUnit.BYTES が推論されます。

      Examples

      テキスト デフォルトの単位 解析対象 バイト単位のサイズ
      "20"null20 バイト 20
      "20"KILOBYTES20 キロバイト 20,480
      "20B" なし 20 バイト 20
      "12KB" なし 12 キロバイト 12,288
      "5MB" なし 5 メガバイト 5,242,880

      上記の例で使用されている用語と単位は、2 進接頭辞に基づいていることに注意してください。詳細については、クラスレベルの Javadoc を参照してください。

      パラメーター:
      text - 解析するテキスト
      defaultUnit - 使用するデフォルトの DataUnit 
      戻り値:
      解析された DataSize

    • isNegative

      public boolean isNegative()
      ゼロを除いて、このサイズが負かどうかを確認します。
      戻り値:
      このサイズのサイズが 0 バイト未満の場合は true

    • toBytes

      public long toBytes()
      このインスタンスのバイト数を返します。
      戻り値:
      バイト数

    • toKilobytes

      public long toKilobytes()
      このインスタンスのキロバイト数を返します。
      戻り値:
      キロバイト数

    • toMegabytes

      public long toMegabytes()
      このインスタンスのメガバイト数を返します。
      戻り値:
      メガバイト数

    • toGigabytes

      public long toGigabytes()
      このインスタンスのギガバイト数を返します。
      戻り値:
      ギガバイト数

    • toTerabytes

      public long toTerabytes()
      このインスタンスのテラバイト数を返します。
      戻り値:
      テラバイトの数

    • compareTo

      public int compareTo(DataSize other)
      次で指定:
      インターフェース ComparableSE<DataSize> の compareToSE 

    • toString

      public StringSE toString()
      オーバーライド:
      クラス ObjectSE の toString 

    • equals

      public boolean equals(@Nullable ObjectSE other)
      オーバーライド:
      クラス ObjectSE の equalsSE 

    • hashCode

      public int hashCode()
      オーバーライド:
      クラス ObjectSE の hashCode