application.html

来自「j2ee帮助文档软件设计/软件工程 文件格式」· HTML 代码 · 共 1,031 行 · 第 1/5 页

public abstract <A HREF="../../../javax/faces/el/PropertyResolver.html" title="class in javax.faces.el">PropertyResolver</A> <B>getPropertyResolver</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../javax/faces/application/Application.html#getELResolver()"><CODE>getELResolver()</CODE></A>.</I>
<P>
<DD><p>Return a <A HREF="../../../javax/faces/el/PropertyResolver.html" title="class in javax.faces.el"><CODE>PropertyResolver</CODE></A> instance that wraps the
 <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el"><CODE>ELResolver</CODE></A> instance that Faces provides to the unified EL
 for the resolution of expressions that appear programmatically in
 an application.</p>

 <p>Note that this no longer returns the default
 <code>PropertyResolver</code> since that class is now a no-op
 that aids in allowing custom <code>PropertyResolver</code>s to
 affect the EL resolution process.</p>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setPropertyResolver(javax.faces.el.PropertyResolver)"><!-- --></A><H3>
setPropertyResolver</H3>
<PRE>
public abstract void <B>setPropertyResolver</B>(<A HREF="../../../javax/faces/el/PropertyResolver.html" title="class in javax.faces.el">PropertyResolver</A>&nbsp;resolver)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>The recommended way to affect the execution of the EL
 is to provide an <code>&lt;el-resolver&gt;</code> element at the
 right place in the application configuration resources which will
 be considered in the normal course of expression evaluation.
 This method now will cause the argument <code>resolver</code> to
 be wrapped inside an implementation of <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el"><CODE>ELResolver</CODE></A> and
 exposed to the EL resolution system as if the user had called
 <A HREF="../../../javax/faces/application/Application.html#addELResolver(javax.el.ELResolver)"><CODE>addELResolver(javax.el.ELResolver)</CODE></A>.</I>
<P>
<DD><p>Set the <A HREF="../../../javax/faces/el/PropertyResolver.html" title="class in javax.faces.el"><CODE>PropertyResolver</CODE></A> instance that will be utilized
 to resolve method and value bindings.</p>

 <p>This method is now deprecated but the implementation must
 cause the argument to be set as the head of the legacy
 <code>PropertyResolver</code> chain, replacing any existing value
 that was set from the application configuration resources.</p>

  <p>It is illegal to call this method after
 the application has received any requests from the client.  If an
 attempt is made to register a listener after that time it must have
 no effect. </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resolver</CODE> - The new <A HREF="../../../javax/faces/el/PropertyResolver.html" title="class in javax.faces.el"><CODE>PropertyResolver</CODE></A> instance
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>resolver</code>
  is <code>null</code>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if called after the first
 request to the <A HREF="../../../javax/faces/webapp/FacesServlet.html" title="class in javax.faces.webapp"><CODE>FacesServlet</CODE></A> has been
 serviced.</DL>
</DD>
</DL>
<HR>

<A NAME="getResourceBundle(javax.faces.context.FacesContext, java.lang.String)"><!-- --></A><H3>
getResourceBundle</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/ResourceBundle.html" title="class or interface in java.util">ResourceBundle</A> <B>getResourceBundle</B>(<A HREF="../../../javax/faces/context/FacesContext.html" title="class in javax.faces.context">FacesContext</A>&nbsp;ctx,
                                        <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;name)</PRE>
<DL>
<DD><p>Find a <code>ResourceBundle</code> as defined in the
 application configuration resources under the specified name.  If
 a <code>ResourceBundle</code> was defined for the name, return an
 instance that uses the locale of the current <A HREF="../../../javax/faces/component/UIViewRoot.html" title="class in javax.faces.component"><CODE>UIViewRoot</CODE></A>.</p>

 <p>The default implementation throws 
 <code>UnsupportedOperationException</code> and is provided
 for the sole purpose of not breaking existing applications that extend
 this class.</p>
<P>
<DD><DL>

<DT><B>Returns:</B><DD><code>ResourceBundle</code> for the current UIViewRoot,
 otherwise null
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/faces/FacesException.html" title="class in javax.faces">FacesException</A></CODE> - if a bundle was defined, but not resolvable
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if ctx == null || name == null<DT><B>Since:</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getVariableResolver()"><!-- --></A><H3>
getVariableResolver</H3>
<PRE>
public abstract <A HREF="../../../javax/faces/el/VariableResolver.html" title="class in javax.faces.el">VariableResolver</A> <B>getVariableResolver</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>This has been replaced by <A HREF="../../../javax/faces/application/Application.html#getELResolver()"><CODE>getELResolver()</CODE></A>.</I>
<P>
<DD><p>Return the <A HREF="../../../javax/faces/el/VariableResolver.html" title="class in javax.faces.el"><CODE>VariableResolver</CODE></A> that wraps the <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el"><CODE>ELResolver</CODE></A> instance that Faces provides to the unified EL for
 the resolution of expressions that appear programmatically in an
 application.  The implementation of the
 <code>VariableResolver</code>must pass <code>null</code> as the
 base argument for any methods invoked on the underlying
 <code>ELResolver</code>.</p>

 <p>Note that this method no longer returns the default
 <code>VariableResolver</code>, since that class now is a no-op
 that aids in allowing custom <code>VariableResolver</code>s to
 affect the EL resolution process.</p>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setVariableResolver(javax.faces.el.VariableResolver)"><!-- --></A><H3>
