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

java.lang.Object
  org.apache.myfaces.view.facelets.el.ELText

public class ELText
extends java.lang.Object

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

Version:

$Id: ELText.java,v 1.8 2008/07/13 19:01:42 rlubke Exp $

Author:

Jacob Hookom

Field Summary

protected java.lang.String

literal

Constructor Summary

ELText(java.lang.String literal)

Method Summary

ELText	apply(javax.el.ExpressionFactory factory, javax.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(java.lang.String in) Parses the passed string to determine if it's literal or not
static ELText	parse(javax.el.ExpressionFactory fact, javax.el.ELContext ctx, java.lang.String in) Factory method for creating a validated ELText instance.
static ELText	parse(java.lang.String in) Factory method for creating an unvalidated ELText instance.
java.lang.String	toString()
java.lang.String	toString(javax.el.ELContext ctx) Evaluates the ELText to a String
void	write(java.io.Writer out, javax.el.ELContext ctx) Allow this instance to write to the passed Writer, given the ELContext state
void	writeText(javax.faces.context.ResponseWriter out, javax.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 java.lang.String literal

Constructor Detail

ELText

public ELText(java.lang.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(javax.el.ExpressionFactory factory,
                    javax.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(java.io.Writer out,
                  javax.el.ELContext ctx)
           throws javax.el.ELException,
                  java.io.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:

javax.el.ELException

java.io.IOException

writeText

public void writeText(javax.faces.context.ResponseWriter out,
                      javax.el.ELContext ctx)
               throws javax.el.ELException,
                      java.io.IOException

Throws:

javax.el.ELException

java.io.IOException

toString

public java.lang.String toString(javax.el.ELContext ctx)
                          throws javax.el.ELException

Evaluates the ELText to a String

Parameters:

ctx - current ELContext state

Returns:

the evaluated String

Throws:

javax.el.ELException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

isLiteral

public static boolean isLiteral(java.lang.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(java.lang.String in)
                    throws javax.el.ELException

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

Parameters:

in - String to parse

Returns:

ELText instance that knows if the String was literal or not

Throws:

javax.el.ELException

parse

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

Returns:

ELText that can be re-applied later

Throws:

javax.el.ELException