diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/beans_1_1.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/beans_1_1.xsd index 79316a0..d632c17 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/beans_1_1.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/beans_1_1.xsd @@ -140,7 +140,7 @@ - + element allows exclusion of classes and packages from consideration. Various filters may be applied, and may be conditionally activated.]]> @@ -148,7 +148,7 @@ - + would exclude all classes and subpackages of com.acme.]]> @@ -156,14 +156,30 @@ - + - + + + + + + + + + + + + + + + + + @@ -172,21 +188,21 @@ - + - + - + @@ -196,7 +212,7 @@ - + would exclude all classes and subpackages of com.acme.]]> diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/ejb-jar_3_2.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/ejb-jar_3_2.xsd index 6863368..62e9ffd 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/ejb-jar_3_2.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/ejb-jar_3_2.xsd @@ -461,6 +461,8 @@ cmp-version 1.x must denote a public field of the enterprise bean class or one of its superclasses. + Support for entity beans is optional as of EJB 3.2. + @@ -484,6 +486,8 @@ 1.x 2.x + + Support for entity beans is optional as of EJB 3.2. @@ -511,6 +515,8 @@ used only for collection-valued cmr-fields. It specifies the type of the collection that is used. + Support for entity beans is optional as of EJB 3.2. + @@ -530,6 +536,8 @@ whose names consist of the name of the field specified by cmr-field-name in which the first letter is uppercased, prefixed by "get" or "set". + + Support for entity beans is optional as of EJB 3.2. @@ -923,6 +931,8 @@ relationship, if specified, is unique within the ejb-jar file. + Support for entity beans is optional as of EJB 3.2. + @@ -995,6 +1005,8 @@ + Support for entity beans is optional as of EJB 3.2. + ]]> @@ -1033,6 +1045,8 @@ element contained in an ejb-relation element in which the other ejb-relationship-role element specifies a multiplicity of One. + + Support for entity beans is optional as of EJB 3.2. @@ -1364,6 +1378,8 @@ + Support for entity beans is optional as of EJB 3.2. + The entity-beanType declares an entity bean. The declaration consists of: @@ -1492,6 +1508,8 @@ deferred to deployment time, the prim-key-class element should specify java.lang.Object. + Support for entity beans is optional as of EJB 3.2. + @@ -1526,6 +1544,8 @@ bean whose local interface is com.acme.commerce.Order might be Order. + Support for entity beans is optional as of EJB 3.2. + @@ -1553,6 +1573,8 @@ fields of the primary key class must be public, and their names must correspond to the field names of the entity bean class that comprise the key. + + Support for entity beans is optional as of EJB 3.2. @@ -1716,6 +1738,10 @@ type="javaee:around-timeoutType" minOccurs="0" maxOccurs="unbounded"/> + @@ -2144,6 +2179,7 @@ name. This style may be used to refer to stateful session bean + PostConstruct, PreDestroy, PrePassivate, and PostActivate lifecycle callback methods to specify their transaction attributes if any of the following is true: there is only one method with this name in the specified @@ -2360,8 +2396,10 @@ MessageEndpoint refers to the methods of a message-driven bean's message-listener interface. - LifecycleCallback refers to the lifecycle callback methods of - a singleton or stateful session bean. + LifecycleCallback refers to the PostConstruct and PreDestroy + lifecycle callback methods of a singleton session bean and + to the PostConstruct, PreDestroy, PrePassivate, and PostActivate + lifecycle callback methods of a stateful session bean. The method-intf element must be one of the following: @@ -2455,12 +2493,18 @@ indicator to state that the method is unchecked for authorization, and a list of method elements. - The security roles used in the method-permissionType - must be defined in the security-role elements of the - deployment descriptor, and the methods must be methods - defined in the enterprise bean's no-interface view, - business, home, component and/or web service endpoint - interfaces. + Except as noted below the security roles used in the + method-permissionType must be defined in the security-role + elements of the deployment descriptor, and the methods + must be methods defined in the enterprise bean's no-interface + view, business, home, component and/or web service endpoint + interfaces. + + If the role name "**" is included in the list of allowed + roles, and the application has not defined in its deployment + descriptor an application security role with this name, + then the list of allowed roles includes every and any + authenticated user. @@ -2509,6 +2553,8 @@ One Many + Support for entity beans is optional as of EJB 3.2. + @@ -2533,6 +2579,8 @@ Bean Container + + Support for entity beans is optional as of EJB 3.2. @@ -2622,6 +2670,8 @@ + Support for entity beans is optional as of EJB 3.2. + ]]> @@ -2647,6 +2697,8 @@ relationship-role-sourceType is used by relationship-role-source elements to uniquely identify an entity bean. + + Support for entity beans is optional as of EJB 3.2. @@ -2675,6 +2727,8 @@ description; and a list of ejb-relation elements, which specify the container managed relationships. + Support for entity beans is optional as of EJB 3.2. + diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/javaee_7.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/javaee_7.xsd index 72ea7a1..f9fdb31 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/javaee_7.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/javaee_7.xsd @@ -368,13 +368,13 @@ - - The fully qualified domain name of the connection factory - interface class. + The fully qualified class name of the connection factory + interface. @@ -1376,13 +1376,30 @@ + + + + + Fully-qualified name of the JMS connection factory + interface. Permitted values are javax.jms.ConnectionFactory, + javax.jms.QueueConnectionFactory, or + javax.jms.TopicConnectionFactory. If not specified, + javax.jms.ConnectionFactory will be used. + + + + - javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory, or javax.jms.TopicConnectionFactory + Fully-qualified name of the JMS connection factory + implementation class. Ignored if a resource adapter + is used. @@ -1393,7 +1410,9 @@ - Resource adapter name. + Resource adapter name. If not specified, the application + server will define the default behavior, which may or may + not involve the use of a resource adapter. @@ -1519,13 +1538,27 @@ + + + + + Fully-qualified name of the JMS destination interface. + Permitted values are javax.jms.Queue and javax.jms.Topic + + + + - javax.jms.Queue or javax.jms.Topic + Fully-qualified name of the JMS destination implementation + class. Ignored if a resource adapter is used unless the + resource adapter defines more than one destination implementation + class for the specified interface. @@ -1536,7 +1569,9 @@ - Resource adapter name. + Resource adapter name. If not specified, the application + server will define the default behavior, which may or may + not involve the use of a resource adapter. diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-app_3_1.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-app_3_1.xsd index 2964573..898f1b3 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-app_3_1.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-app_3_1.xsd @@ -269,4 +269,58 @@ + + + + + + + + + + + + When specified, this element causes uncovered http methods + to be denied. For every url-pattern that is the target of a + security-constrant, this element causes all HTTP methods that + are NOT covered (by a security constraint) at the url-pattern + to be denied. + + + + + + + + + + + + + + + + + Please see section 8.2.2 of the specification for details. + + + + + + + + + diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-common_3_1.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-common_3_1.xsd index 0f54557..01b3948 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-common_3_1.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-common_3_1.xsd @@ -191,37 +191,6 @@ - - - - - - - - - - - - - - - - - - - - - - - - @@ -1017,9 +986,12 @@ Specifies whether any session tracking cookies created - by this web application will be marked as secure - even if the request that initiated the corresponding session - is using plain HTTP instead of HTTPS + by this web application will be marked as secure. + When true, all session tracking cookies must be marked + as secure independent of the nature of the request that + initiated the corresponding session. + When false, the session cookie should only be marked secure + if the request that initiated the session was secure. @@ -1432,83 +1404,6 @@ - - - - - - - - - - Please see section 8.2.2 of the specification for details. - - - - - - - - - - - - - - - - - Please see section 8.2.2 of the specification for details. - - - - - - - - - - - - - - - - - This element contains a sequence of "name" elements, each of - which - refers to an application configuration resource by the "name" - declared on its web.xml fragment. This element can also contain - a single "others" element which specifies that this document - comes - before or after other documents within the application. - See section 8.2.2 of the specification for details. - - - - - - - diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facelettaglibrary_2_2.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facelettaglibrary_2_2.xsd index df140ee..779e014 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facelettaglibrary_2_2.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facelettaglibrary_2_2.xsd @@ -55,28 +55,27 @@ The XML Schema for the Tag Libraries in the JavaServer Faces Standard Facelets View Declaration Language (Facelets VDL) - (Version 2.2). + (Version 2.2).

