Package org.apache.myfaces.view.facelets.el

Class ELText

java.lang.Object

org.apache.myfaces.view.facelets.el.ELText

Direct Known Subclasses:

ELText.ELCacheableTextVariable, ELText.ELTextComposite, ELText.ELTextVariable

public class ELText
extends Object

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

Version:

$Id$

Author:

Jacob Hookom

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	ELText.ELCacheableTextVariable
protected static class	ELText.ELTextComposite
protected static class	ELText.ELTextVariable
protected static class	ELText.LiteralValueExpression

Field Summary

Fields

Modifier and Type	Field	Description
protected String	literal

Constructor Summary

Constructors

Constructor	Description
ELText(String literal)

Method Summary

Modifier and Type	Method	Description
ELText	apply(jakarta.el.ExpressionFactory factory, jakarta.el.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(jakarta.el.ExpressionFactory fact, jakarta.el.ELContext ctx, String in)
static boolean	isLiteral(String in)	Parses the passed string to determine if it's literal or not
static ELText	parse(jakarta.el.ExpressionFactory fact, jakarta.el.ELContext ctx, String in)
static ELText	parse(jakarta.el.ExpressionFactory fact, jakarta.el.ELContext ctx, String in, Location location)	Factory method for creating a validated ELText instance.
static ELText	parse(String in)
static ELText	parse(String in, Location location)	Factory method for creating an unvalidated ELText instance.
static ELText	parseAllowEmptyString(String in, Location location)
static ELText[]	parseAsArray(jakarta.el.ExpressionFactory fact, jakarta.el.ELContext ctx, String in, Location location)
static ELText[]	parseAsArray(String in, Location location)
static String	parseAsString(jakarta.el.ExpressionFactory fact, jakarta.el.ELContext ctx, String in)
String	toString()
String	toString(jakarta.el.ELContext ctx)	Evaluates the ELText to a String
void	write(Writer out, jakarta.el.ELContext ctx)	Allow this instance to write to the passed Writer, given the ELContext state
void	writeText(ResponseWriter out, jakarta.el.ELContext ctx)

Methods inherited from class java.lang.Object

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

Field Detail

literal

protected final String literal

Constructor Detail

ELText

public ELText(String literal)

Method Detail

isLiteral

public boolean isLiteral()

If it's literal text

Returns:

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

apply

public ELText apply(jakarta.el.ExpressionFactory factory,
                    jakarta.el.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,
                  jakarta.el.ELContext ctx)
           throws jakarta.el.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:

jakarta.el.ELException

IOException

writeText

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

Throws:

jakarta.el.ELException

IOException

toString

public String toString(jakarta.el.ELContext ctx)
                throws jakarta.el.ELException

Evaluates the ELText to a String

Parameters:

ctx - current ELContext state

Returns:

the evaluated String

Throws:

jakarta.el.ELException

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 jakarta.el.ELException

Throws:

jakarta.el.ELException

parse

public static ELText parse(String in,
                           Location location)
                    throws jakarta.el.ELException

Factory method for creating an unvalidated ELText instance. NOTE: All expressions in the passed String are treated as LocationValueExpression.

Parameters:

in - String to parse

location - The location

Returns:

ELText instance that knows if the String was literal or not

Throws:

jakarta.el.ELException

parseAllowEmptyString

public static ELText parseAllowEmptyString(String in,
                                           Location location)
                                    throws jakarta.el.ELException

Throws:

jakarta.el.ELException

parseAsString

public static String parseAsString(jakarta.el.ExpressionFactory fact,
                                   jakarta.el.ELContext ctx,
                                   String in)
                            throws jakarta.el.ELException

Throws:

jakarta.el.ELException

parse

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

Throws:

jakarta.el.ELException

parse

public static ELText parse(jakarta.el.ExpressionFactory fact,
                           jakarta.el.ELContext ctx,
                           String in,
                           Location location)
                    throws jakarta.el.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

location - The location

Returns:

ELText that can be re-applied later

Throws:

jakarta.el.ELException

parseAsArray

public static ELText[] parseAsArray(String in,
                                    Location location)
                             throws jakarta.el.ELException

Throws:

jakarta.el.ELException

parseAsArray

public static ELText[] parseAsArray(jakarta.el.ExpressionFactory fact,
                                    jakarta.el.ELContext ctx,
                                    String in,
                                    Location location)
                             throws jakarta.el.ELException

Throws:

jakarta.el.ELException

isLiteral

public static boolean isLiteral(jakarta.el.ExpressionFactory fact,
                                jakarta.el.ELContext ctx,
                                String in)
                         throws jakarta.el.ELException

Throws:

jakarta.el.ELException