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 3. Developing JSF Views with Facelets

3.1 Building the Good Eats! Homepage with Facelets

This chapter does something you are unlikely to do once you are familiar with Facelets. It creates a web page without using a Facelets template in order to simplify the introduction to Facelets, Nonetheless, it demonstrates two of the three core ideas of Facelets discussed in the first chapter: JSF integration and compositions. After you are introduced to templates in the next chapter, you'll understand why you'll typically develop a Facelets view using templates.

The purpose of this chapter is to introduce the reader to the basics of developing views with Facelets. For this introduction, it performs a walk through of a prototype homepage for the Good Eats! web site. This example includes the key elements of a Facelets view: the XHTML view document, the Expression Language (EL) bindings, the JSF backing bean, the Facelets ui:include and ui:composition tags, and how to style Facelets views with CSS. We'll cover these elements at a high level in order to give you an overview of developing JSF views with Facelets. The goal of this chapter is to show you how all of these elements work together. Subsequent chapters will elaborate upon separate Facelets elements in detail.

3.2 The Facelets View File

Facelets views are xhtml documents that use the following declaration:

Example 7.

<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> ...