- JSF 2.2 Facelet Tag Libraries that wish to conform to this - schema must declare it in the following manner. +

JSF 2.2 Facelet Tag Libraries that wish to conform to this + schema must declare it in the following manner.

- + version="2.2"> ... - + </facelet-taglib> - The instance documents may indicate the published +

The instance documents may indicate the published version of the schema using xsi:schemaLocation attribute - for javaee namespace with the following location: + for javaee namespace with the following location:

- http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibary_2_2.xsd +

http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibary_2_2.xsd

]]> @@ -89,44 +88,44 @@ type="javaee:facelet-taglibType"> - + tag-names must be unique within a document. - +

]]> - + Behavior IDs must be unique within a document. - +

]]> - + Converter IDs must be unique within a document. - +

]]> - + Validator IDs must be unique within a document. - +

]]> @@ -138,11 +137,11 @@ - + The top level XML element in a facelet tag library XML file. - +

]]> @@ -152,6 +151,16 @@ + + + + + An advisory short name for usages of tags from this tag library. + +

]]> + + - + Extension element for facelet-taglib. It may contain implementation specific content. - +

]]> - + +

If the tag library XML + file contains individual tag declarations rather than pointing + to a library-class or a declaring a composite-library name, the + individual tags are enclosed in tag elements.

