© 2009 Marty Hall

JSF: Introduction,
Introduction
Installation, and Setup
Originals of Slides and Source Code for Examples:
http://www.coreservlets.com/JSF-Tutorial/

Customized Java EE Training: http://courses.coreservlets.com/

Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
Developed and taught by well-known author and developer. At public venues or onsite at your location.

© 2009 Marty Hall

For live training on JSF 1.x or 2.0, please see

courses att http://courses.coreservlets.com/.
htt // l t /
Taught by the author of Core Servlets and JSP, More
Servlets and JSP,
JSP and this tutorial
tutorial. Available at public
venues, or customized versions can be held on-site
at your organization.
• Courses developed and taught by Marty Hall
– Java 5, Java 6, intermediate/beginning servlets/JSP, advanced servlets/JSP, Struts, JSF, Ajax, GWT, custom courses.
Customized
• Courses developed Java
and taught by EE Training: http://courses.coreservlets.com/
coreservlets.com experts (edited by Marty)
Servlets,
– Spring, JSP, Struts, JSF/MyFaces/Facelets,
Hibernate/JPA, EJB3, Ruby/Rails Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
Developed and taught by well-known Contact author and developer. At public
[email protected] venues or onsite at your location.
for details
 Topics in This Section
• Understanding JSF
– Different views of JSF
– Comparing JSF to standard servlet/JSP technology
• Pros and cons
– Comparing JSF to Apache Struts
• Pros and cons
• Setting Up JSF
– Downloading and configuring JSF
• Apache MyFaces
M Faces
• Sun Reference Implementation
– Testing JSF
– Setting up JSF applications
– Accessing JSF documentation
5

© 2009 Marty Hall

Overview

Customized Java EE Training: http://courses.coreservlets.com/

Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
6 Developed and taught by well-known author and developer. At public venues or onsite at your location.
 What is JSF?
• A set of Web-based GUI controls and associated
handlers?
– JSF provides many prebuilt HTML-oriented GUI controls, along
with code to handle their events.
• A device-independent GUI control framework?
– JSF can be used to generate graphics in formats other than HTML,
using
g pprotocols other than HTTP.
• A better Struts?
– Like Apache Struts, JSF can be viewed as an MVC framework for
building HTML forms,
forms validating their values,
values invoking business
logic, and displaying results.
• But which is the proper way to view JSF?
– Th
The answer depends
d d on what
h t you are going
i tot use it for,
f butb t the
th 1 &
3 are the most common way of looking at JSF.
7

Advantages of JSF (vs. MVC Using

RequestDispatcher)
• Custom GUI controls
– JSF provides
id a set off API
APIs and
d associated
i d custom tags to create
HTML forms that have complex interfaces
• Event handling
– JSF makes it easy to designate Java code that is invoked when forms
are submitted. The code can respond to particular buttons, changes
in particular values, certain user selections, and so on.
• Managed beans
– In JSP, you can use property="*" with jsp:setProperty to
automaticallyy ppopulate
p a bean based on request
q pparameters. JSF
extends this capability and adds in several utilities, all of which
serve to greatly simplify request param processing.
• Expression Language
– JSF provides a concise and powerful language for accessing bean
properties and collection elements
8
 Advantages of JSF (vs.
Standard MVC),
MVC) Continued
• Form field conversion and validation
– JSF hhas bbuiltin
il i capabilities
bili i for
f checking
h ki that
h form
f values
l are in
i the
h
required format and for converting from strings to various other data
types. If values are missing or in an improper format, the form can
be automatically redisplayed with error messages and with the
previously entered values maintained.
• Centralized file-based configuration
– Rather then hard-coding information into Java programs, many JSF
values are represented in XML or property files. This loose coupling
means that many changes can be made without modifying or
recompiling Java code,
code and that wholesale changes can be made by
editing a single file. This approach also lets Java and Web
developers focus on their specific tasks without needing to know
about the overall system layout.
layout
• Consistent approach
9
– JSF encourages consistent use of MVC throughout your application.

