Package org.springframework.util.unit

Class DataSize

java.lang.Object
org.springframework.util.unit.DataSize
All Implemented Interfaces:
Serializable, Comparable<DataSize>
public final class DataSize extends Object implements Comparable<DataSize>, Serializable
A data size, such as '12MB'. This class models data size in terms of bytes and is immutable and thread-safe.

The terms and units used in this class are based on binary prefixes indicating multiplication by powers of 2. Consult the following table and the Javadoc for DataUnit for details.

TermData SizeSize in Bytes
byte1B1
kilobyte1KB1,024
megabyte1MB1,048,576
gigabyte1GB1,073,741,824
terabyte1TB1,099,511,627,776
Since:
5.1
Author:
Stephane Nicoll, Sam Brannen
See Also:

  • Method Details

    • ofBytes

      public static DataSize ofBytes(long bytes)
      Obtain a DataSize representing the specified number of bytes.
      Parameters:
      bytes - the number of bytes, positive or negative
      Returns:
      a DataSize

    • ofKilobytes

      public static DataSize ofKilobytes(long kilobytes)
      Obtain a DataSize representing the specified number of kilobytes.
      Parameters:
      kilobytes - the number of kilobytes, positive or negative
      Returns:
      a DataSize

    • ofMegabytes

      public static DataSize ofMegabytes(long megabytes)
      Obtain a DataSize representing the specified number of megabytes.
      Parameters:
      megabytes - the number of megabytes, positive or negative
      Returns:
      a DataSize

    • ofGigabytes

      public static DataSize ofGigabytes(long gigabytes)
      Obtain a DataSize representing the specified number of gigabytes.
      Parameters:
      gigabytes - the number of gigabytes, positive or negative
      Returns:
      a DataSize

    • ofTerabytes

      public static DataSize ofTerabytes(long terabytes)
      Obtain a DataSize representing the specified number of terabytes.
      Parameters:
      terabytes - the number of terabytes, positive or negative
      Returns:
      a DataSize

    • of

      public static DataSize of(long amount, DataUnit unit)
      Obtain a DataSize representing an amount in the specified DataUnit.
      Parameters:
      amount - the amount of the size, measured in terms of the unit, positive or negative
      Returns:
      a corresponding DataSize

    • parse

      public static DataSize parse(CharSequence text)
      Obtain a DataSize from a text string such as "5MB" using DataUnit.BYTES if no unit is specified.

      Examples

      TextParsed AsSize in Bytes
      "20"20 bytes20
      "20B"20 bytes20
      "12KB"12 kilobytes12,288
      "5MB"5 megabytes5,242,880

      Note that the terms and units used in the above examples are based on binary prefixes. Consult the class-level Javadoc for details.

      Parameters:
      text - the text to parse
      Returns:
      the parsed DataSize
      See Also:

    • parse

      public static DataSize parse(CharSequence text, @Nullable DataUnit defaultUnit)
      Obtain a DataSize from a text string such as "5MB" using the specified default DataUnit if no unit is specified.

      The string starts with a number followed optionally by a unit matching one of the supported suffixes.

      If neither a unit nor a default DataUnit is specified, DataUnit.BYTES will be inferred.

      Examples

      TextDefault UnitParsed AsSize in Bytes
      "20"null20 bytes20
      "20"KILOBYTES20 kilobytes20,480
      "20B"N/A20 bytes20
      "12KB"N/A12 kilobytes12,288
      "5MB"N/A5 megabytes5,242,880

      Note that the terms and units used in the above examples are based on binary prefixes. Consult the class-level Javadoc for details.

      Parameters:
      text - the text to parse
      defaultUnit - the default DataUnit to use
      Returns:
      the parsed DataSize

    • isNegative

      public boolean isNegative()
      Checks if this size is negative, excluding zero.
      Returns:
      true if this size has a size less than zero bytes

    • toBytes

      public long toBytes()
      Return the number of bytes in this instance.
      Returns:
      the number of bytes

    • toKilobytes

      public long toKilobytes()
      Return the number of kilobytes in this instance.
      Returns:
      the number of kilobytes

    • toMegabytes

      public long toMegabytes()
      Return the number of megabytes in this instance.
      Returns:
      the number of megabytes

    • toGigabytes

      public long toGigabytes()
      Return the number of gigabytes in this instance.
      Returns:
      the number of gigabytes

    • toTerabytes

      public long toTerabytes()
      Return the number of terabytes in this instance.
      Returns:
      the number of terabytes

    • compareTo

      public int compareTo(DataSize other)
      Specified by:
      compareTo in interface Comparable<DataSize>

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(@Nullable Object other)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object