+ + ]]> @@ -247,22 +256,30 @@ - + - The attribute element defines an attribute for the nesting +

The attribute element defines an attribute for the nesting tag. The attribute element may have several subelements - defining: + defining:

- description a description of the attribute +
+ +
description

a description of the attribute +

+ +
name

the name of the attribute +

- name the name of the attribute - - required whether the attribute is required or +
required

whether the attribute is required or optional +

+ +
type

the type of the attribute +

+ +
- type the type of the attribute - - +

]]> @@ -272,15 +289,15 @@ type="javaee:generic-booleanType" minOccurs="0"> - + Defines if the nesting attribute is required or + optional.

- If not present then the default is "false", i.e - the attribute is optional. +

If not present then the default is "false", i.e + the attribute is optional.

- + ]]> @@ -288,26 +305,61 @@ type="javaee:fully-qualified-classType" minOccurs="0"> - + Defines the Java type of the attributes value. If this element is omitted, the expected type is assumed to be - "java.lang.Object". + "java.lang.Object".

- + ]]> - + Defines the method signature for a MethodExpression- - enabled attribute. - - + enabled attribute. The syntax of the method-signature + element is as follows (taken from the function-signature + EBNF in web-jsptaglibrary_2_1.xsd):

+ + + +

MethodSignature ::= ReturnType S MethodName S? '(' S? Parameters? S? ')'

+ +

ReturnType ::= Type

+ +

MethodName ::= Identifier

+ +

Parameters ::= Parameter | ( Parameter S? ',' S? Parameters )

+ +

Parameter ::= Type

+ + + +

Where:

+ +
    + +

  • Type is a basic type or a fully qualified + Java class name (including package name), as per the 'Type' + production in the Java Language Specification, Second Edition, + Chapter 18.

    • + +

  • Identifier is a Java identifier, as per the + 'Identifier' production in the Java Language Specification, + Second Edition, Chapter 18.

    • + +
+ +

Example:

+ +

java.lang.String nickName( java.lang.String, int )

+ +]]> @@ -321,12 +373,12 @@ - + Extension element for tag It may contain implementation specific content. - +

]]> - + If the tag library XML file contains individual function declarations rather than pointing to a library-class or a declaring a composite-library name, the individual functions are enclosed in function elements. - +

]]> @@ -368,12 +420,12 @@ - + Within a tag element, the behavior element encapsulates information specific to a JSF Behavior. - +

]]> @@ -397,12 +449,12 @@ - + Extension element for behavior. It may contain implementation specific content. - +

]]> - + +

Within a tag element, + the component element encapsulates information specific to a JSF + UIComponent.

+ +
+ +

This element must have exactly one of +<component-type>, <resource-id>, +or <handler-class> among its child elements.

+ +
+ + ]]> - - - + + + + A valid resource identifier + as specified in the spec prose document section + 2.6.1.3. For example:

+ +

<resource-id>myCC/ccName.xhtml</resource-id>

