org.springframework.util.unit

Class DataSize

java.lang.Object

org.springframework.util.unit.DataSize

All Implemented Interfaces:

java.lang.Comparable<DataSize>

public final class DataSize
extends java.lang.Object
implements java.lang.Comparable<DataSize>

A data size, such as '12MB'.

This class models a size in terms of bytes and is immutable and thread-safe.

Since:

5.1

Author:

Stephane Nicoll

Field Summary

Fields

Modifier and Type	Field and Description
private long	bytes
private static long	BYTES_PER_GB Bytes per GigaByte.
private static long	BYTES_PER_KB Bytes per KiloByte.
private static long	BYTES_PER_MB Bytes per MegaByte.
private static long	BYTES_PER_TB Bytes per TeraByte.
private static java.util.regex.Pattern	PATTERN The pattern for parsing.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	DataSize(long bytes)

Method Summary

Modifier and Type	Method and Description
int	compareTo(DataSize other)
private static DataUnit	determineDataUnit(java.lang.String suffix, DataUnit defaultUnit)
boolean	equals(java.lang.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(java.lang.CharSequence text) Obtain a DataSize from a text string such as 12MB using DataUnit.BYTES if no unit is specified.
static DataSize	parse(java.lang.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.
java.lang.String	toString()
long	toTeraBytes() Return the number of terabytes in this instance.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

PATTERN

private static final java.util.regex.Pattern PATTERN

The pattern for parsing.

BYTES_PER_KB

private static long BYTES_PER_KB

Bytes per KiloByte.

BYTES_PER_MB

private static long BYTES_PER_MB

Bytes per MegaByte.

BYTES_PER_GB

private static long BYTES_PER_GB

Bytes per GigaByte.

BYTES_PER_TB

private static long BYTES_PER_TB

Bytes per TeraByte.

bytes

private final long bytes

Constructor Detail

DataSize

private DataSize(long bytes)

Method Detail

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(java.lang.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"
 

Parameters:

text - the text to parse

Returns:

the parsed DataSize

See Also:

parse(CharSequence, DataUnit)

parse

public static DataSize parse(java.lang.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)
 

Parameters:

text - the text to parse

Returns:

the parsed DataSize

determineDataUnit

private static DataUnit determineDataUnit(java.lang.String suffix,
                                          @Nullable
                                          DataUnit defaultUnit)

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 java.lang.Comparable<DataSize>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object