Package org.zkoss.xel.fn

Class CommonFns

java.lang.Object

org.zkoss.xel.fn.CommonFns

public class CommonFns
extends java.lang.Object

Common functions used with EL.

Author:

tomyeh

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CommonFns()

Method Summary

Modifier and Type	Method	Description
static java.lang.String	formatDate(java.util.Date date, java.lang.String pattern)	Formats a Date into a date/time string.
static java.lang.String	formatDate(java.util.Date date, java.lang.String pattern, java.util.Locale locale, java.util.TimeZone timezone, java.lang.String dateStyle, java.lang.String timeStyle)	Formats a Date into a date/time string.
static java.lang.String	formatNumber(java.lang.Object value, java.lang.String format)	Formats a number (Integer, BigDecimal...) into a string.
static java.lang.String	formatNumber(java.lang.Object number, java.lang.String pattern, java.util.Locale locale)	Formats a number (Integer, BigDecimal...) into a string.
static java.lang.String	getLabel(java.lang.String key)	Returns the label or message of the specified key.
static java.lang.String	getLabel(java.lang.String key, java.lang.Object[] args)	Returns the label of the specified key and formats it with the specified argument, or null if not found.
static int	indexOf(java.lang.Object o, java.lang.Object element)	Returns the index of the given element.
static boolean	isInstance(java.lang.Object c, java.lang.Object o)	Tests whether an object, o, is an instance of a class, c.
static int	lastIndexOf(java.lang.Object o, java.lang.Object element)	Returns the last index of the given element.
static int	length(java.lang.Object o)	Returns the length of an array, string, collection or map.
static java.lang.Object	new_(java.lang.Object o)	Instantiates the specified class.
static java.lang.Object	new_(java.lang.Object o, java.lang.Object arg)	Instantiates the specified class, and argument.
static java.lang.Object	new_(java.lang.Object o, java.lang.Object arg1, java.lang.Object arg2)	Instantiates the specified class, and two arguments.
static java.lang.Object	new_(java.lang.Object o, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)	Instantiates the specified class, and two arguments.
static java.util.Date	parseDate(java.lang.String source, java.lang.String pattern)	Parses text from the beginning of the given string to produce a date.
static java.util.Date	parseDate(java.lang.String source, java.lang.String pattern, java.util.Locale locale, java.util.TimeZone timezone, java.lang.String dateStyle, java.lang.String timeStyle)	Parses text from the beginning of the given string to produce a date.
static java.lang.Number	parseNumber(java.lang.String source, java.lang.String pattern)	Parses text from the beginning of the given string to produce a number.
static java.lang.Number	parseNumber(java.lang.String source, java.lang.String pattern, java.util.Locale locale)	Parses text from the beginning of the given string to produce a number.
static boolean	toBoolean(java.lang.Object val)	Converts the specified object to a boolean.
static char	toChar(java.lang.Object val)	Converts the specified object to an character.
static java.math.BigDecimal	toDecimal(java.lang.Object val)	Converts the specified object to a (big) decimal.
static int	toInt(java.lang.Object val)	Converts the specified object to an integer.
static java.lang.Number	toNumber(java.lang.Object val)	Converts the specified object to a number.
static java.lang.String	toString(java.lang.Object val)	Converts the specified object to a string.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonFns

protected CommonFns()

Method Detail

toBoolean

public static boolean toBoolean(java.lang.Object val)

Converts the specified object to a boolean.

toString

public static java.lang.String toString(java.lang.Object val)

Converts the specified object to a string.

toNumber

public static java.lang.Number toNumber(java.lang.Object val)

Converts the specified object to a number.

toInt

public static int toInt(java.lang.Object val)

Converts the specified object to an integer.

toDecimal

public static java.math.BigDecimal toDecimal(java.lang.Object val)

Converts the specified object to a (big) decimal.

toChar

public static char toChar(java.lang.Object val)

Converts the specified object to an character.

isInstance

public static boolean isInstance(java.lang.Object c,
                                 java.lang.Object o)

Tests whether an object, o, is an instance of a class, c.

getLabel

public static final java.lang.String getLabel(java.lang.String key)

Returns the label or message of the specified key.

• If key is "mesg:class:MMM", Messages.get(class.MMM) is called
• Otherwise, Labels.getLabel(String) is called.

See Also:

getLabel(String, Object[])

getLabel

public static final java.lang.String getLabel(java.lang.String key,
                                              java.lang.Object[] args)

Returns the label of the specified key and formats it with the specified argument, or null if not found.

It first uses getLabel(String) to load the label. Then, it, if not null, invokes MessageFormats.format(java.lang.String, java.lang.Object[], java.util.Locale) to format it.

The current locale is given by Locales.getCurrent().

Since:

3.0.6

length

public static final int length(java.lang.Object o)

Returns the length of an array, string, collection or map.

indexOf

public static final int indexOf(java.lang.Object o,
                                java.lang.Object element)

Returns the index of the given element.

Parameters:

o - the array/collection of objects to examine, or a string. If o is a map, then Map.keySet() is assumed.

Since:

5.0.7

lastIndexOf

public static final int lastIndexOf(java.lang.Object o,
                                    java.lang.Object element)

Returns the last index of the given element.

Parameters:

o - the array/list of objects to examine, or a string.

Since:

5.0.7

new_

