org.omnifaces.el.functions

Class Strings

java.lang.Object

org.omnifaces.el.functions.Strings

public final class Strings
extends Object

Collection of EL functions for string manipulation.

Author:

Bauke Scholtz

Method Summary

Methods

Modifier and Type	Method and Description
static String	abbreviate(String text, int size) Abbreviate the given text on the given size limit with ellipsis.
static String	capitalize(String string) Capitalize the given string, i.e.
static String	concat(Object left, Object right) Concatenate the string representation of the given objects.
static String	encodeURL(String string) URL-encode the given string using UTF-8.
static String	escapeJS(String string) Escapes the given string according the JavaScript code rules.
static String	prettyURL(String string) URL-prettify the given string.

Methods inherited from class java.lang.Object

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

Method Detail

abbreviate

public static String abbreviate(String text,
                int size)

Abbreviate the given text on the given size limit with ellipsis.

Parameters:

text - The text to be abbreviated.

size - The size limit of the text.

Returns:

The abbreviated text, or the unmodified text if it is shorter than the size.

concat

public static String concat(Object left,
            Object right)

Concatenate the string representation of the given objects. This is useful when you don't know beforehand if one of the both hands is a string or is null, otherwise the new EL 2.2 #{bean.string1.concat(bean.string2)} can just be used.

Parameters:

left - The left hand.

right - The right hand.

Returns:

The concatenated strings.

capitalize

public static String capitalize(String string)

Capitalize the given string, i.e. uppercase the first character.

Parameters:

string - The string to be capitalized.

Returns:

The capitalized string.

Since:

1.1

prettyURL

public static String prettyURL(String string)

URL-prettify the given string. It performs the following tasks:

• Lowercase the string.
• Remove combining diacritical marks.
• Replace non-alphanumeric characters by hyphens.

This is useful when populating links with dynamic paths obtained from user controlled variables, such as blog titles.

Parameters:

string - The string to be prettified.

Returns:

The prettified string.

encodeURL

public static String encodeURL(String string)

URL-encode the given string using UTF-8. This is useful for cases where you can't use <f:param>.

Parameters:

string - The string to be URL-encoded.

Returns:

The URL-encoded string.

Throws:

UnsupportedOperationException - When this platform does not support UTF-8.

escapeJS

public static String escapeJS(String string)

Escapes the given string according the JavaScript code rules. This escapes among others the special characters, the whitespace, the quotes and the unicode characters. Useful whenever you want to use a Java string variable as a JavaScript string variable.

Parameters:

string - The string to be escaped according the JavaScript code rules.

Returns:

The escaped string according the JavaScript code rules.