Disadvantages of JSF (vs. MVC

with RequestDispatcher)
• Bigger learning curve
– To use MVC with the standard RequestDispatcher, you
need to be comfortable with the standard JSP and servlet
APIs. To use MVC with JSF,, you
y have to be comfortable
with the standard JSP and servlet APIs and a large and
elaborate framework that is almost equal in size to the
y
core system. This drawback is especially
p y significant
g with
smaller projects, near-term deadlines, and less
experienced developers; you could spend as much time
learning JSF as building your actual system.
• Worse documentation
– Compared to the standard servlet and JSP APIs, JSF has
fewer online resources, and many first-time users find the
online JSF documentation confusing and poorly
10 organized. MyFaces is particularly bad.
 Disadvantages of JSF (vs.
Standard MVC),
MVC) Continued
• Less transparent
– Wi
With
h JSF applications,
li i there
h is i a lot
l more goingi on
behind the scenes than with normal Java-based Web
applications. As a result, JSF applications are:
• H
Harder
d tto understand
d t d
• Harder to benchmark and optimize
• Undeveloped
p tool support
pp
– There are many IDEs with strong support for standard
servlet and JSP technology. Support for JSF is only
beginning
g g to emerge,
g , and final level is yet
y to be
determined.
• Rigid approach
– The flip side of the benefit that JSF encourages a
consistent approach to MVC is that JSF makes it difficult
11
to use other approaches.

