avax.faces-api.2.3.source-code.web-facesconfig_2_2.xsd Maven / Gradle / Ivy
Show all versions of javax.faces-api Show documentation
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
Copyright (c) 2011 - 2013 Oracle and/or its affiliates. All rights reserved.
The contents of this file are subject to the terms of either the GNU
General Public License Version 2 only ("GPL") or the Common Development
and Distribution License("CDDL") (collectively, the "License"). You
may not use this file except in compliance with the License. You can
obtain a copy of the License at
https://glassfish.java.net/public/CDDL+GPL_1_1.html
or packager/legal/LICENSE.txt. See the License for the specific
language governing permissions and limitations under the License.
When distributing the software, include this License Header Notice in each
file and include the License file at packager/legal/LICENSE.txt.
GPL Classpath Exception:
Oracle designates this particular file as subject to the "Classpath"
exception as provided by Oracle in the GPL Version 2 section of the License
file that accompanied this code.
Modifications:
If applicable, add the following below the License Header, with the fields
enclosed by brackets [] replaced by your own identifying information:
"Portions Copyright [year] [name of copyright owner]"
Contributor(s):
If you wish your version of this file to be governed by only the CDDL or
only the GPL Version 2, indicate your decision by adding "[Contributor]
elects to include this software in this distribution under the [CDDL or GPL
Version 2] license." If you don't indicate a single choice of license, a
recipient has the option to distribute your version of this file under
either the CDDL, the GPL Version 2 or to extend the choice of license to
its licensees as provided above. However, if you add GPL Version 2 code
and therefore, elected the GPL Version 2 license, then the option applies
only if the new code is made subject to such option by the copyright
holder.
The XML Schema for the JavaServer Faces Application
Configuration File (Version 2.2).
All JavaServer Faces configuration files must indicate
the JavaServer Faces schema by indicating the JavaServer
Faces namespace:
http://xmlns.jcp.org/xml/ns/javaee
and by indicating the version of the schema by
using the version element as shown below:
<faces-config xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="..."
version="2.2">
...
</faces-config>
The instance documents may indicate the published
version of the schema using xsi:schemaLocation attribute
for javaee namespace with the following location:
http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd
]]>
The "faces-config" element is the root of the configuration
information hierarchy, and contains nested elements for all
of the other configuration settings.
]]>
Behavior IDs must be unique within a document.
]]>
Converter IDs must be unique within a document.
]]>
'converter-for-class' element values must be unique
within a document.
]]>
Validator IDs must be unique within a document.
]]>
Managed bean names must be unique within a document.
]]>
The "faces-config" element is the root of the configuration
information hierarchy, and contains nested elements for all
of the other configuration settings.
]]>
The "name" element
within the top level "faces-config"
element declares the name of this application
configuration resource. Such names are used
in the document ordering scheme specified in section
JSF.11.4.6.
This value is taken to be the
defining document id of any <flow-definition> elements
defined in this Application Configuration Resource file. If this
element is not specified, the runtime must take the empty string
as its value.
]]>
Extension element for faces-config. It may contain
implementation specific content.
]]>
Please see section JSF.11.4.6 for the specification of this element.
]]>
This element contains a sequence of "id" elements, each of which
refers to an application configuration resource by the "id"
declared on its faces-config element. This element can also contain
a single "others" element which specifies that this document comes
before or after other documents within the application.
]]>
This element indicates that the ordering sub-element in which
it was placed should take special action regarding the ordering
of this application resource relative to other
application configuration resources. See section JSF.11.4.6
for the complete specification.
]]>
Only relevant if this is placed within the /WEB-INF/faces-config.xml.
Please see section JSF.11.4.6 for the specification for details.
]]>
The "application" element provides a mechanism to define the
various per-application-singleton implementation artifacts for
a particular web application that is utilizing
JavaServer Faces. For nested elements that are not specified,
the JSF implementation must provide a suitable default.
]]>
The "action-listener" element contains the fully
qualified class name of the concrete
ActionListener implementation class that will be
called during the Invoke Application phase of the
request processing lifecycle.
]]>
The "default-render-kit-id" element allows the
application to define a renderkit to be used other
than the standard one.
]]>
The base name of a resource bundle representing
the message resources for this application. See
the JavaDocs for the "java.util.ResourceBundle"
class for more information on the syntax of
resource bundle names.
]]>
The "navigation-handler" element contains the
fully qualified class name of the concrete
NavigationHandler implementation class that will
be called during the Invoke Application phase
of the request processing lifecycle, if the
default ActionListener (provided by the JSF
implementation) is used.
]]>
The "view-handler" element contains the fully
qualified class name of the concrete ViewHandler
implementation class that will be called during
the Restore View and Render Response phases of the
request processing lifecycle. The faces
implementation must provide a default
implementation of this class.
]]>
The "state-manager" element contains the fully
qualified class name of the concrete StateManager
implementation class that will be called during
the Restore View and Render Response phases of the
request processing lifecycle. The faces
implementation must provide a default
implementation of this class.
]]>
The "el-resolver" element contains the fully
qualified class name of the concrete
javax.el.ELResolver implementation class
that will be used during the processing of
EL expressions.
]]>
The "property-resolver" element contains the fully
qualified class name of the concrete
PropertyResolver implementation class that will
be used during the processing of value binding
expressions.
]]>
The "variable-resolver" element contains the fully
qualified class name of the concrete
VariableResolver implementation class that will
be used during the processing of value binding
expressions.
]]>
The "resource-handler" element contains the
fully qualified class name of the concrete
ResourceHandler implementation class that
will be used during rendering and decoding
of resource requests The standard
constructor based decorator pattern used for
other application singletons will be
honored.
]]>
The "resource-library-contracts" element
specifies the mappings between views in the application and resource
library contracts that, if present in the application, must be made
available for use as templates of the specified views.
]]>
The resource-bundle element inside the application element
references a java.util.ResourceBundle instance by name
using the var element. ResourceBundles referenced in this
manner may be returned by a call to
Application.getResourceBundle() passing the current
FacesContext for this request and the value of the var
element below.
]]>
The fully qualified class name of the
java.util.ResourceBundle instance.
]]>
The name by which this ResourceBundle instance
is retrieved by a call to
Application.getResourceBundle().
]]>
The "resource-library-contracts" element
specifies the mappings between views in the application and resource
library contracts that, if present in the application, must be made
available for use as templates of the specified views.
]]>
Declare a mapping between a collection
of views in the application and the list of contracts (if present in the application)
that may be used as a source for templates and resources for those views.
]]>
The "contract-mapping" element
specifies the mappings between a collection of views in the application and resource
library contracts that, if present in the application, must be made
available for use as templates of the specified views.
]]>
The "url-pattern" element
specifies the collection of views in this application that
are allowed to use the corresponding contracts.
]]>
The "contracts" element
is a comma separated list of resource library contracts that,
if available to the application, may be used by the views
matched by the corresponding "url-pattern"
]]>
Extension element for application. It may contain
implementation specific content.
]]>
The "factory" element provides a mechanism to define the
various Factories that comprise parts of the implementation
of JavaServer Faces. For nested elements that are not
specified, the JSF implementation must provide a suitable
default.
]]>
The "application-factory" element contains the
fully qualified class name of the concrete
ApplicationFactory implementation class that will
be called when
FactoryFinder.getFactory(APPLICATION_FACTORY) is
called.
]]>
The "exception-handler-factory" element contains the
fully qualified class name of the concrete
ExceptionHandlerFactory implementation class that will
be called when
FactoryFinder.getFactory(EXCEPTION_HANDLER_FACTORY)
is called.
]]>
The "external-context-factory" element contains the
fully qualified class name of the concrete
ExternalContextFactory implementation class that will
be called when
FactoryFinder.getFactory(EXTERNAL_CONTEXT_FACTORY)
is called.
]]>
The "faces-context-factory" element contains the
fully qualified class name of the concrete
FacesContextFactory implementation class that will
be called when
FactoryFinder.getFactory(FACES_CONTEXT_FACTORY)
is called.
]]>
The "facelet-cache-factory" element contains the
fully qualified class name of the concrete
FaceletCacheFactory implementation class that will
be called when
FactoryFinder.getFactory(FACELET_CACHE_FACTORY)
is called.
]]>
The "partial-view-context-factory" element contains the
fully qualified class name of the concrete
PartialViewContextFactory implementation class that will
be called when FactoryFinder.getFactory
(FactoryFinder.PARTIAL_VIEW_CONTEXT_FACTORY) is called.
]]>
The "lifecycle-factory" element contains the fully
qualified class name of the concrete LifecycleFactory
implementation class that will be called when
FactoryFinder.getFactory(LIFECYCLE_FACTORY) is called.
]]>
The "view-declaration-language-factory" element contains
the fully qualified class name of the concrete
ViewDeclarationLanguageFactory
implementation class that will be called when
FactoryFinder.getFactory(VIEW_DECLARATION_FACTORY) is called.
]]>
The "tag-handler-delegate-factory" element contains
the fully qualified class name of the concrete
ViewDeclarationLanguageFactory
implementation class that will be called when
FactoryFinder.getFactory(TAG_HANDLER_DELEGATE_FACTORY) is called.
]]>
The "render-kit-factory" element contains the fully
qualified class name of the concrete RenderKitFactory
implementation class that will be called when
FactoryFinder.getFactory(RENDER_KIT_FACTORY) is
called.
]]>
The "visit-context-factory" element contains the fully
qualified class name of the concrete VisitContextFactory
implementation class that will be called when
FactoryFinder.getFactory(VISIT_CONTEXT_FACTORY) is
called.
]]>
The "flash-factory" element contains the
fully qualified class name of the concrete
FaceletFactory implementation class that will
be called when
FactoryFinder.getFactory(FLASH_FACTORY) is
called.
]]>
The "flow-handler-factory" element contains the
fully qualified class name of the concrete
FlowHandlerFactory implementation class that will
be called when
FactoryFinder.getFactory(FLOW_HANDLER_FACTORY) is
called.
]]>
Extension element for factory. It may contain
implementation specific content.
]]>
The "attribute" element represents a named, typed, value
associated with the parent UIComponent via the generic
attributes mechanism.
Attribute names must be unique within the scope of the parent
(or related) component.
]]>
The "attribute-name" element represents the name under
which the corresponding value will be stored, in the
generic attributes of the UIComponent we are related
to.
]]>
The "attribute-class" element represents the Java type
of the value associated with this attribute name.
]]>
Extension element for attribute. It may contain
implementation specific content.
]]>
The "component" element represents a concrete UIComponent
implementation class that should be registered under the
specified type identifier, along with its associated
properties and attributes. Component types must be unique
within the entire web application.
Nested "attribute" elements identify generic attributes that
are recognized by the implementation logic of this component.
Nested "property" elements identify JavaBeans properties of
the component class that may be exposed for manipulation
via tools.
]]>
The "component-type" element represents the name under
which the corresponding UIComponent class should be
registered.
]]>
The "component-class" element represents the fully
qualified class name of a concrete UIComponent
implementation class.
]]>
Extension element for component. It may contain
implementation specific content.
]]>
The "default-locale" element declares the default locale
for this application instance.
It must be specified as :language:[_:country:[_:variant:]]
without the colons, for example "ja_JP_SJIS". The
separators between the segments may be '-' or '_'.
]]>
The "default-value" contains the value for the property or
attribute in which this element resides. This value differs
from the "suggested-value" in that the property or attribute
must take the value, whereas in "suggested-value" taking the
value is optional.
]]>
EL expressions present within a faces config file
must start with the character sequence of '#{' and
end with '}'.
]]>
Define the name and other design-time information for a facet
that is associated with a renderer or a component.
]]>
The "facet-name" element represents the facet name
under which a UIComponent will be added to its parent.
It must be of type "Identifier".
]]>
Extension element for facet. It may contain implementation
specific content.
]]>
The
value of from-view-id must contain one of the following
values:
The exact match for a view identifier that is recognized
by the the ViewHandler implementation being used (such as
"/index.jsp" if you are using the default ViewHandler).
The exact match of a flow node id
in the current flow, or a flow id of another flow.
A proper prefix of a view identifier, plus a trailing
"*" character. This pattern indicates that all view
identifiers that match the portion of the pattern up to the
asterisk will match the surrounding rule. When more than one
match exists, the match with the longest pattern is selected.
An "*" character, which means that this pattern applies
to all view identifiers.
]]>
The "from-action" element contains an action reference
expression that must have been executed (by the default
ActionListener for handling application level events)
in order to select the navigation rule. If not specified,
this rule will be relevant no matter which action reference
was executed (or if no action reference was executed).
]]>
The "if" element defines a condition that must resolve
to true in order for the navigation case on which it is
defined to be matched, with the existing match criteria
(action method and outcome) as a prerequiste, if present.
The condition is defined declaratively using a value
expression in the body of this element. The expression is
evaluated at the time the navigation case is being matched.
If the "from-outcome" is omitted and this element is
present, the navigation handler will match a null outcome
and use the condition return value to determine if the
case should be considered a match.
When used in a <switch>
within a flow, if the
expresion returns true
, the
<from-outcome>
sibling element's outcome is used as
the id of the node in the flow graph to which control must be
passed.
]]>
]]>
The "converter" element represents a concrete Converter
implementation class that should be registered under the
specified converter identifier. Converter identifiers must
be unique within the entire web application.
Nested "attribute" elements identify generic attributes that
may be configured on the corresponding UIComponent in order
to affect the operation of the Converter. Nested "property"
elements identify JavaBeans properties of the Converter
implementation class that may be configured to affect the
operation of the Converter. "attribute" and "property"
elements are intended to allow component developers to
more completely describe their components to tools and users.
These elements have no required runtime semantics.
]]>
The "converter-id" element represents the
identifier under which the corresponding
Converter class should be registered.
]]>
The "converter-for-class" element represents the
fully qualified class name for which a Converter
class will be registered.
]]>
The "converter-class" element represents the fully
qualified class name of a concrete Converter
implementation class.
]]>
Nested "attribute" elements identify generic
attributes that may be configured on the
corresponding UIComponent in order to affect the
operation of the Converter. This attribute is
primarily for design-time tools and is not
specified to have any meaning at runtime.
]]>
Nested "property" elements identify JavaBeans
properties of the Converter implementation class
that may be configured to affect the operation of
the Converter. This attribute is primarily for
design-time tools and is not specified to have
any meaning at runtime.
]]>
Extension element for converter. It may contain
implementation specific content.
]]>
The "lifecycle" element provides a mechanism to specify
modifications to the behaviour of the default Lifecycle
implementation for this web application.
]]>
The "phase-listener" element contains the fully
qualified class name of the concrete PhaseListener
implementation class that will be registered on
the Lifecycle.
]]>
Extension element for lifecycle. It may contain
implementation specific content.
]]>
The localeType defines valid locale defined by ISO-639-1
and ISO-3166.
]]>
The "locale-config" element allows the app developer to
declare the supported locales for this application.
]]>
The "default-validators" element allows the app developer to
register a set of validators, referenced by identifier, that
are automatically assigned to any EditableValueHolder component
in the application, unless overridden or disabled locally.
]]>
The "validator-id" element represents the identifier
of a registered validator.
]]>
The "managed-bean" element represents a JavaBean, of a
particular class, that will be dynamically instantiated
at runtime (by the default VariableResolver implementation)
if it is referenced as the first element of a value binding
expression, and no corresponding bean can be identified in
any scope. In addition to the creation of the managed bean,
and the optional storing of it into the specified scope,
the nested managed-property elements can be used to
initialize the contents of settable JavaBeans properties of
the created instance.
]]>
The "managed-bean-name" element represents the
attribute name under which a managed bean will
be searched for, as well as stored (unless the
"managed-bean-scope" value is "none").
]]>
The "managed-bean-class" element represents the fully
qualified class name of the Java class that will be
used`to instantiate a new instance if creation of the
specified`managed bean is requested.
The specified class must conform to standard JavaBeans
conventions. In particular, it must have a public
zero-arguments constructor, and zero or more public
property setters.
]]>
The "managed-bean-scope" element represents the scope
into which a newly created instance of the specified
managed bean will be stored (unless the value is
"none").
]]>
This attribute is only considered when associated with
an application-scoped managed bean. If the value of the eager
attribute is true the runtime must instantiate this class
and store the instance within the application scope when the
application starts.
If eager is unspecified or is false, the default "lazy"
instantiation and scoped storage of the managed bean
will occur.
]]>
Top level element for a flow
definition.
If there is no <start-node>
element declared, it
is assumed to be <flowName>.xhtml
.
]]>
Declare the id of the starting node in the
flow graph. The start node may be any of the node types mentioned in
the class javadocs for FlowHandler
.
]]>
The id of this flow. The id
must be unique within the Application configuration Resource
file in which this flow is defined. The value of this attribute,
combined with the value of the <faces-config><name> element
must globally identify the flow within the application. ]]>
Invoke a method, passing parameters if necessary.
The return from the method is used as the outcome for where to go next in the
flow. If the method is a void method, the default outcome is used. ]]>
A parameter to pass when calling the method
identified in the "method" element that is a sibling of this element.
]]>
A parameter to pass when calling the method
identified in the "method" element that is a sibling of this element.
]]>
The optional "class" element within a "parameter" element
will be interpreted as the fully qualified class name for the type
of the "value" element.
]]>
The "value" element within an "parameter"
must be a literal string or an EL Expression whose "get" will be called when the "method"
associated with this element is invoked.
]]>
Define a view node in a flow graph.
This element must contain exactly one
<vdl-document>
element.
]]>
Define the vdl-document for the enclosing view.
]]>
The id of this view. It must be
unique within the flow.
]]>
Define a switch node in a flow graph.
This element must contain one or more
<case>
elements. When control passes to the
<switch>
node, each of the cases must be considered
in order and control must past to the <from-outcome>
of the first one whose <if>
expression evaluates to
true
.
]]>
Defines a case that must be
considered in the list of cases in the
<switch>
.
]]>
Defines the default case that will
be taken if none of the other cases in the
<switch>
are taken.
]]>
The id of this switch. It must be
unique within the flow.
]]>
Defines a case that will
be considered in the <switch>
.
]]>
If this EL expression evaluates to
true
, the corresponding from-outcome
will
be the outcome taken by the enclosing <switch>
]]>
The "from-outcome" element contains a logical outcome
string returned by the execution of an application
action method selected via an "actionRef" property
(or a literal value specified by an "action" property)
of a UICommand component. If specified, this rule
will be relevant only if the outcome value matches
this element's value. If not specified, this rule
will be relevant if the outcome value is non-null
or, if the "if" element is present, will be relevant
for any outcome value, with the assumption that the
condition specified in the "if" element ultimately
determines if this rule is a match.
If used in a faces flow, this element
represents the node id to which control will be passed.
]]>
Define a return node in a flow graph.
This element must contain exactly one <from-outcome>
element.
]]>
This element
represents the node id to which control will be passed.
]]>
The id of this flow-return.
]]>
Define a call node in a flow graph.
This element must contain exactly one <flow-reference>
element,
which must contain exactly one <flow-id>
element.
]]>
The flow id of the called flow.
]]>
A parameter to pass when calling the flow
identified in the "flow-reference" element that is a sibling of this element.
]]>
The id of this flow-return.
]]>
Identifiy the called flow.
]]>
The document id of the called flow.
]]>
The id of the called flow.
]]>
A MethodExpression
that will be invoked when the flow is entered.
]]>
A MethodExpression
that will be invoked when the flow is exited.
]]>
A named parameter whose value will be populated
with a correspondingly named parameter within an "outbound-parameter" element.
]]>
The "name" element within an "inbound-parameter"
element declares the name of this parameter
to be passed into a flow. There must be
a sibling "value" element in the same parent as this element.
]]>
The "value" element within an "inbound-parameter"
must be an EL Expression whose value will be set with the correspondingly
named "outbound-parameter" when this flow is entered, if such a
parameter exists.
]]>
A named parameter whose value will be
passed to a correspondingly named parameter within an "inbound-parameter" element
on the target flow.
]]>
The "name" element within an "outbound-parameter" element
declares the name of this parameter to be passed out of a flow. There must be
a sibling "value" element in the same parent as this element.
]]>
The "value" element within an "outbound-parameter"
must be a literal string or an EL Expression whose "get" will be called when the "flow-call"
containing this element is traversed to go to a new flow.
]]>
Extension element for managed-bean. It may contain
implementation specific content.
]]>
Defines the legal values for the
element's body content, which includes all of the scopes
normally used in a web application, plus the "none" value
indicating that a created bean should not be stored into
any scope. Alternatively, an EL expression may be used
as the value of this element. The result of evaluating this
expression must by of type java.util.Map.
]]>
The "managed-property" element represents an individual
property of a managed bean that will be configured to the
specified value (or value set) if the corresponding
managed bean is automatically created.
]]>
The "property-name" element represents the JavaBeans
property name under which the corresponding value may
be stored.
]]>
The "property-class" element represents the Java type
of the value associated with this property name.
If not specified, it can be inferred from existing
classes; however, this element should be specified
if the configuration file is going to be the source
for generating the corresponding classes.
]]>
The "map-entry" element reprsents a single key-entry pair
that will be added to the computed value of a managed
property of type java.util.Map.
]]>
The "key" element is the String representation of a
map key that will be stored in a managed property of
type java.util.Map.
]]>
The "map-entries' element represents a set of key-entry pairs
that will be added to the computed value of a managed property
of type java.util.Map. In addition, the Java class types
of the key and entry values may be optionally declared.
]]>
The "key-class" element defines the Java type to which
each "key" element in a set of "map-entry" elements
will be converted to. If omitted, "java.lang.String"
is assumed.
]]>
The
"navigation-case" element describes a particular
combination of conditions that must match for this case to
be executed, and the view id of the component tree that
should be selected next.
]]>
The "from-outcome" element contains a logical outcome
string returned by the execution of an application
action method selected via an "actionRef" property
(or a literal value specified by an "action" property)
of a UICommand component. If specified, this rule
will be relevant only if the outcome value matches
this element's value. If not specified, this rule
will be relevant if the outcome value is non-null
or, if the "if" element is present, will be relevant
for any outcome value, with the assumption that the
condition specified in the "if" element ultimately
determines if this rule is a match.
]]>
Please see section JSF.7.4.2 for the specification of this element.
]]>
The "to-view-id" element
contains the view identifier (or
flow node id, or flow id)
of the next view (or flow node or
flow) that should be displayed if this
navigation rule is matched. If the contents is a
value expression, it should be resolved by the
navigation handler to obtain the view (
or flow node or flow)
identifier.
]]>
The document id of the called flow.
If this element appears in a <navigation-case> nested within
a <flow-definition>, it must be ignored because navigation
cases within flows may only navigate among the view nodes of that
flow.
]]>
The "navigation-rule" element represents an individual
decision rule that will be utilized by the default
NavigationHandler implementation to make decisions on
what view should be displayed next, based on the
view id being processed.
]]>
Extension element for navigation-rule. It may contain
implementation specific content.
]]>
The "null-value" element indicates that the managed
property in which we are nested will be explicitly
set to null if our managed bean is automatically
created. This is different from omitting the managed
property element entirely, which will cause no
property setter to be called for this property.
The "null-value" element can only be used when the
associated "property-class" identifies a Java class,
not a Java primitive.
]]>
The "property" element represents a JavaBean property of the
Java class represented by our parent element.
Property names must be unique within the scope of the Java
class that is represented by the parent element, and must
correspond to property names that will be recognized when
performing introspection against that class via
java.beans.Introspector.
]]>
The "property-name" element represents the JavaBeans
property name under which the corresponding value
may be stored.
]]>
The "property-class" element represents the Java type
of the value associated with this property name.
If not specified, it can be inferred from existing
classes; however, this element should be specified if
the configuration file is going to be the source for
generating the corresponding classes.
]]>
Any view that matches any of the
url-patterns in this element may only be reached from another JSF
view in the same web application. Because the runtime is aware of
which views are protected, any navigation from an unprotected
view to a protected view is automatically subject to
protection.
]]>
Extension element for property. It may contain
implementation specific content.
]]>
The "redirect" element indicates that navigation to the
specified "to-view-id" should be accomplished by
performing an HTTP redirect rather than the usual
ViewHandler mechanisms.
]]>
This element was introduced due to a specification
error, and is now deprecated. The correct name for
this element is "redirect-param" and its meaning is
documented therein. The "view-param" element is
maintained to preserve backwards compatibility.
Implementations must treat this element the same as
"redirect-param".
]]>
The "redirect-param" element, only valid within
a "redirect" element, contains child "name"
and "value" elements that must be included in the
redirect url when the redirect is performed.
]]>
The "referenced-bean" element represents at design time the
promise that a Java object of the specified type will exist at
runtime in some scope, under the specified key. This can be
used by design time tools to construct user interface dialogs
based on the properties of the specified class. The presence
or absence of a referenced bean element has no impact on the
JavaServer Faces runtime environment inside a web application.
]]>
The "referenced-bean-name" element represents the
attribute name under which the corresponding
referenced bean may be assumed to be stored, in one
of 'request', 'session', 'view', 'application'
or a custom scope.
]]>
The "referenced-bean-class" element represents the
fully qualified class name of the Java class
(either abstract or concrete) or Java interface
implemented by the corresponding referenced bean.
]]>
The "render-kit" element represents a concrete RenderKit
implementation that should be registered under the specified
render-kit-id. If no render-kit-id is specified, the
identifier of the default RenderKit
(RenderKitFactory.DEFAULT_RENDER_KIT) is assumed.
]]>
The "render-kit-id" element represents an identifier
for the RenderKit represented by the parent
"render-kit" element.
]]>
The "render-kit-class" element represents the fully
qualified class name of a concrete RenderKit
implementation class.
]]>
The "client-behavior-renderer" element represents a concrete
ClientBehaviorRenderer implementation class that should be
registered under the specified behavior renderer type identifier,
in the RenderKit associated with the parent "render-kit"
element. Client Behavior renderer type must be unique within the RenderKit
associated with the parent "render-kit" element.
Nested "attribute" elements identify generic component
attributes that are recognized by this renderer.
]]>
The "client-behavior-renderer-type" element represents a renderer type
identifier for the Client Behavior Renderer represented by the parent
"client-behavior-renderer" element.
]]>
The "client-behavior-renderer-class" element represents the fully
qualified class name of a concrete Client Behavior Renderer
implementation class.
]]>
The "renderer" element represents a concrete Renderer
implementation class that should be registered under the
specified component family and renderer type identifiers,
in the RenderKit associated with the parent "render-kit"
element. Combinations of component family and
renderer type must be unique within the RenderKit
associated with the parent "render-kit" element.
Nested "attribute" elements identify generic component
attributes that are recognized by this renderer.
]]>
The "component-family" element represents the
component family for which the Renderer represented
by the parent "renderer" element will be used.
]]>
The "renderer-type" element represents a renderer type
identifier for the Renderer represented by the parent
"renderer" element.
]]>
The "renderer-class" element represents the fully
qualified class name of a concrete Renderer
implementation class.
]]>
Extension element for renderer. It may contain implementation
specific content.
]]>
Extension element for render-kit. It may contain
implementation specific content.
]]>
The "suggested-value" contains the value for the property or
attribute in which this element resides. This value is
advisory only and is intended for tools to use when
populating pallettes.
]]>
The "supported-locale" element allows authors to declare
which locales are supported in this application instance.
It must be specified as :language:[_:country:[_:variant:]]
without the colons, for example "ja_JP_SJIS". The
separators between the segments may be '-' or '_'.
]]>
The "behavior" element represents a concrete Behavior
implementation class that should be registered under the
specified behavior identifier. Behavior identifiers must
be unique within the entire web application.
Nested "attribute" elements identify generic attributes that
may be configured on the corresponding UIComponent in order
to affect the operation of the Behavior. Nested "property"
elements identify JavaBeans properties of the Behavior
implementation class that may be configured to affect the
operation of the Behavior. "attribute" and "property"
elements are intended to allow component developers to
more completely describe their components to tools and users.
These elements have no required runtime semantics.
]]>
The "behavior-id" element represents the identifier
under which the corresponding Behavior class should
be registered.
]]>
The "behavior-class" element represents the fully
qualified class name of a concrete Behavior
implementation class.
]]>
Nested "attribute" elements identify generic
attributes that may be configured on the
corresponding UIComponent in order to affect the
operation of the Behavior. This attribute is
primarily for design-time tools and is not
specified to have any meaning at runtime.
]]>
Nested "property" elements identify JavaBeans
properties of the Behavior implementation class
that may be configured to affect the operation of
the Behavior. This attribute is primarily for
design-time tools and is not specified to have
any meaning at runtime.
]]>
Extension element for behavior. It may contain
implementation specific content.
]]>
The "validator" element represents a concrete Validator
implementation class that should be registered under the
specified validator identifier. Validator identifiers must
be unique within the entire web application.
Nested "attribute" elements identify generic attributes that
may be configured on the corresponding UIComponent in order
to affect the operation of the Validator. Nested "property"
elements identify JavaBeans properties of the Validator
implementation class that may be configured to affect the
operation of the Validator. "attribute" and "property"
elements are intended to allow component developers to
more completely describe their components to tools and users.
These elements have no required runtime semantics.
]]>
The "validator-id" element represents the identifier
under which the corresponding Validator class should
be registered.
]]>
The "validator-class" element represents the fully
qualified class name of a concrete Validator
implementation class.
]]>
Nested "attribute" elements identify generic
attributes that may be configured on the
corresponding UIComponent in order to affect the
operation of the Validator. This attribute is
primarily for design-time tools and is not
specified to have any meaning at runtime.
]]>
Nested "property" elements identify JavaBeans
properties of the Validator implementation class
that may be configured to affect the operation of
the Validator. This attribute is primarily for
design-time tools and is not specified to have
any meaning at runtime.
]]>
Extension element for validator. It may contain
implementation specific content.
]]>
The "value" element is the String representation of
a literal value to which a scalar managed property
will be set, or a value binding expression ("#{...}")
that will be used to calculate the required value.
It will be converted as specified for the actual
property type.
]]>
The "value-class" element defines the Java type to which each
"value" element's value will be converted to, prior to adding
it to the "list-entries" list for a managed property that is
a java.util.List, or a "map-entries" map for a managed
property that is a java.util.Map.
]]>
The "list-entries" element represents a set of initialization
elements for a managed property that is a java.util.List or an
array. In the former case, the "value-class" element can
optionally be used to declare the Java type to which each
value should be converted before adding it to the Collection.
]]>
The presence of this element within the "application" element in
an application configuration resource file indicates the
developer wants to add an SystemEventListener to this
application instance. Elements nested within this element allow
selecting the kinds of events that will be delivered to the
listener instance, and allow selecting the kinds of classes that
can be the source of events that are delivered to the listener
instance.
]]>
The "system-event-listener-class" element contains
the fully qualified class name of the concrete
SystemEventListener implementation class that will be
called when events of the type specified by the
"system-event-class" are sent by the runtime.
]]>
The "system-event-class" element contains the fully
qualified class name of the SystemEvent subclass for
which events will be delivered to the class whose fully
qualified class name is given by the
"system-event-listener-class" element.
]]>
The "source-class" element, if present, contains the
fully qualified class name of the class that will be the
source for the event to be delivered to the class whose
fully qualified class name is given by the
"system-event-listener-class" element.
]]>
This type contains the recognized versions of
faces-config supported.
]]>