book

Facelets

by Robert Swarr

March 2007

Beginner to intermediate

101 pages

2h 41m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Preface
1.1 What Is Facelets?1.2 JavaServer Faces Integration1.2.1 The FaceletViewHandler1.2.2 The FaceletViewHandler in the JSF lifecycle1.2.3 The ViewHandler pluggable interface1.2.4 Decorating the default ViewHandler1.3 How Facelets Works1.3.1 The Facelets API1.3.2 The Facelets API in actionbuildView methodFacelet document compiler1.4 Why Facelets?1.4.1 Reusability1.4.2 JSF Integration1.4.3 JSP/JSF discordance
2.1 About the Facelets Development Environment2.2 Development Software2.2.1 Prerequisite software2.2.2 Eclipse IDE2.2.3 MySQL database2.3 Download and Install the Prerequisite Software2.3.1 Download and install JDK version 52.3.2 Download and install JBoss 4.0.42.3.3 Download and install JavaServer Faces 1.22.4 Download and Install IDE2.4.1 Eclipse IDE2.4.2 JBoss Eclipse IDE2.5 Download and Configure Facelets2.5.1 Download the Facelets distribution2.5.2 Configure a web project2.5.3 Copy the Facelets and JSF libraries to the web project2.5.4. Configure the application web descriptor (web.xml).2.5.5 Set up the JavaServer Faces configuration file (faces-config.xml)2.5.6 Add the JSF and Facelets libraries to the deployment2.6 Download, Install, and Configure Database Software2.6.1 Download MySQL database and GUI tools2.7 Configure JBoss MySQL DataSource2.8 Start Server to Check Deployment2.9 Importing the GoodEats! Project into Eclipse2.9.1 Downloading the GoodEats! Project2.9.2 Importing the GoodEats! project
3.1 Building the Good Eats! Homepage with Facelets3.2 The Facelets View File3.3 The Prototype Home Page3.4 Compositions3.5 Facelets Expression Language—the Glue3.6 JSF Backing Bean3.7 Styling Facelets Views with CSS
4.1 What Are Templates?4.1.1 Templating roles: template and template client4.1.2 Templating tags4.2 Developing a Templating Strategy4.2.1 Refactoring the GoodEats! Home page4.2.2 Create the template4.2.3 Creating the template client4.3 Advanced Templating4.3.1 The ui:decorate tag4.3.2 Using the ui:decorate tag
5.1 The Facelets Component Tags5.1.1 The component tags: ui:component and ui:fragment5.2 Using the Component Tags5.2.1 Using the ui:component tag5.2.2 Using the ui:fragment tag5.3 Right Sidebar Component.
6.1 What Are Composition Components?6.2 Creating a Composition Component6.2.1 Create the component6.2.2 Create the Facelets taglib6.2.3 Declare the taglib in the web.xml file6.2.4 Declare the XML namespace and use the custom tag6.3 Example: A List Layout Composition Component6.3.1 Step 1: Build the composition component and backing bean6.3.2 Step 2: Develop the Facelets custom taglib6.3.3 Step 3: Declare the taglib in the web.xml file6.3.4 Step 4: Declare the XML namespace and use the custom tag
7.1 Extensibility: JSF and Facelets7.2 Extending Facelets with Custom Tags7.2.1 What is a custom tag?7.2.2 The Facelets taglib7.2.3 Developing a custom tag7.3 Custom Tag Example: Joda DateTime Converter7.3.1 Develop the Converter class7.3.2 Add the Converter tag to the tag library7.3.3 Register the Converter with JSF7.3.4 Using the Joda DateTime Converter7.4 Extending Facelets with Custom TagHandlers7.4.1 What is a TagHandler?7.4.2 Developing a custom TagHandler7.5 Custom TagHandler Example: The execute TagHandler7.5.1 The handler-class7.6 Extending Facelets with EL Functions7.6.1 What is an EL function?7.6.2 Developing an EL function7.7 EL Function Example: formatName Function
8.1 Facelets and JavaScript8.1.1 Enclose JavaScript in CDATA8.1.2 Import JavaScript from an external file8.1.3 JavaScript in attributes values8.1.3 JavaScript attributes bound to a bean method8.2 Facelets, JSF, and AJAX8.2.1 What is AJAX?8.2.2 JSF/Ajax integration issues8.2.3 The panoply of AJAX frameworks8.2.4 AJAX for the JavaScript avoidant8.3 Example: Ajax-enabled selection boxes8.3.1 ajax4jsf configuration8.3.2 Developing interrelated selection boxes with AJAX8.3.3 Developing a suggest selection box with AJAX

9.1 What Is the Good Eats! Web Site?9.2 Requirements9.2.1 Business requirements9.2.2 Technical requirements9.3 Web Site Construction9.3.1 User interface: FaceletsLayoutCSS RulesJavaScriptFacelets ComponentsTemplate Client ViewFaces Backing Beans9.3.2 Domain layer: Enterprise JavaBeansDomain Layer ComponentsStateless Session BeansEntity Beans9.3.3 Database: MySQLSite Administration TablesSite Content Tables

Content preview from Facelets

Chapter 5. Developing and Using Facelets Component Tags

5.1 The Facelets Component Tags

Facelets supports two tags that function as components: the aptly named ui:component and its nontrimming counterpart, ui:fragment. These tags are components because both insert a new JSF UIComponent object into the component tree, which becomes the root for all of the tag's child elements. Additionally, both tags support two of the Faces common properties, id and binding. These tags offer a simple mechanism for creating custom components. Facelets and JSF handle the wiring and rendering—all the developer has to do is create a Facelets view using these tags. This chapter describes these tags and their usage, and demonstrates how to use them with some examples.

5.1.1 The component tags: ui:component and ui:fragment

These two tags are a matched set like ui:composition and ui:decorate. The ui:component tag trims all content outside of itself, and the ui:fragment tag has the same behavior, except it is nontrimming.

ui:component: This tag behaves much like the ui:composition tag. The difference is that the ui:component tag inserts a new UIComponent instance into the component tree as the root of all of its child elements. The ui:component tag supports both the id and binding attributes, which perform their typical functions. The id attribute can be used to assign this component an identifier. If you do not assign an identifier, Faces will. The binding attribute can be used to bind to any of the children ...