Advantages of JSF
(vs Struts)
(vs.
• Custom components
– JSF makes it relatively easy to combine complex GUIs
into a single manageable component; Struts does not
• Better support for Ajax
– Several third-party component libraries have extensive
Ajax support (Apache Tomahawk, JBoss
Ajax4jsf/RichFaces, Oracle ADF, IceFaces). Struts
doesn't have real component libraries (see above).
• Support for other display technologies
– JSF is not limited to HTML and HTTP; Struts is
• Access to beans by name
– JSF lets you assign names to beans, then you refer to
them by name in the forms. Struts has a complex process
12
with several levels of indirection.
 Advantages of JSF
(vs Struts),
(vs. Struts) Continued
• Expression language
– Th
The JSF expression
i llanguage iis more concise
i and
d
powerful than the Struts bean:write tag.
• This is less advantageous if using JSP 2.0 anyhow.
• Simpler controller and bean definitions
– JSF does not require your controller and bean classes to
extend any particular parent class (e.g., Action) or use
any particular method (e.g., execute). Struts does.
• Simpler config file and overall structure
– Th
The faces-config.xml
f fi l file
fil is
i muchh easier
i tot use than
th isi the
th
struts-config.xml file. In general, JSF is simpler.
• More powerful potential tool support
– The orientation around GUI controls and their handlers
opens possibility of simple to use, drag-and-drop IDEs
13

Disadvantages of JSF (vs. Struts)

• Struts: established base and industry momentum
– 4/2009 search at dice.com
dice com and monster.com
monster com
– “struts”: 896 jobs (dice.com), 525 jobs (monster.com)
– “jsf”: 732 (dice.com), 694 (monster.com)

14
 Disadvantages of JSF (vs. Struts),
Continued
• Support for other display technologies
– JSF iis nott li
limited
it d tto HTML and
d HTTP
HTTP; Struts
St t isi
• Hey! Didn't I say this was an advantage of JSF?
• Confusion vs. file names
– The actual pages used in JSF end in .jsp. But the URLs
used end in .faces or .jsf. This causes many problems; in
particular, in JSF:
• You cannot browse directories and click on links
• It is hard to protect raw JSP pages from access
• It is hard to refer to non-faces pages in faces-
config.xml
fi l
• Self-submit approach
– With Struts,, the form (blah.
( jjspp) and the handler
(blah.do)have different URLs; with JSF they are the
same.
15

Disadvantages of JSF (vs.

Struts) Continued
Struts),
• No builtin equivalent to Tiles
– Struts comes with a page layout facility; JSF does not
• Facelets is not yet part of JSF, but is now mainstream
• Or, you can extract Tiles from Struts and use it with JSF
• Much weaker automatic validation
– Struts comes with validators for email address, credit card
numbers, regular expressions, and more. JSF only comes with
validators for missing values, length of input, and numbers in
a given range.
range
• But many powerful 3rd-party validators (including MyFaces)
• You can use the Struts/Commons validation library with JSF
• Lack of client-side validation
– Struts supports JavaScript-based form-field validation; JSF
does not
• Worse installation
– Struts has the struts-blank application to use for a starting
point; JSF has nothing similar
16
 JSF and Struts: The Future
• Possibilities
– JSF will
ill ffail
il and
d ddevelopers
l th
thatt wantt a fframework
k will
ill
stick with Struts
• JSF will die
– Doubtful at this point,
point but other MVC frameworks have failed
– JSF will flourish and replace Struts
• Struts will die
– JSF will grow moderately
moderately, and developers will be split
• Both Struts and JSF will be widely used frameworks
• Prediction is difficult
– Technical
T h i l factors
f t are nott usually
ll what
h t decide
d id these
th things
thi
• Recommendations
– Move ongoing
g g Struts projects
p j to JSF: not yet
y
– Start real-world JSF projects: yes, but with some caution
17

© 2009 Marty Hall

Installation

Customized Java EE Training: http://courses.coreservlets.com/

Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
18 Developed and taught by well-known author and developer. At public venues or onsite at your location.
 Installing and Configuring JSF:
Summary
• To run JSF, you need three things:
– Certain
C t i JAR fil
files in
i WEB-INF/lib
WEB INF/lib
• Specific to the implementation.
– Certain web.xml entries
• Must
M t match
t h the
th specific
ifi iimplementation.
l t ti
– A blank faces-config.xml file in WEB-INF
• Standard. Nothing specific to MyFaces.
• jsf-blank-myfaces
– Blank Eclipse project with pieces taken from Apache
– Downloadable from http://coreservlets
http://coreservlets.com/JSF
com/JSF-Tutorial/
Tutorial/
– Import into Eclipse, then copy/paste for new projects
• Copying projects in Eclipse is painful; see later slide

19

Installing and Configuring JSF:

Details
• Download the JSF files from one of two places
– Get jsf-blank-myfaces
jsf blank m faces from coreser
coreservlets.com
lets com
• http://www.coreservlets.com/JSF-Tutorial/
• Files taken from the MyFaces distribution
• Configured as an Eclipse project
– Download from http://myfaces.apache.org/download.html
• JAR files in WEB-INF/lib (some missing!)
• Hard to find sample web.xml
web xml or faces-config.xml
faces config xml
• Make compatible Eclipse project
– Copy jsf-blank-myfaces
• Requires you to edit .settings/org.eclipse.wst.common.component
settings/org eclipse wst common component
– Or, create a new Dynamic Web Project in Eclipse
• Copy JAR files to WebContent/WEB-INF/lib
• Copypy entries to WebContent/WEB-INF/web.xml
• Copy faces-config.xml to WebContent/WEB-INF
• Add project facet for JSF so that Eclipse is smart about editing JSF tags
in .jsp files and so that it uses the faces-config.xml editor
20
 Bookmark the JSF Documentation

• API Javadocs
– http://java.sun.com/j2ee/javaserverfaces/1.1/docs/api/
• Same as the MyFaces version
• Tag library docs
– http://java.sun.com/j2ee/javaserverfaces/1.1/docs/tlddocs/
• Much better than the MyFaces
y version
• MyFaces References
– http://myfaces.apache.org/
• User’s Guide, extensions documentation, FAQs, etc.
• faces-config.xml annotated DTD
– http://horstmann.com/corejsf/faces-config.html
http://horstmann com/corejsf/faces config html
• From Cay Horstmann
21

JSF Books (In Order of My Personal

Preference)
• JavaServer Faces, the Complete Reference
– By Schalk and Burns
• JavaServer Faces in Action
– By
B Ki
Kito M
Mann
• Core JavaServer Faces
– By Geary and Horstmann
• Second edition available as of May '07
• JavaServer Faces
– By Hans Bergsten
• Mastering JavaServer Faces
– By Dudney, et al
22
 © 2009 Marty Hall

Development
p
Process by Copying
“Bl k” P
“Blank” Project
j t
Customized Java EE Training: http://courses.coreservlets.com/
Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
23 Developed and taught by well-known author and developer. At public venues or onsite at your location.

The jsf-blank-myfaces Project

• Ready-to-extend Eclipse project
– Contains all required
standard JAR files
– Contains minimal web.xml
web xml
entries
– Contains blank
f
faces-config.xml
fi l file
fil
– Added project facet so that
Eclipse is JSF
JSF-aware
aware
• Especially so special editor is used for faces-config.xml
– Download jsf-blank-myfaces from
htt //
http://www.coreservlets.com/JSF-Tutorial/
l t /JSF T t i l/
• Web site also has extended version of “blank” project that
24
contains MyFaces extensions
 Developing in Eclipse by Copying
“Blank”
Blank Project
• Why copy?
– Creating new JSF apps in Eclipse is cumbersome
• R-click project  Properties  Project Facets 
JavaServer Faces has problems if web.xml exists already
• You have to configure
g JAR file locations
• Issue
– Cutting/pasting Web app in Eclipse does not change the
context ppath and internal pproject
j deploy
p y name
– Context path can be changed by R-clicking project, then
Properties  Web Project Settings
– But deployed
p y name is not accessible from within Eclipse!p
• Solution
– Go to file system, edit
.settings/org.eclipse.wst.common.component
g g p p
– Change two instances of old project name to new one
– R-click on project and choose Refresh
25

Copying jsf-blank-myfaces:
Example
• First, copy project
– R-click on jsf-blank-myfaces, choose “Copy”
– R-click in Project Explorer window, choose “Paste”
• E.g.,
E g name it my
my-jsf-project
jsf project
• Next, edit .component file
– Navigate
g to Eclipse
p workspace/
p projectName/.settin
p j gs
g

Open in normal text editor

When done editing,

editing R
R-click
click on project in Eclipse,
Eclipse
then choose “Refresh”

26
 Copying jsf-blank-myfaces:
Example (Continued)
• .component file: before
<?xml version="1.0" encoding="UTF-8"?>
<project-modules id="moduleCoreId" project-version="1.5.0">
<wb-module deploy-name="jsf-blank-myfaces">
<wb-resource deploy-path="/" source-path="/WebContent"/>
<wb-resource
b d l
deploy-path="/WEB-INF/classes"
th "/WEB INF/ l " source-path="/src"/>
th "/ "/
<property name="context-root" value="jsf-blank-myfaces"/>
<property name="java-output-path"/>
</wb-module>
</
</project-modules>
j t d l >

• .component file: after

<?xml version="1.0" encoding="UTF-8"?>
<project modules id="moduleCoreId" project
<project-modules project-version="1.5.0">
version="1 5 0">
<wb-module deploy-name="my-jsf-project">
<wb-resource deploy-path="/" source-path="/WebContent"/>
<wb-resource deploy-path="/WEB-INF/classes" source-path="/src"/>
<property name="context-root"
name= context-root value=
value="my-jsf-project"/>
my-jsf-project />
<property name="java-output-path"/>
</wb-module>
</project-modules>
27

Using jsf-blank as Starting Point for

New JSF Applications
• Copy and rename jsf-blank-myfaces
–RR-click,
li k Copy,
C R-click,
R li k paste
t
– Edit .component file and change name twice as on
previous slides
• Add JSF content
– Edit WebContent/WEB-INF/faces-config.xml
– Add JSP
JSP, HTML
HTML, and other Web content to
WebContent
• .jsp files will use JSF-specific tags
– Add Java files to src
• Deploy normally
– R-click server in Eclipse, “Add and Remove Projects”,
Select project, R-click, Restart
• If you do not have a Java-enabled server set up in Eclipse,
28
see http://www.coreservlets.com/Apache-Tomcat-Tutorial/
 Summary
• JSF provides many useful features for
d
developing
l i complex
l GUIs
GUI & handling
h dli events
• Standard servlet and JSP technology is a
viable alternative
– Especially when the MVC approach and the JSP 2.0
expression
p language
g g is used
• Struts is also a viable alternative
– Future of JSF vs. Struts is unknown
• To get started
– Download jsf-blank-myfaces from
htt //
http://www.coreservlets.com/JSF-Tutorial/
l t /JSF T t i l/
• Minimal (standard) version or version with MyFaces
29
extensions

© 2009 Marty Hall

Questions?

Customized Java EE Training: http://courses.coreservlets.com/

Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6.
Developed and taught by well-known author and developer. At public venues or onsite at your location.