The Java EE 5 Tutorial (PDF) - Oracle Software Downloads

Basic Requirements of a JavaServer Faces Application
458
After your project is open in NetBeans IDE, you can change the mapping to the FacesServlet
instance by doing the following:
1. Expand the node of your project in the Projects pane.
2. Expand the Web Pages and WEB-INF nodes that are under the project node.
3. Double-click web.xml.
4. After the web.xml file appears in the editor pane, click Servlets at the top of the editor pane.
The FacesServlet configuration appears in the editor pane.
If you prefer to edit the web.xml file directly, perform the following steps to configure a
mapping to the FacesServlet instance:
1. Include a servlet element in the deployment descriptor.
2. Inside the servlet element, include a display-name element and set it to FacesServlet.
3. Also inside the servlet element, add a servlet-name element and set it to FacesServlet.
4. Add a third element, called servlet-class, inside the servlet element and set it to
javax.faces.webapp.FacesServlet. This is the fully-qualified class name of the
FacesServlet class.
5. After the servlet element, add a servlet-mapping element.
6. Inside the servlet-mapping element, add a servlet-name element and set it to
FacesServlet. This must match the name identified by the servlet-name element
described in step 3.
7. Also inside the servlet-mapping element, add a url-pattern element and set it to
whatever mapping you prefer. This will be the path to FacesServlet. Users of the
application will include this path in the URL when they access the application. For the
guessNumber application, the path is /guess/*.
Specifying a Path to an Application Configuration Resource File
As explained in “Application Configuration Resource File” on page 435, an application can have
multiple application configuration resource files. If these files are not located in the directories
that the implementation searches by default or the files are not named faces-config.xml, you
need to specify paths to these files.
To specify these paths using NetBeans IDE, do the following:
1. Expand the node of your project in the Projects pane.
2. Expand the Web Pages and WEB-INF nodes that are under the project node.
3. Double-click web.xml.
4. After the web.xml file appears in the editor pane, click General at the top of the editor pane.
5. Expand the Context Parameters node.
6. Click Add.
The Java EE 5Tutorial • June 2010