+ + ]]> + + + - + Extension element for component It may contain implementation specific content. - +

]]> - + Within a tag element, the converter element encapsulates information specific to a JSF Converter. - +

]]> @@ -504,12 +577,12 @@ - + Extension element for converter It may contain implementation specific content. - +

]]> - + Within a tag element, the validator element encapsulates information specific to a JSF Validator. - +

]]> @@ -555,12 +628,12 @@ - + Extension element for validator It may contain implementation specific content. - +

]]> - + This type contains the recognized versions of facelet-taglib supported. - +

]]> @@ -591,14 +664,14 @@ - + - Defines the canonical name of a tag or attribute being - defined. +

Defines the canonical name of a tag or attribute being + defined.

- The name must conform to the lexical rules for an NCName +

The name must conform to the lexical rules for an NCName

- +

]]> diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facesconfig_2_2.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facesconfig_2_2.xsd index 3d4347f..8127220 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facesconfig_2_2.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-facesconfig_2_2.xsd @@ -1,14 +1,8 @@ - - - - - - + + + + + DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. @@ -49,11 +43,12 @@ holder. - + - The XML Schema for the JavaServer Faces Application Configuration File (Version 2.2).

@@ -89,72 +84,66 @@ - - 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.

+ Validator IDs must be unique within a document.

- ]]> - + ]]> - - Managed bean names must be unique within a document.

+ Managed bean names must be unique within a document.

- ]]> - + ]]> @@ -166,14 +155,13 @@ - - The "faces-config" element is the root of the configuration + The "faces-config" element is the root of the configuration information hierarchy, and contains nested elements for all of the other configuration settings.

- ]]> - + ]]> @@ -183,7 +171,8 @@ type="javaee:faces-config-orderingType"/> + minOccurs="0" + /> + minOccurs="0" + > - - The "name" element - within the top level "faces-config" + 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 @@ -213,8 +203,7 @@ element is not specified, the runtime must take the empty string as its value.

- ]]> - + ]]> - + + ]]> - - Extension element for faces-config. It may contain + Extension element for faces-config. It may contain implementation specific content.

- ]]> - + ]]> - - Please see section JSF.11.4.6 for the specification of this element.

+ Please see section JSF.11.4.6 for the specification of this element.

- ]]> - + ]]> + minOccurs="0" + /> + minOccurs="0" + /> @@ -336,16 +325,15 @@ - - This element contains a sequence of "id" elements, each of which + 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.

- ]]> - + ]]> + minOccurs="0" + /> @@ -365,16 +354,15 @@ - - This element indicates that the ordering sub-element in which + 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.

- ]]> - + ]]> @@ -385,13 +373,12 @@ - - Only relevant if this is placed within the /WEB-INF/faces-config.xml. + 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.

- ]]> - + ]]> @@ -401,7 +388,8 @@ maxOccurs="unbounded"/> + minOccurs="0" + /> @@ -412,68 +400,64 @@ - - The "application" element provides a mechanism to define the + 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 + 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 + 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 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 + 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 @@ -481,16 +465,15 @@ default ActionListener (provided by the JSF implementation) is used.

- ]]> - + ]]> - - The "view-handler" element contains the fully + 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 @@ -498,16 +481,15 @@ implementation must provide a default implementation of this class.

- ]]> - + ]]> - - The "state-manager" element contains the fully + 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 @@ -515,61 +497,57 @@ implementation must provide a default implementation of this class.

- ]]> - + ]]> - - The "el-resolver" element contains the fully + 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 + 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 + 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 + The "resource-handler" element contains the fully qualified class name of the concrete ResourceHandler implementation class that will be used during rendering and decoding @@ -578,23 +556,21 @@ 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-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 + 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 @@ -631,34 +607,31 @@ FacesContext for this request and the value of the var element below.

- ]]> - + ]]> - - The fully qualified class name of the + The fully qualified class name of the java.util.ResourceBundle instance.

- ]]> - + ]]> - - The name by which this ResourceBundle instance + The name by which this ResourceBundle instance is retrieved by a call to Application.getResourceBundle().

- ]]> - + ]]> @@ -666,36 +639,32 @@ type="xsd:ID"/> - - - - - 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-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.

+ 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.

- ]]> - + ]]> @@ -703,21 +672,17 @@ type="xsd:ID"/> - - - - - 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 "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. +

