org.jets3t.service.utils

Class ByteFormatter

java.lang.Object

org.jets3t.service.utils.ByteFormatter

public class ByteFormatter
extends java.lang.Object

Formats numeric byte values into human-readable strings.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	byteSuffix
private java.lang.String	gigabyteSuffix
private java.lang.String	kilobyteSuffix
private static org.apache.commons.logging.Log	log
private java.lang.String	megabyteSuffix
private javax.swing.text.NumberFormatter	nf

Constructor Summary

Constructors

Constructor and Description
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

Modifier and Type	Method and Description
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

Field Detail

log

private static final org.apache.commons.logging.Log log

gigabyteSuffix

private java.lang.String gigabyteSuffix

megabyteSuffix

private java.lang.String megabyteSuffix

kilobyteSuffix

private java.lang.String kilobyteSuffix

byteSuffix

private java.lang.String byteSuffix

nf

private javax.swing.text.NumberFormatter nf

Constructor Detail

ByteFormatter

public ByteFormatter()

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

• Gigabyte suffix: " GB"
• Megabyte suffix: " MB"
• Kilobyte suffix: " KB"
• Byte suffix: " B"
• Precision: 2 decimal places

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