Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "JSF Tools Helios Requirements"
(→JSF 2.0 Requirements) |
(→Application Configuration) |
||
| Line 47: | Line 47: | ||
== Application Configuration == | == Application Configuration == | ||
| − | JSF 2.0 introduces two major new themes in application configuration: XML file reduction and Resource Loading. | + | JSF 2.0 introduces two major new themes in application configuration: XML file reduction and Resource Loading. Two new schema elements are also added. |
| − | + | The XML file reduction theme consists of a combination of features intended to simplify the amount of application data that is needed in the faces-config file. Two main new features are added to support this: Annotation-based Artifact Declaration and Simplified Navigation. | |
| + | |||
| + | The Resource Loading features adds a new facility that allows automatic discover of application artifacts through an implicit lookup mechansim. This feature is both implicitly by the system to find composites and is explicitly exposed to the JSFDeveloper for use in finding application resources such as string bundles and images. | ||
=== Annotation-based Artifact Declaration === | === Annotation-based Artifact Declaration === | ||
| − | === | + | === Simplified Navigation === |
| + | |||
| + | === Resource Loading === | ||
| + | |||
| + | === New Schema Elements === | ||
== Misc == | == Misc == | ||
Revision as of 21:01, 18 January 2010
This page is tentative and subject to change without notice
Contents
JSF 2.0 Requirements
Facelet Development
JSF 2.0 adds support for multiple "View Declaration Languages (VDL)" (section 7.6). A VDL is a format by which a JSF view (page) is declared. In JSF 1.X, the only choice supported in the spec was JSP, although through the pluggable view handler facility, others could be added. Facelets are included in JSF 2.0 as the new default VDL for JSF. Per section 10.1, "New features introduced in version 2 and later are only exposed to page authors using Facelets." Facelets uses XHTML instead of JSP as the default XML format for describing views. It also supports two richer view-building formats: templates and composites.
A template, as the name suggests, allows many pages to be defined by having one or more base template files in which individual view instances override some sections but keep others. For example, the template may define a header, left and right menu bars and a footer for all pages; each instance of the template might simply override the middle section with custom content.
A composite is a JSF component that is defined using similar XHTML markup to those used for views. A JSFDeveloper creates a new composite by "composing" one or more other components into a new component. JSF 2.0 introduces a new schema for defining composites through XML composite files.
XHTML source editing
The JSFDeveloper shall be able to do source-level development of Facelet XHTML view files with similar capabilities as are found in the current JSF/JSP source level editor. These capabilities will include:
- Validation and content assist for referenced library namespaces. Namespaces can be defined either explicitly through the Facelet taglib facility or implicitly through the detection of composites through the resource loading facility.
- Validation and content assist for tags declared for use in a Facelet view by use of namespace inclusion. Certain limitations may exist compared to the comparable JSP editing feature because Facelets has lower minimum requirements for tag meta-data. The framework will provide an extensible mechanism by which additional metadata may be added to fill gaps in required metadata. All sources of tag metadata defined in the spec shall also be supported.
- Validation and content assist for tag attributes. Same as section on tags.
- Validation and content-assist for tag attribute values.
- Validation and content assist for EL expressions inside tag attribute values.
- Hyperlink and hover help for namespaces, tags, attributes and EL expressions.
In addition, the following source editing capabilities shall be supported that are not necessarily guaranteed for JSP:
- Validation, content assist, hyperlink and hover help support for EL expressions used in XML text nodes.
- Tag support for the basic Facelet (http://java.sun.com/jsf/facelets), new core (http://java.sun.com/jsf/core), new html (http://java.sun.com/jsf/html), composite component and (??) JSTL subset tags and tag libraries.
- Support for namespaces declared through the composite component mechanism as discovered through the resource loading facility.
Composite Component Development
JSFDeveloper shall be able to do regular schema-based development of composite components. This includes but may not be limited to the inclusion of the requisite schemas in the XML catalog. The framework will provide a tag library interface to all components defined using the composite mechanism.
JSFDeveloper shall be able to create new Composite Component files in a directed way (i.e. wizard).
Taglib support
JSFDeveloper shall be able to access all libraries defined in his project according to the JSF 2.0 specification through:
- Declaration in the web.xml file per Section 11.1.3 of the spec.
- Implicit discovery of all files with the name pattern "META-INF/*.taglib.xml" on the class path.
JSFDeveloper will be able to create new taglib file and at a minimum have schema-based source editing of the files.
Application Configuration
JSF 2.0 introduces two major new themes in application configuration: XML file reduction and Resource Loading. Two new schema elements are also added.
The XML file reduction theme consists of a combination of features intended to simplify the amount of application data that is needed in the faces-config file. Two main new features are added to support this: Annotation-based Artifact Declaration and Simplified Navigation.
The Resource Loading features adds a new facility that allows automatic discover of application artifacts through an implicit lookup mechansim. This feature is both implicitly by the system to find composites and is explicitly exposed to the JSFDeveloper for use in finding application resources such as string bundles and images.