- ]]> - + ]]> @@ -725,50 +690,47 @@ type="javaee:url-patternType" maxOccurs="unbounded"> - - The "url-pattern" element - specifies the collection of views in this application that - are allowed to use the corresponding contracts. -

- - ]]> - - + 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" -

- - ]]> - - + 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 + Extension element for application. It may contain implementation specific content.

- ]]> - + ]]> - - The "factory" element provides a mechanism to define the + 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 + 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 + 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 + 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 + 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 + 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 + 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 + 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 "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 "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 + 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 + 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 + 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 + 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 + Extension element for factory. It may contain implementation specific content.

- ]]> - + ]]> - - The "attribute" element represents a named, typed, value + 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 + 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 + The "attribute-class" element represents the Java type of the value associated with this attribute name.

- ]]> - + ]]> - - Extension element for attribute. It may contain + Extension element for attribute. It may contain implementation specific content.

- ]]> - + ]]> - - The "component" element represents a concrete UIComponent + 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 @@ -1133,35 +1076,32 @@ the component class that may be exposed for manipulation via tools.

- ]]> - + ]]> - - The "component-type" element represents the name under + The "component-type" element represents the name under which the corresponding UIComponent class should be registered.

- ]]> - + ]]> - - The "component-class" element represents the fully + The "component-class" element represents the fully qualified class name of a concrete UIComponent implementation class.

- ]]> - + ]]> - - Extension element for component. It may contain + Extension element for component. It may contain implementation specific content.

- ]]> - + ]]> - - The "default-locale" element declares the default locale + 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 '_'.

- ]]> - + ]]> @@ -1238,16 +1176,15 @@ - - The "default-value" contains the value for the property 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.

- ]]> - + ]]> @@ -1259,14 +1196,13 @@ - - EL expressions present within a faces config file + EL expressions present within a faces config file must start with the character sequence of '#{' and end with '}'.

- ]]> - + ]]> @@ -1278,27 +1214,25 @@ - - Define the name and other design-time information for a facet + 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 + 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 + Extension element for facet. It may contain implementation specific content.

- ]]> - + ]]> - - The - value of from-view-id must contain one of the following + 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).

    • @@ -1353,20 +1286,19 @@

  • 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. -

    • +

  • 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.

    • + +
- - - ]]> - + ]]> @@ -1381,17 +1313,16 @@ - - The "from-action" element contains an action reference + 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).

- ]]> - + ]]> @@ -1406,8 +1337,8 @@ - - 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 @@ -1419,19 +1350,19 @@ 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.

+ +
-
-

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.

- -
- - ]]> - + ]]> @@ -1441,21 +1372,22 @@ - - -

+ +
+ + + +
-
-
- - ]]> - + ]]> @@ -1470,9 +1402,9 @@ - - The "converter" element represents a concrete Converter + 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.

@@ -1487,8 +1419,7 @@ more completely describe their components to tools and users. These elements have no required runtime semantics.

- ]]> - + ]]> @@ -1496,41 +1427,38 @@ - - The "converter-id" element represents the + The "converter-id" element represents the identifier under which the corresponding Converter class should be registered.

- ]]> - + ]]> - - The "converter-for-class" element represents the + 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 + The "converter-class" element represents the fully qualified class name of a concrete Converter implementation class.

- ]]> - + ]]> - - Nested "attribute" elements identify generic + 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 + 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 + Extension element for converter. It may contain implementation specific content.

- ]]> - + ]]> - - The "lifecycle" element provides a mechanism to specify + 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 + 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 + Extension element for lifecycle. It may contain implementation specific content.

- ]]> - + ]]> - - The localeType defines valid locale defined by ISO-639-1 + The localeType defines valid locale defined by ISO-639-1 and ISO-3166.

- ]]> - + ]]> @@ -1684,13 +1605,12 @@ - - The "locale-config" element allows the app developer to + 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 + 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 + The "validator-id" element represents the identifier of a registered validator.

- ]]> - + ]]> @@ -1745,9 +1663,9 @@ - - The "managed-bean" element represents a JavaBean, of a + 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 @@ -1758,31 +1676,29 @@ initialize the contents of settable JavaBeans properties of the created instance.

- ]]> - + ]]> - - The "managed-bean-name" element represents the + 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 + 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.

