Guia Jsf

JBoss AS 6.0 JSF Guide

JSF with JBoss
Application Server 6
by Stan Silvert

I. Introduction and Quick Start ............................................................................................ 1
1. Introduction ......................................................................................................... 3
2. Quick Start.......................................................................................................... 5
2.1. Create your WAR structure ......................................................................... 5
2.2. Create a minimal web.xml ........................................................................... 5
2.3. Create a minimal faces-config.xml ............................................................... 5
2.4. CreateYour JSF Markup ............................................................................ 6
2.5. Run the application ..................................................................................... 6
II. Configuration ................................................................................................................. 7
3. Deploying Your JSF Applications........................................................................ 9
3.1. The JSF Deployer ...................................................................................... 9
3.2. How the JSF Deployer Recognizes your JSF Application ............................... 9
3.3. Auto-adding of the JSF FacesServlet ......................................................... 10
3.4. Using a Non-standardFacesServlet ........................................................... 10
3.5. Bundling JSF Inside Your WAR ................................................................. 11
3.6. Changing the JSF Configuration for your WAR ........................................... 11
3.7. Adding a New JSF Configuration ............................................................... 12
3.8. Activating a New JSFConfiguration ...........................................................
4. JSF and Serialization .........................................................................................
4.1. Using JBoss Serialization ..........................................................................
III. Reference..................................................................................................................
5. Reference ...........................................................................................................
5.1. JSF Standard Context Params ..................................................................
5.2. Mojarra Context Params ............................................................................
5.3. JBoss JSF Context Params.......................................................................

12
15
15
17
19
19
22
27

iii

iv

Part I. Introduction and Quick Start

Chapter 1.

Introduction
In the past, using a JEE application server meant using the JSF implementation that ships with
it. However, there are subtle differences between JSF implementations. Applications written for
Mojarra don't always runwell on MyFaces. There are sometimes backward compatibility issues
between JSF specification levels. An application written for JSF 1.2 won't always run on JSF 2.0.
JBoss AS6 is designed for maximum flexibility in JSF deployments. With JBoss AS6, you can use
the default JSF implementation, use a secondary JSF implementation, or bundle your own JSF
implementation with the WAR. You can havedifferent applications in the same server instance that
use different implementations. Also, you can create your own JSF Configurations that include a
JSF implementation, extra libraries, and configuration parameters. Then assign the configuration
to one or more applications.
In this guide, we'll step through a simple JSF example. Then we will go through all the powerful
deployment options for JSF...