lazyj
Class Format

java.lang.Object
  lazyj.Format

public final class Format
extends java.lang.Object

Utility class providing lots of useful or less useful functions.

Since:

2006-10-13

Author:

costing

Constructor Summary

Format()

Method Summary

static java.lang.String	byteToHex(byte val) Get the 2 hexa digit representation of this byte
static java.lang.String	decode(java.lang.String text) Decode an URL-encoded string, using the UTF-8 charset.
static java.lang.String	encode(java.lang.String text) Produce an URL encoding of the given text, using the UTF-8 charset
static java.lang.String	escHtml(java.lang.String text) Transform a text into an HTML-safe string.
static java.lang.String	escJS(java.lang.String text) Create a JS-safe string representation.
static java.lang.String	escSQL(java.lang.String text) Create a SQL-safe version of the given text, to be embedded into SQL queries
static java.lang.String	extractAddress(java.lang.String address) From a full mail address (eg.
static java.lang.String	extractMailTitle(java.lang.String address) From a full mail address (eg.
static java.lang.String	formatBR(java.lang.String text) Put HTML line breaks in the place of normal text line breaks.
static java.lang.String	formatN(java.lang.String text) Reverse function of the formatBR(String), converts HTML line breaks into text line breaks
static char	hexChar(int val) Get the hexa digit for this integer value
static java.util.Date	parseDate(java.lang.String s) Transform a string that represents a Date into a real Date object.
static java.lang.String	point(double number) Show a nice number, with the number of decimal places chosen automatically depending on the number to format
static java.lang.String	replace(java.lang.String s, java.lang.String sWhat, java.lang.String sWith) Replace a sequence of text with another sequence in an original string
static java.lang.String	show0(int i) For date formatting, put a "0" in front of a single digit, or leave the number as it is if there are at least two digits already
static java.lang.String	showDate(java.util.Date d) Show the date and time in a nice human-readable format
static java.lang.String	showDottedDate(java.util.Date d) Show a date in a dotted manner (dd.MM.yyyy)
static java.lang.String	showDottedDouble(double d) Show the value in 3 digit groups separated by commas, no period point
static java.lang.String	showDottedDouble(double d, int dotplaces) Show the value in 3 digit groups separated by commas, with the specified number of decimal places after the decimal point
static java.lang.String	showDottedDouble(double dbl, int decimals, boolean aproximated) Show the value in 3 digit groups separated by commas, with the specified number of decimal places after the decimal point.
static java.lang.String	showDottedLong(long l) Show the value in 3 digit groups separated by commas
static java.lang.String	showLongNamedDate(java.util.Date d) Show the full month name (11 January 2006)
static java.lang.String	showNamedDate(java.util.Date d) Show the abreviated month name (11 Jan 2006)
static java.lang.String	showNiceDate(java.util.Date d) Get a nifty string representation for a date.
static java.lang.String	showTime(java.util.Date d) Show the time only (12:34)
static java.lang.String	size(long dim) Nicely show the size of a file.
static java.lang.String	size(long size, java.lang.String unit) Nicely show a size, starting from a given measurement unit.
static java.lang.String	toInterval(long lInterval) Convert a time in milliseconds to a human readable interval display

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Format

public Format()

Method Detail

size

public static java.lang.String size(long dim)

Nicely show the size of a file. Something like 12.1KB, 0.75MB ...

Parameters:

dim - file size, in bytes

Returns:

the nice human-readable size

size

public static java.lang.String size(long size,
                                    java.lang.String unit)

Nicely show a size, starting from a given measurement unit.

Parameters:

size - file size, in the specified unit

unit - unit. Can be nothing(==B) or one of the following: B, K, M, G, T, P

Returns:

nice human-readable size

Since:

1.0.5

point

public static java.lang.String point(double number)

Show a nice number, with the number of decimal places chosen automatically depending on the number to format

Parameters:

number -

Returns:

nice floating point number representation

Since:

1.0.5

extractMailTitle

public static java.lang.String extractMailTitle(java.lang.String address)

From a full mail address (eg. "Full Name ") try to extract the full name. If it cannot extract the full name it will return the mail address.

Parameters:

address - full address

Returns:

the name of the person

extractAddress

public static java.lang.String extractAddress(java.lang.String address)

From a full mail address (eg. "Full Name" <account@server.com>) try to extract the email address.

Parameters:

address - full address

Returns:

the address part or null if there is no email part in it

escHtml

public static java.lang.String escHtml(java.lang.String text)

Transform a text into an HTML-safe string.

Parameters:

text - original text

Returns:

the HTML-safe version of the text

encode

public static java.lang.String encode(java.lang.String text)

Produce an URL encoding of the given text, using the UTF-8 charset

Parameters:

text - text to encode

Returns:

URL-safe version of the text

decode

public static java.lang.String decode(java.lang.String text)

Decode an URL-encoded string, using the UTF-8 charset.

Parameters:

text - text to decode

Returns:

plain text version

escSQL

public static java.lang.String escSQL(java.lang.String text)

Create a SQL-safe version of the given text, to be embedded into SQL queries

Parameters:

text - original text

Returns:

SQL-safe version of the text

escJS

public static java.lang.String escJS(java.lang.String text)

Create a JS-safe string representation. This is useful when you want to pass a text to a dynamic string variable in the final HTML document.

Parameters:

text - original text

Returns:

JS-string-safe version

replace

public static java.lang.String replace(java.lang.String s,
                                       java.lang.String sWhat,
                                       java.lang.String sWith)

Replace a sequence of text with another sequence in an original string

Parameters:

s - original text

sWhat - what to search and replace

sWith - the new text to put in place

Returns:

the modified text

formatBR

public static final java.lang.String formatBR(java.lang.String text)

Put HTML line breaks in the place of normal text line breaks.

Parameters:

text - original text

Returns:

text with <BR&gr; instead of the \n in the original text

formatN

public static final java.lang.String formatN(java.lang.String text)

Reverse function of the formatBR(String), converts HTML line breaks into text line breaks

Parameters:

text - original text

Returns:

text with \n instead of <BR>

parseDate

public static final java.util.Date parseDate(java.lang.String s)

Transform a string that represents a Date into a real Date object. It will try several formats, including date-only and time-only representations.

Parameters:

s - string to convert

Returns:

date representation, or null if the conversion was not possible.

show0

public static final java.lang.String show0(int i)

For date formatting, put a "0" in front of a single digit, or leave the number as it is if there are at least two digits already

Parameters:

i - the number to format

Returns:

0-padded string representation

showNiceDate

public static final java.lang.String showNiceDate(java.util.Date d)

Get a nifty string representation for a date. Something like "today", "yesterday", "21 May 2006" ...

Parameters:

d - date to convert

Returns:

nice human readable date

showDate

public static final java.lang.String showDate(java.util.Date d)

Show the date and time in a nice human-readable format

Parameters:

d - date to represent

Returns:

date and time

showDottedDate

public static final java.lang.String showDottedDate(java.util.Date d)

Show a date in a dotted manner (dd.MM.yyyy)

Parameters:

d - date to show

Returns:

the dotted date

showLongNamedDate

public static final java.lang.String showLongNamedDate(java.util.Date d)

Show the full month name (11 January 2006)

Parameters:

d - date to show

Returns:

date with full month name

showNamedDate

public static final java.lang.String showNamedDate(java.util.Date d)

Show the abreviated month name (11 Jan 2006)

Parameters:

d - date to show

Returns:

date with short month name

showTime

public static final java.lang.String showTime(java.util.Date d)

Show the time only (12:34)

Parameters:

d - date to show

Returns:

the hours and minutes only

showDottedLong

public static final java.lang.String showDottedLong(long l)

Show the value in 3 digit groups separated by commas

Parameters:

l - value to show

Returns:

nice string representation

showDottedDouble

public static final java.lang.String showDottedDouble(double d)

Show the value in 3 digit groups separated by commas, no period point

Parameters:

d - value to show

Returns:

nice string representation

showDottedDouble

public static final java.lang.String showDottedDouble(double d,
                                                      int dotplaces)

Show the value in 3 digit groups separated by commas, with the specified number of decimal places after the decimal point

Parameters:

d - value to show

dotplaces - number of decimal places after the point

Returns:

nice string representation

showDottedDouble

public static final java.lang.String showDottedDouble(double dbl,
                                                      int decimals,
                                                      boolean aproximated)

Show the value in 3 digit groups separated by commas, with the specified number of decimal places after the decimal point.

Parameters:

dbl - value to show

decimals - number of decimal places after the point

aproximated - whether or not to use "millions" and "bilions" for very large numbers

Returns:

nice string representation

toInterval

public static final java.lang.String toInterval(long lInterval)

Convert a time in milliseconds to a human readable interval display

Parameters:

lInterval - interval time in milliseconds

Returns:

human readable interval

hexChar

public static final char hexChar(int val)

Get the hexa digit for this integer value

Parameters:

val - value

Returns:

hexa digit

byteToHex

public static final java.lang.String byteToHex(byte val)

Get the 2 hexa digit representation of this byte

Parameters:

val -

Returns:

the 2 hexa digit representation