@@ -1792,22 +1708,20 @@ zero-arguments constructor, and zero or more public property setters.

- ]]> - + ]]> - - The "managed-bean-scope" element represents the scope + 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").

- ]]> - + ]]> @@ -1829,9 +1743,9 @@ type="xsd:boolean" use="optional"> - - This attribute is only considered when associated with + 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 @@ -1841,59 +1755,63 @@ 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.

- -
- - ]]> - + +
+ +

If there is no <start-node> element declared, it +is assumed to be <flowName>.xhtml.

+ +
+ +]]> + + minOccurs="0" + > - 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.

- - ]]> + + 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.

+ +]]> + + + maxOccurs="unbounded" /> + maxOccurs="unbounded" /> + minOccurs="0" + /> + minOccurs="0" + /> + - - - 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.

- - ]]> - - - - - - - - - - - - - + type="xsd:ID" use="required"> - A parameter to pass when calling the method - identified in the "method" element that is a sibling of this element.

- - ]]> + + 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.

+ + ]]> + + + + + + + @@ -1975,65 +1910,69 @@ type="xsd:ID"/> + - - - - 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.

+ +]]> + + minOccurs="0" + > - - The optional "class" element within a "parameter" 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.

- ]]> - + ]]> + type="javaee:faces-config-flow-definition-parameter-valueType" + + > - - The "value" element within an "parameter" + 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 a view node in a flow graph.

+ +

This element must contain exactly one +<vdl-document> element.

+ +]]> + @@ -2041,10 +1980,13 @@ type="javaee:java-identifierType"> - Define the vdl-document for the enclosing view.

- - ]]> + + Define the vdl-document for the enclosing view.

+ +]]> + @@ -2052,39 +1994,40 @@ - - - The id of this view. It must be - unique within the flow.

- - ]]> - - + + +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.

- -
- - ]]> + + 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.

+ +
+ +]]> + @@ -2094,26 +2037,33 @@ maxOccurs="unbounded"> - Defines a case that must be - considered in the list of cases in the - <switch>.

- - ]]> + + Defines a case that must be + considered in the list of cases in the + <switch>.

+ +]]> + + minOccurs="0" + > - Defines the default case that will - be taken if none of the other cases in the - <switch> are taken.

- - ]]> + + Defines the default case that will + be taken if none of the other cases in the + <switch> are taken.

+ +]]> + @@ -2121,30 +2071,28 @@ - - - The id of this switch. It must be - unique within the flow.

- - ]]> - - + + +The id of this switch. It must be + unique within the flow.

+ + ]]> + + - - - - + - - Defines a case that will - be considered in the <switch>.

+ Defines a case that will + be considered in the <switch>.

+ - ]]> - + ]]> @@ -2152,22 +2100,21 @@ type="javaee:faces-config-ifType" minOccurs="0"> - - If this EL expression evaluates to - true, the corresponding from-outcome will - be the outcome taken by the enclosing <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 @@ -2180,11 +2127,13 @@ 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.

+ + +]]> -

If used in a faces flow, this element - represents the node id to which control will be passed.

- - ]]> @@ -2193,164 +2142,182 @@ type="xsd:ID"> - - - - + - Define a return node in a flow graph.

- -
- -

This element must contain exactly one <from-outcome> element.

-
- - ]]> + + Define a return node in a flow graph.

+ +
+ +

This element must contain exactly one <from-outcome> element.

+
+ +]]> + + + type="javaee:string" + > - - This element - represents the node id to which control will be passed.

+ This element +represents the node id to which control will be passed.

+ + +]]> - ]]> + - - - The id of this flow-return.

- - ]]> - - + + +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.

-
- - ]]> + + 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.

+
+ +]]> + + + type="javaee:faces-config-flow-definition-flow-call-flow-referenceType" + > - The flow id of the called flow.

- - ]]> + + The flow id of the called flow.

+ +]]> + + minOccurs="0" maxOccurs="unbounded"> - A parameter to pass when calling the flow - identified in the "flow-reference" element that is a sibling of this element.

- - ]]> + + 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.

- - ]]> - - + + +The id of this flow-return.

+ + ]]> + + + - - - - + - Identifiy the called flow.

- -
- -
- - ]]> + + Identifiy the called flow.

