Module jakarta.faces

Package com.sun.faces.facelets.el

Class ELText

java.lang.Object

com.sun.faces.facelets.el.ELText

public class ELText
extends Object

Handles parsing EL Strings in accordance with the EL-API Specification. The parser accepts either ${..} or #{..}.

Version:

$Id$

Field Summary

Fields

Modifier and Type	Field	Description
protected final String	literal

Constructor Summary

Constructors

Constructor	Description
ELText(String literal)

Method Summary

Modifier and Type	Method	Description
ELText	apply(ExpressionFactory factory, ELContext ctx)	Return an instance of this that is applicable given the ELContext and ExpressionFactory state.
boolean	isLiteral()	If it's literal text
static boolean	isLiteral(String in)	Parses the passed string to determine if it's literal or not
static ELText	parse(ExpressionFactory fact, ELContext ctx, String in)
static ELText	parse(ExpressionFactory fact, ELContext ctx, String in, String alias)	Factory method for creating a validated ELText instance.
static ELText	parse(String in)	Factory method for creating an unvalidated ELText instance.
static ELText	parse(String in, String alias)
String	toString()
String	toString(ELContext ctx)	Evaluates the ELText to a String
void	write(Writer out, ELContext ctx)	Allow this instance to write to the passed Writer, given the ELContext state
void	writeText(ResponseWriter out, ELContext ctx)

Methods inherited from class java.lang.Object

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

Field Details

literal

protected final String literal

Constructor Details

ELText

public ELText(String literal)

Method Details

isLiteral

public boolean isLiteral()

If it's literal text

Returns:

true if the String is literal (doesn't contain #{..} or ${..})

apply

public ELText apply(ExpressionFactory factory,
 ELContext ctx)

Return an instance of this that is applicable given the ELContext and ExpressionFactory state.

Parameters:

factory - the ExpressionFactory to use

ctx - the ELContext to use

Returns:

an ELText instance

write

public void write(Writer out,
 ELContext ctx)
           throws ELException,
IOException

Allow this instance to write to the passed Writer, given the ELContext state

Parameters:

out - Writer to write to

ctx - current ELContext state

Throws:

ELException - when an EL exception occurs

IOException - when an I/O exception occurs

writeText

public void writeText(ResponseWriter out,
 ELContext ctx)
               throws ELException,
IOException

Throws:

ELException

IOException

toString

public String toString(ELContext ctx)
                throws ELException

Evaluates the ELText to a String

Parameters:

ctx - current ELContext state

Returns:

the evaluated String

Throws:

ELException - when an EL exception occurs

toString

public String toString()

Overrides:

toString in class Object

isLiteral

public static boolean isLiteral(String in)

Parses the passed string to determine if it's literal or not

Parameters:

in - input String

Returns:

true if the String is literal (doesn't contain #{..} or ${..})

parse

public static ELText parse(String in)
                    throws ELException

Factory method for creating an unvalidated ELText instance. NOTE: All expressions in the passed String are treated as ELText.LiteralValueExpression, with one exception: composite component expressions. These are treated as ContextualCompositeValueExpressions.

Parameters:

in - String to parse

Returns:

ELText instance that knows if the String was literal or not

Throws:

ELException - when an EL exception occurs

parse

public static ELText parse(String in,
 String alias)
                    throws ELException

Throws:

ELException

parse

public static ELText parse(ExpressionFactory fact,
 ELContext ctx,
 String in)
                    throws ELException

Throws:

ELException

parse

public static ELText parse(ExpressionFactory fact,
 ELContext ctx,
 String in,
 String alias)
                    throws ELException

Factory method for creating a validated ELText instance. When an Expression is hit, it will use the ExpressionFactory to create a ValueExpression instance, resolving any functions at that time. Variables and properties will not be evaluated.

Parameters:

fact - ExpressionFactory to use

ctx - ELContext to validate against

in - String to parse

alias - the alias

Returns:

ELText that can be re-applied later

Throws:

ELException - when an EL exception occurs