org.jets3t.service.utils
Class ByteFormatter

java.lang.Object
  extended by org.jets3t.service.utils.ByteFormatter

public class ByteFormatter
extends java.lang.Object

Formats numeric byte values into human-readable strings.


Constructor Summary
ByteFormatter()
          Constructs a formatter that will use default text to represent byte amounts.
ByteFormatter(java.lang.String gigabyteSuffix, java.lang.String megabyteSuffix, java.lang.String kilobyteSuffix, java.lang.String byteSuffix, int decimalPlaces)
          Constructs a formatter that will use the given values when formatting byte values.
 
Method Summary
 java.lang.String formatByteSize(long byteSize)
          Converts a byte size into a human-readable string, such as "1.43 MB" or "27 KB".
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ByteFormatter

public ByteFormatter()
Constructs a formatter that will use default text to represent byte amounts. Default values used:


ByteFormatter

public ByteFormatter(java.lang.String gigabyteSuffix,
                     java.lang.String megabyteSuffix,
                     java.lang.String kilobyteSuffix,
                     java.lang.String byteSuffix,
                     int decimalPlaces)
Constructs a formatter that will use the given values when formatting byte values.

Parameters:
gigabyteSuffix - string to display at the end of gigabyte values.
megabyteSuffix - string to display at the end of megabyte values.
kilobyteSuffix - string to display at the end of kilobyte values.
byteSuffix - string to display at the end of byte values.
decimalPlaces - the number of decimal places to use when converting byte amounts into kilo, mega or giga byte values.
Method Detail

formatByteSize

public java.lang.String formatByteSize(long byteSize)
Converts a byte size into a human-readable string, such as "1.43 MB" or "27 KB". The values used are based on powers of 1024, ie 1 KB = 1024 bytes, not 1000 bytes.

Parameters:
byteSize - the byte size of some item
Returns:
a human-readable description of the byte size