Java Doc for ValueExpression.java in  » EJB-Server-GlassFish » servlet » javax » el » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » EJB Server GlassFish » servlet » javax.el 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   javax.el.Expression
      javax.el.ValueExpression

ValueExpression
abstract public class ValueExpression extends Expression (Code)
An Expression that can get or set a value.

In previous incarnations of this API, expressions could only be read. ValueExpression objects can now be used both to retrieve a value and to set a value. Expressions that can have a value set on them are referred to as l-value expressions. Those that cannot are referred to as r-value expressions. Not all r-value expressions can be used as l-value expressions (e.g. "${1+1}" or "${firstName} ${lastName}"). See the EL Specification for details. Expressions that cannot be used as l-values must always return true from isReadOnly().

The ExpressionFactory.createValueExpression method can be used to parse an expression string and return a concrete instance of ValueExpression that encapsulates the parsed expression. The FunctionMapper is used at parse time, not evaluation time, so one is not needed to evaluate an expression using this class. However, the ELContext is needed at evaluation time.

The ValueExpression.getValue , ValueExpression.setValue , ValueExpression.isReadOnly and ValueExpression.getType methods will evaluate the expression each time they are called. The ELResolver in the ELContext is used to resolve the top-level variables and to determine the behavior of the . and [] operators. For any of the four methods, the ELResolver.getValue method is used to resolve all properties up to but excluding the last one. This provides the base object. At the last resolution, the ValueExpression will call the corresponding ELResolver.getValue , ELResolver.setValue , ELResolver.isReadOnly or ELResolver.getType method, depending on which was called on the ValueExpression.

See the notes about comparison, serialization and immutability in the Expression javadocs.
See Also:   ELResolver
See Also:   Expression
See Also:   ExpressionFactory
since:
   JSP 2.1





Method Summary
abstract public  ClassgetExpectedType()
     Returns the type the result of the expression will be coerced to after evaluation.
abstract public  ClassgetType(ELContext context)
     Evaluates the expression relative to the provided context, and returns the most general type that is acceptable for an object to be passed as the value parameter in a future call to the ValueExpression.setValue method.

This is not always the same as getValue().getClass(). For example, in the case of an expression that references an array element, the getType method will return the element type of the array, which might be a superclass of the type of the actual element that is currently in the specified array element.


Parameters:
  context - The context of this evaluation.
abstract public  ObjectgetValue(ELContext context)
     Evaluates the expression relative to the provided context, and returns the resulting value.

The resulting value is automatically coerced to the type returned by getExpectedType(), which was provided to the ExpressionFactory when this expression was created.


Parameters:
  context - The context of this evaluation.
abstract public  booleanisReadOnly(ELContext context)
     Evaluates the expression relative to the provided context, and returns true if a call to ValueExpression.setValue will always fail.
Parameters:
  context - The context of this evaluation.
abstract public  voidsetValue(ELContext context, Object value)
     Evaluates the expression relative to the provided context, and sets the result to the provided value.
Parameters:
  context - The context of this evaluation.
Parameters:
  value - The new value to be set.
throws:
  NullPointerException - if context is null.
throws:
  PropertyNotFoundException - if one of the propertyresolutions failed because a specified variable or property does not exist or is not readable.
throws:
  PropertyNotWritableException - if the final variable orproperty resolution failed because the specifiedvariable or property is not writable.
throws:
  ELException - if an exception was thrown while attempting toset the property or variable.



Method Detail
getExpectedType
abstract public Class getExpectedType()(Code)
Returns the type the result of the expression will be coerced to after evaluation. the expectedType passed to theExpressionFactory.createValueExpression methodthat created this ValueExpression.



getType
abstract public Class getType(ELContext context)(Code)
Evaluates the expression relative to the provided context, and returns the most general type that is acceptable for an object to be passed as the value parameter in a future call to the ValueExpression.setValue method.

This is not always the same as getValue().getClass(). For example, in the case of an expression that references an array element, the getType method will return the element type of the array, which might be a superclass of the type of the actual element that is currently in the specified array element.


Parameters:
  context - The context of this evaluation. the most general acceptable type; otherwise undefined.
throws:
  NullPointerException - if context is null.
throws:
  PropertyNotFoundException - if one of the propertyresolutions failed because a specified variable or property does not exist or is not readable.
throws:
  ELException - if an exception was thrown while performingproperty or variable resolution. The thrown exceptionmust be included as the cause property of this exception, ifavailable.



getValue
abstract public Object getValue(ELContext context)(Code)
Evaluates the expression relative to the provided context, and returns the resulting value.

The resulting value is automatically coerced to the type returned by getExpectedType(), which was provided to the ExpressionFactory when this expression was created.


Parameters:
  context - The context of this evaluation. The result of the expression evaluation.
throws:
  NullPointerException - if context is null.
throws:
  PropertyNotFoundException - if one of the propertyresolutions failed because a specified variable or property does not exist or is not readable.
throws:
  ELException - if an exception was thrown while performingproperty or variable resolution. The thrown exceptionmust be included as the cause property of this exception, ifavailable.



isReadOnly
abstract public boolean isReadOnly(ELContext context)(Code)
Evaluates the expression relative to the provided context, and returns true if a call to ValueExpression.setValue will always fail.
Parameters:
  context - The context of this evaluation. true if the expression is read-only orfalse if not.
throws:
  NullPointerException - if context is null.
throws:
  PropertyNotFoundException - if one of the propertyresolutions failed because a specified variable or property does not exist or is not readable.
throws:
  ELException - if an exception was thrown while performingproperty or variable resolution. The thrown exceptionmust be included as the cause property of this exception, ifavailable.
throws:
  NullPointerException - if context is null



setValue
abstract public void setValue(ELContext context, Object value)(Code)
Evaluates the expression relative to the provided context, and sets the result to the provided value.
Parameters:
  context - The context of this evaluation.
Parameters:
  value - The new value to be set.
throws:
  NullPointerException - if context is null.
throws:
  PropertyNotFoundException - if one of the propertyresolutions failed because a specified variable or property does not exist or is not readable.
throws:
  PropertyNotWritableException - if the final variable orproperty resolution failed because the specifiedvariable or property is not writable.
throws:
  ELException - if an exception was thrown while attempting toset the property or variable. The thrown exceptionmust be included as the cause property of this exception, ifavailable.



Methods inherited from javax.el.Expression
abstract public boolean equals(Object obj)(Code)(Java Doc)
abstract public String getExpressionString()(Code)(Java Doc)
abstract public int hashCode()(Code)(Java Doc)
abstract public boolean isLiteralText()(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.