+ +
+ +
+]]> + + minOccurs="0" + > - - The document id of the called flow.

+ The document id of the called flow.

- ]]> - + ]]> + + type="javaee:java-identifierType" + > - - The 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 entered.

+ +]]> + @@ -2360,17 +2327,17 @@ - - - - A MethodExpression that will be invoked when the flow is exited.

- - ]]> + + A MethodExpression that will be invoked when the flow is exited.

+ +]]> + @@ -2381,107 +2348,111 @@ - - - - A named parameter whose value will be populated - with a correspondingly named parameter within an "outbound-parameter" element.

- - ]]> + + A named parameter whose value will be populated + with a correspondingly named parameter within an "outbound-parameter" element.

+ +]]> + + type="javaee:java-identifierType" + + > - - The "name" element within an "inbound-parameter" + 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.

- ]]> - + ]]> + type="javaee:faces-config-flow-definition-parameter-valueType" + + > - - The "value" element within an "inbound-parameter" + 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.

- - ]]> + + A named parameter whose value will be + passed to a correspondingly named parameter within an "inbound-parameter" element + on the target flow.

+ +]]> + + type="javaee:java-identifierType" + + > - - The "name" element within an "outbound-parameter" element + 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.

- ]]> - + ]]> + type="javaee:faces-config-flow-definition-parameter-valueType" + + > - - The "value" element within an "outbound-parameter" + 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 + Extension element for managed-bean. It may contain implementation specific content.

- ]]> - + ]]> Defines the legal values for the + +

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 @@ -2525,46 +2495,43 @@ - - The "managed-property" element represents an individual + 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 + 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 + 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.

- ]]> - + ]]> @@ -2587,27 +2554,25 @@ - - The "map-entry" element reprsents a single key-entry pair + 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 + The "key" element is the String representation of a map key that will be stored in a managed property of type java.util.Map.

- ]]> - + ]]> @@ -2626,30 +2591,28 @@ - - The "map-entries' element represents a set of key-entry pairs + 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 + 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 + 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.

- ]]> - + ]]> @@ -2688,8 +2651,8 @@ type="javaee:string" minOccurs="0"> - - The "from-outcome" element contains a logical outcome string returned by the execution of an application action method selected via an "actionRef" property @@ -2702,8 +2665,9 @@ for any outcome value, with the assumption that the condition specified in the "if" element ultimately determines if this rule is a match.

+ +]]> - ]]> @@ -2711,20 +2675,19 @@ type="javaee:faces-config-ifType" minOccurs="0"> - - Please see section JSF.7.4.2 for the specification of this element.

+ Please see section JSF.7.4.2 for the specification of this element.

- ]]> - + ]]> - - The "to-view-id" 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 @@ -2735,21 +2698,24 @@ or flow node or flow) identifier.

- ]]> - + ]]> - - - The document id of the called flow.

+ type="javaee:java-identifierType" + minOccurs="0" + > + + 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 + 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 + Extension element for navigation-rule. It may contain implementation specific content.

- ]]> - + ]]> - - The "null-value" element indicates that the managed + 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 @@ -2834,8 +2798,7 @@ associated "property-class" identifies a Java class, not a Java primitive.

- ]]> - + ]]> @@ -2846,9 +2809,9 @@ - - The "property" element represents a JavaBean property of the + 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 @@ -2857,38 +2820,35 @@ performing introspection against that class via java.beans.Introspector.

- ]]> - + ]]> - - The "property-name" element represents the JavaBeans + 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 + 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.

+ 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 + Extension element for property. It may contain implementation specific content.

- ]]> - + ]]> - - The "redirect" element indicates that navigation to the + 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 + 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 @@ -3000,14 +2953,17 @@ Implementations must treat this element the same as "redirect-param".

- ]]> - + ]]> + type="javaee:string" + + /> + type="javaee:string" + + /> @@ -3018,21 +2974,24 @@ - - The "redirect-param" element, only valid within + 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.

- ]]> - + ]]> + type="javaee:string" + + /> + type="javaee:string" + + /> @@ -3043,9 +3002,9 @@ - - The "referenced-bean" element represents at design time the + 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 @@ -3053,38 +3012,35 @@ 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 + 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 + 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.

- ]]> - + ]]> @@ -3097,16 +3053,15 @@ - - The "render-kit" element represents a concrete RenderKit + 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.

