Jboss 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. Create Your JSFMarkup ............................................................................ 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-standard FacesServlet........................................................... 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 JSF Configuration........................................................... 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 run well on MyFaces. There are sometimesbackward 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 have different applications in the same serverinstance 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 applications.

3

4

Chapter 2....