setVariableResolver</H3>
<PRE>
public abstract void <B>setVariableResolver</B>(<A HREF="../../../javax/faces/el/VariableResolver.html" title="class in javax.faces.el">VariableResolver</A>&nbsp;resolver)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>The recommended way to affect the execution of the EL
 is to provide an <code>&lt;el-resolver&gt;</code> element at the

 right place in the application configuration resources which will
 be considered in the normal course of expression evaluation.
 This method now will cause the argument <code>resolver</code> to
 be wrapped inside an implementation of <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el"><CODE>ELResolver</CODE></A> and
 exposed to the EL resolution system as if the user had called
 <A HREF="../../../javax/faces/application/Application.html#addELResolver(javax.el.ELResolver)"><CODE>addELResolver(javax.el.ELResolver)</CODE></A>.</I>
<P>
<DD><p>Set the <A HREF="../../../javax/faces/el/VariableResolver.html" title="class in javax.faces.el"><CODE>VariableResolver</CODE></A> instance that will be consulted
 to resolve method and value bindings.</p>

 <p>This method is now deprecated but the implementation must
 cause the argument to be set as the head of the legacy
 <code>VariableResolver</code> chain, replacing any existing value
 that was set from the application configuration resources.</p>

  <p>It is illegal to call this method after
 the application has received any requests from the client.  If an
 attempt is made to register a listener after that time it must have 
 no effect.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resolver</CODE> - The new <A HREF="../../../javax/faces/el/VariableResolver.html" title="class in javax.faces.el"><CODE>VariableResolver</CODE></A> instance
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - if <code>resolver</code>
  is <code>null</code>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if called after the first
 request to the <A HREF="../../../javax/faces/webapp/FacesServlet.html" title="class in javax.faces.webapp"><CODE>FacesServlet</CODE></A> has been
 serviced.</DL>
</DD>
</DL>
<HR>

<A NAME="addELResolver(javax.el.ELResolver)"><!-- --></A><H3>
addELResolver</H3>
<PRE>
public void <B>addELResolver</B>(<A HREF="../../../javax/el/ELResolver.html" title="class in javax.el">ELResolver</A>&nbsp;resolver)</PRE>
<DL>
<DD><p>Cause an the argument <code>resolver</code> to be added to the
 resolver chain as specified in section 5.5.1 of the JavaServer
 Faces Specification.</p>

 <p>It is not possible to remove an <code>ELResolver</code>
 registered with this method, once it has been registered.</p>

  <p>It is illegal to register an <code>ELResolver</code> after
 the application has received any requests from the client.  If an
 attempt is made to register a listener after that time, an
 <code>IllegalStateException</code> must be thrown. This restriction is
 in place to allow the JSP container to optimize for the common
 case where no additional <code>ELResolver</code>s are in the
 chain, aside from the standard ones. It is permissible to add
 <code>ELResolver</code>s before or after initialization to a
 <code>CompositeELResolver</code> that is already in the
 chain.</p>

 <p>The default implementation throws 
 <code>UnsupportedOperationException</code> and is provided
 for the sole purpose of not breaking existing applications that extend
 <A HREF="../../../javax/faces/application/Application.html" title="class in javax.faces.application"><CODE>Application</CODE></A>.</p>
<P>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getELResolver()"><!-- --></A><H3>
getELResolver</H3>
<PRE>
public <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el">ELResolver</A> <B>getELResolver</B>()</PRE>
<DL>
<DD><p>Return the singleton <A HREF="../../../javax/el/ELResolver.html" title="class in javax.el"><CODE>ELResolver</CODE></A> instance to be used
 for all EL resolution.  This is actually an instance of <A HREF="../../../javax/el/CompositeELResolver.html" title="class in javax.el"><CODE>CompositeELResolver</CODE></A> that must contain the following
 <code>ELResolver</code> instances in the following order:</p>

        <ol>

          <li><p><code>ELResolver</code> instances declared using the
          &lt;el-resolver&gt; element in the application configuration
          resources.  </p></