- ]]> - + ]]> @@ -3114,28 +3069,26 @@ type="javaee:string" minOccurs="0"> - - The "render-kit-id" element represents an identifier + 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 + 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 + 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" @@ -3172,34 +3125,31 @@

Nested "attribute" elements identify generic component attributes that are recognized by this renderer.

- ]]> - + ]]> - - The "client-behavior-renderer-type" element represents a renderer type + 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 + The "client-behavior-renderer-class" element represents the fully qualified class name of a concrete Client Behavior Renderer implementation class.

- ]]> - + ]]> @@ -3212,9 +3162,9 @@ - - The "renderer" element represents a concrete Renderer + 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" @@ -3225,48 +3175,44 @@

Nested "attribute" elements identify generic component attributes that are recognized by this renderer.

- ]]> - + ]]> - - The "component-family" element represents the + 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 + 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 + The "renderer-class" element represents the fully qualified class name of a concrete Renderer implementation class.

- ]]> - + ]]> - - Extension element for renderer. It may contain implementation + Extension element for renderer. It may contain implementation specific content.

- ]]> - + ]]> - - Extension element for render-kit. It may contain + Extension element for render-kit. It may contain implementation specific content.

- ]]> - + ]]> - - The "suggested-value" contains the value for the property or + 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.

- ]]> - + ]]> @@ -3357,17 +3300,16 @@ - - The "supported-locale" element allows authors to declare + 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 '_'.

- ]]> - + ]]> @@ -3382,9 +3324,9 @@ - - The "behavior" element represents a concrete Behavior + 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.

@@ -3399,35 +3341,32 @@ more completely describe their components to tools and users. These elements have no required runtime semantics.

- ]]> - + ]]> - - The "behavior-id" element represents the identifier + The "behavior-id" element represents the identifier under which the corresponding Behavior class should be registered.

- ]]> - + ]]> - - The "behavior-class" element represents the fully + The "behavior-class" element represents the fully qualified class name of a concrete Behavior implementation class.

- ]]> - + ]]> - - Nested "attribute" elements identify generic + 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 + 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 + Extension element for behavior. It may contain implementation specific content.

- ]]> - + ]]> - - The "validator" element represents a concrete Validator + 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.

@@ -3520,35 +3456,32 @@ more completely describe their components to tools and users. These elements have no required runtime semantics.

- ]]> - + ]]> - - The "validator-id" element represents the identifier + The "validator-id" element represents the identifier under which the corresponding Validator class should be registered.

- ]]> - + ]]> - - The "validator-class" element represents the fully + The "validator-class" element represents the fully qualified class name of a concrete Validator implementation class.

- ]]> - + ]]> - - Nested "attribute" elements identify generic + 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 + 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 + Extension element for validator. It may contain implementation specific content.

- ]]> - + ]]> - - The "value" element is the String representation of + 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.

- ]]> - + ]]> @@ -3641,16 +3570,15 @@ - - The "value-class" element defines the Java type to which each + 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.

- ]]> - + ]]> @@ -3665,16 +3593,15 @@ - - The "list-entries" element represents a set of initialization + 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 + 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 @@ -3708,54 +3635,50 @@ can be the source of events that are delivered to the listener instance.

- ]]> - + ]]> - - The "system-event-listener-class" element contains + 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 + 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 + 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.

- ]]> - + ]]> @@ -3765,13 +3688,12 @@ - - This type contains the recognized versions of + This type contains the recognized versions of faces-config supported.

- ]]> - + ]]> diff --git a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-fragment_3_1.xsd b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-fragment_3_1.xsd index 0cefe4e..435ba58 100644 --- a/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-fragment_3_1.xsd +++ b/bundles/org.eclipse.jst.standard.schemas/dtdsAndSchemas/web-fragment_3_1.xsd @@ -269,4 +269,72 @@ + + + + + + + + + + + + + + + + + + + + Please see section 8.2.2 of the specification for details. + + + + + + + + + + + + + + + + + This element contains a sequence of "name" elements, each of + which + refers to an application configuration resource by the "name" + declared on its web.xml fragment. This element can also contain + a single "others" element which specifies that this document + comes + before or after other documents within the application. + See section 8.2.2 of the specification for details. + + + + + + + + +