org.omnifaces.el.functions

Class Strings

java.lang.Object

org.omnifaces.el.functions.Strings

public final class Strings
extends java.lang.Object

Collection of EL functions for string manipulation.

Author:

Bauke Scholtz

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	abbreviate(java.lang.String text, int size) Abbreviate the given text on the given size limit with ellipsis.
static java.lang.String	concat(java.lang.Object left, java.lang.Object right) Concatenate the string representation of the given objects.
static java.lang.String	encodeURL(java.lang.String string) URL-encode the given string using UTF-8.
static java.lang.String	escapeJS(java.lang.String string) Escapes the given string according the JavaScript code rules.
static java.lang.String	prettyURL(java.lang.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 java.lang.String abbreviate(java.lang.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 java.lang.String concat(java.lang.Object left,
                      java.lang.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.

prettyURL

public static java.lang.String prettyURL(java.lang.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 java.lang.String encodeURL(java.lang.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:

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

escapeJS

public static java.lang.String escapeJS(java.lang.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.