java.lang.Object
- org.springframework.util.unit.DataSize

所有已实现的接口:
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.
Term Data Size Size in Bytes
byte 1B 1
kilobyte 1KB 1,024
megabyte 1MB 1,048,576
gigabyte 1GB 1,073,741,824
terabyte 1TB 1,099,511,627,776
从以下版本开始:
5.1
作者:
Stephane Nicoll, Sam Brannen
另请参阅:
DataUnit, 序列化表格

方法概要

所有方法静态方法实例方法具体方法
修饰符和类型	方法	说明
`int`	`compareTo(DataSize other)`
`boolean`	`equals(Object other)`
`int`	`hashCode()`
`boolean`	`isNegative()`	Checks if this size is negative, excluding zero.
`static DataSize`	`of(long amount, DataUnit unit)`	Obtain a `DataSize` representing an amount in the specified `DataUnit`.
`static DataSize`	`ofBytes(long bytes)`	Obtain a `DataSize` representing the specified number of bytes.
`static DataSize`	`ofGigabytes(long gigabytes)`	Obtain a `DataSize` representing the specified number of gigabytes.
`static DataSize`	`ofKilobytes(long kilobytes)`	Obtain a `DataSize` representing the specified number of kilobytes.
`static DataSize`	`ofMegabytes(long megabytes)`	Obtain a `DataSize` representing the specified number of megabytes.
`static DataSize`	`ofTerabytes(long terabytes)`	Obtain a `DataSize` representing the specified number of terabytes.
`static DataSize`	`parse(CharSequence text)`	Obtain a `DataSize` from a text string such as `12MB` using `DataUnit.BYTES` if no unit is specified.
`static DataSize`	`parse(CharSequence text, DataUnit defaultUnit)`	Obtain a `DataSize` from a text string such as `12MB` using the specified default `DataUnit` if no unit is specified.
`long`	`toBytes()`	Return the number of bytes in this instance.
`long`	`toGigabytes()`	Return the number of gigabytes in this instance.
`long`	`toKilobytes()`	Return the number of kilobytes in this instance.
`long`	`toMegabytes()`	Return the number of megabytes in this instance.
`String`	`toString()`
`long`	`toTerabytes()`	Return the number of terabytes in this instance.

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 方法详细资料
  - ofBytes
```
public static DataSize ofBytes(long bytes)
```
    Obtain a DataSize representing the specified number of bytes.
    参数:
    bytes - the number of bytes, positive or negative
    返回:
    a DataSize
  - ofKilobytes
```
public static DataSize ofKilobytes(long kilobytes)
```
    Obtain a DataSize representing the specified number of kilobytes.
    参数:
    kilobytes - the number of kilobytes, positive or negative
    返回:
    a DataSize
  - ofMegabytes
```
public static DataSize ofMegabytes(long megabytes)
```
    Obtain a DataSize representing the specified number of megabytes.
    参数:
    megabytes - the number of megabytes, positive or negative
    返回:
    a DataSize
  - ofGigabytes
```
public static DataSize ofGigabytes(long gigabytes)
```
    Obtain a DataSize representing the specified number of gigabytes.
    参数:
    gigabytes - the number of gigabytes, positive or negative
    返回:
    a DataSize
  - ofTerabytes
```
public static DataSize ofTerabytes(long terabytes)
```
    Obtain a DataSize representing the specified number of terabytes.
    参数:
    terabytes - the number of terabytes, positive or negative
    返回:
    a DataSize
  - of
```
public static DataSize of(long amount,
                          DataUnit unit)
```
    Obtain a DataSize representing an amount in the specified DataUnit.
    参数:
    amount - the amount of the size, measured in terms of the unit, positive or negative
    返回:
    a corresponding DataSize
  - parse
```
public static DataSize parse(CharSequence text)
```
    Obtain a DataSize from a text string such as 12MB using DataUnit.BYTES if no unit is specified.
    Examples:
    "12KB" -- parses as "12 kilobytes" "5MB" -- parses as "5 megabytes" "20" -- parses as "20 bytes"
    参数:
    text - the text to parse
    返回:
    the parsed DataSize
    另请参阅:
    parse(CharSequence, DataUnit)
  - parse
```
public static DataSize parse(CharSequence text,
                             @Nullable
                             DataUnit defaultUnit)
```
    Obtain a DataSize from a text string such as 12MB 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.
    Examples:
    "12KB" -- parses as "12 kilobytes" "5MB" -- parses as "5 megabytes" "20" -- parses as "20 kilobytes" (where the defaultUnit is DataUnit.KILOBYTES)
    参数:
    text - the text to parse
    返回:
    the parsed DataSize
  - isNegative
```
public boolean isNegative()
```
    Checks if this size is negative, excluding zero.
    返回:
    true if this size has a size less than zero bytes
  - toBytes
```
public long toBytes()
```
    Return the number of bytes in this instance.
    返回:
    the number of bytes
  - toKilobytes
```
public long toKilobytes()
```
    Return the number of kilobytes in this instance.
    返回:
    the number of kilobytes
  - toMegabytes
```
public long toMegabytes()
```
    Return the number of megabytes in this instance.
    返回:
    the number of megabytes
  - toGigabytes
```
public long toGigabytes()
```
    Return the number of gigabytes in this instance.
    返回:
    the number of gigabytes
  - toTerabytes
```
public long toTerabytes()
```
    Return the number of terabytes in this instance.
    返回:
    the number of terabytes
  - compareTo
```
public int compareTo(DataSize other)
```
    指定者:
    compareTo 在接口中 Comparable<DataSize>
  - toString
```
public String toString()
```
    覆盖:
    toString 在类中 Object
  - equals
```
public boolean equals(@Nullable
                      Object other)
```
    覆盖:
    equals 在类中 Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    hashCode 在类中 Object

Term	Data Size	Size in Bytes
byte	1B	1
kilobyte	1KB	1,024
megabyte	1MB	1,048,576
gigabyte	1GB	1,073,741,824
terabyte	1TB	1,099,511,627,776

类 DataSize

方法概要

从类继承的方法 java.lang.Object

方法详细资料

ofBytes

ofKilobytes

ofMegabytes

ofGigabytes

ofTerabytes

of

parse

parse

isNegative

toBytes

toKilobytes

toMegabytes

toGigabytes

toTerabytes

compareTo

toString

equals

hashCode