public static final java.lang.Object new_(java.lang.Object o)
                                   throws java.lang.Exception

Instantiates the specified class.

Throws:

java.lang.Exception

new_

public static final java.lang.Object new_(java.lang.Object o,
                                          java.lang.Object arg)
                                   throws java.lang.Exception

Instantiates the specified class, and argument.

Parameters:

o - the class name or class

arg - the argument

Throws:

java.lang.Exception

Since:

5.0.5

new_

public static final java.lang.Object new_(java.lang.Object o,
                                          java.lang.Object arg1,
                                          java.lang.Object arg2)
                                   throws java.lang.Exception

Instantiates the specified class, and two arguments.

Parameters:

o - the class name or class

arg1 - the first argument

arg2 - the second argument

Throws:

java.lang.Exception

Since:

5.0.5

new_

public static final java.lang.Object new_(java.lang.Object o,
                                          java.lang.Object arg1,
                                          java.lang.Object arg2,
                                          java.lang.Object arg3)
                                   throws java.lang.Exception

Instantiates the specified class, and two arguments.

Parameters:

o - the class name or class

arg1 - the first argument

arg2 - the second argument

Throws:

java.lang.Exception

Since:

5.0.5

formatDate

public static final java.lang.String formatDate(java.util.Date date,
                                                java.lang.String pattern)

Formats a Date into a date/time string.

Parameters:

date - the time value to be formatted into a time string.

pattern - the pattern describing the date and time format

Returns:

the formatted time string.

Since:

6.0.0

parseDate

public static final java.util.Date parseDate(java.lang.String source,
                                             java.lang.String pattern)
                                      throws java.lang.Exception

Parses text from the beginning of the given string to produce a date. The method may not use the entire text of the given string.

Parameters:

source - A String whose beginning should be parsed.

pattern - the pattern describing the date and time format

Returns:

A Date parsed from the string.

Throws:

java.lang.Exception

Since:

6.0.0

formatNumber

public static final java.lang.String formatNumber(java.lang.Object value,
                                                  java.lang.String format)

Formats a number (Integer, BigDecimal...) into a string. If null, an empty string is returned.

A utility to assist the handling of numeric data.

Parameters:

value - The number to format.

format - The pattern to apply, if it is null, the system's default format is used.

Returns:

the formatted number string.

Since:

6.0.1

parseNumber

public static final java.lang.Number parseNumber(java.lang.String source,
                                                 java.lang.String pattern)
                                          throws java.lang.Exception

Parses text from the beginning of the given string to produce a number. The method may not use the entire text of the given string.

Parameters:

source - A String whose beginning should be parsed.

pattern - the pattern describing the date and time format

Returns:

A Number parsed from the string.

Throws:

java.lang.Exception

Since:

6.0.1

formatDate

public static final java.lang.String formatDate(java.util.Date date,
                                                java.lang.String pattern,
                                                java.util.Locale locale,
                                                java.util.TimeZone timezone,
                                                java.lang.String dateStyle,
                                                java.lang.String timeStyle)

Formats a Date into a date/time string.

Parameters:

date - the time value to be formatted into a time string.

pattern - the pattern describing the date and time format

locale - The Locale to apply, if it is null, The current locale given by Locales.getCurrent() is used.

timezone - the time zone to apply, if it is null, The current timezone given by TimeZones.getCurrent() is used.

dateStyle - styling index of date.

timeStyle - styling index of time.

Returns:

the formatted time string.

Since:

6.0.0

parseDate

public static final java.util.Date parseDate(java.lang.String source,
                                             java.lang.String pattern,
                                             java.util.Locale locale,
                                             java.util.TimeZone timezone,
                                             java.lang.String dateStyle,
                                             java.lang.String timeStyle)
                                      throws java.lang.Exception

Parses text from the beginning of the given string to produce a date. The method may not use the entire text of the given string.

Parameters:

source - A String whose beginning should be parsed.

pattern - the pattern describing the date and time format

locale - The Locale to apply, if it is null, The current locale given by Locales.getCurrent() is used.

timezone - the time zone to apply, if it is null, The current timezone given by TimeZones.getCurrent() is used.

dateStyle - styling index of date.

timeStyle - styling index of time.

Returns:

A Date parsed from the string.

Throws:

java.lang.Exception

Since:

6.0.0

formatNumber

public static final java.lang.String formatNumber(java.lang.Object number,
                                                  java.lang.String pattern,
                                                  java.util.Locale locale)

Formats a number (Integer, BigDecimal...) into a string. If null, an empty string is returned.

A utility to assist the handling of numeric data.

Parameters:

number - The number to format.

pattern - The pattern to apply, if it is null, the system's default format is used.

locale - The Locale to apply, if it is null, The current locale given by Locales.getCurrent() is used.

Returns:

String The formatted number string.

Since:

6.0.1

parseNumber

public static final java.lang.Number parseNumber(java.lang.String source,
                                                 java.lang.String pattern,
                                                 java.util.Locale locale)
                                          throws java.lang.Exception

Parses text from the beginning of the given string to produce a number. The method may not use the entire text of the given string.

Parameters:

source - A String whose beginning should be parsed.

pattern - the pattern describing the date and time format

locale - The Locale to apply, if it is null, The current locale given by Locales.getCurrent() is used.

Returns:

A Number parsed from the string.

Throws:

java.lang.Exception

Since:

6.0.1