JavaServerTM Faces (JSF) 1.1_01 FCS
Release Notes



For an updated, online version of these release notes, see Release Notes

Revised: 20040817

The purpose of this release is to provide a reference implementation of the JavaServer Faces framework.

This FCS release of JavaServer Faces technology provides a final version of the JSF technology which was developed under the Java Community Process(SM) ("JCP(SM)") as JSR127.

 Contents

Supported Operating Systems

Required Software

This release requires that you install the software listed in the following table. Only those versions listed in the table have been tested and are supported.
 
 
TABLE 1 Required Software
Software Version

 

Java Development Kit  version 1.3.1 or later 
Java Web Services Developer Pack or
Sun Java System Application Server
version 1.3 or later
version 8.0 or later
Microsoft Internet Explorer or Netscape Navigator  version 6 (IE)
version 7 (Netscape)

What This Release Includes

What's New in This Release

Migrating From 1.1 to 1.1_01

This implementation is 100% compatible with the 1.1 implementation, but many bugs have been fixed. If your application dependend on one of these bugs, it will need to be changed. Please see the What's New In this Release section.

Logging Support And Configuration Steps

JavaServer Faces Reference Implementation in this release leverages the Jakarta Commons logging API to provide logging functionality.  We have followed the guidelines recommended by http://jakarta.apache.org/commons/logging/userguide.html.  JavaServer Faces Reference Implementation can be configured to provide logging information using the steps below.
  1. If you are using Tomcat or JWSDP as your container, you can set the following property to tell the container what logging implementation you are using as well as the location of your logging configuration file.  Set   CATALINA_OPTS=-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger -Djava.util.logging.config.file=D:\Files_2k\j2sdk1.4.1_03\jre\lib\jsf-log.properties
  2.  We have shown a sample logging configuration file below that is configured to get logging output when you are running a JavaServer Faces application.  The default JDK 1.4 logging configuration file is  "$JAVA_HOME}/jre/lib/logging.properties". You can either manipulate that as per directions below, in which case it's global to all Java apps that you run or you can create a jsf.log properties as illustrated below. You can change the "java.util.logging.FileHandler.pattern" property to control where your logging information is written.
Here's the jsf-log.properties:

############################################################
#       Default Logging Configuration File
# http://java.sun.com/j2se/1.4.2/docs/guide/util/logging/overview.html#1.2
# You can use a different file by specifying a filename
# with the java.util.logging.config.file system property.
# For example java -Djava.util.logging.config.file=myfile
############################################################
                                                                               
############################################################
#       Global properties
############################################################

# "handlers" specifies a comma separated list of log Handler
# classes.  These handlers will be installed during VM startup.
# Note that these classes must be on the system classpath.
# By default we only configure a ConsoleHandler, which will only
# show messages at the INFO and above levels.
                                                                               
# To also add the FileHandler, use the following line instead.
handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler
                                                                               
# Default global logging level.
# This specifies which kinds of events are logged across
# all loggers.  For any given facility this global level
# can be overriden by a facility specific level
# Note that the ConsoleHandler also has a separate level
# setting to limit messages printed to the console.
#.level= INFO
.level= INFO

############################################################
# Handler specific properties.
# Describes specific configuration info for Handlers.
############################################################
                                                                               
# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
                                                                               
# Limit the message that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
                                                                                                                                     
############################################################
# Facility specific properties.
# Provides extra control for each logger.
############################################################

# For example, set the com.xyz.foo logger to only log SEVERE
# messages:
com.xyz.foo.level = SEVERE
com.sun.faces.level = ALL
                                                                               
If you use the ConsoleHandler ( which would direct all the output to catalina.out in the case of standalone Tomcat or launcher.server.log in the case of JWSDP ) please make sure that the detail level for ConsoleHandler can handle the level set for individual packages. For example say you have set the level for "com.sun.faces.el" package to "FINEST" as below.
    "com.sun.faces.el.level = FINEST"
                                                                               
You won't see any trace or debug messages unless you also set ConsoleHandler.level = FINEST. ConsoleHandler.level caps the detail level to the console, no matter what the underlying loggers are set for.

In this release, the Reference Implementation provides logging support for the following packages.
    * com.sun.faces.application
    * com.sun.faces.el
    * com.sun.faces.lifecycle
                                                                               
The logging messages are not localized. Localization as well as logging for rest of the RI will be done in a future release.

Known Issues With This Release


Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa
Clara, California 95054, U.S.A. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to
technology embodied in this product. In particular, and without
limitation, these intellectual property rights may include one or more
of the U.S. patents listed at http://www.sun.com/patents and one or more
additional patents or pending patent applications in the U.S. and other
countries.

This product is distributed under licenses restricting its use, copying
distribution, and decompilation. No part of this product may be
reproduced in any form by any means without prior written authorization
of Sun and its licensors, if any.

Third-party software, including font technology, is copyrighted and
licensed from Sun suppliers.

Sun, Sun Microsystems, the Sun logo, the Java Coffee Cup logo,
JavaServer, and Java are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.

Federal Acquisitions: Commercial Software - Government Users Subject to
Standard License Terms and Conditions.


Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, Etats-Unis. Tous droits réservés.

Sun Microsystems, Inc. a les droits de propriété intellectuels relatants
à la technologie incorporée dans ce produit. En particulier, et sans la
limitation, ces droits de propriété intellectuels peuvent inclure un ou
plus des brevets américains énumérés à http://www.sun.com/patents et un
ou les brevets plus supplémentaires ou les applications de brevet en
attente dans les Etats - Unis et les autres pays.

Ce produit ou document est protégé par un copyright et distribué avec
des licences qui en restreignent l'utilisation, la copie, la
distribution, et la décompilation. Aucune partie de ce produit ou
document ne peut être reproduite sous aucune forme, par quelque moyen
que ce soit, sans l'autorisation préalable et écrite de Sun et de ses
bailleurs de licence, s'il y ena.

Le logiciel détenu par des tiers, et qui comprend la technologie
relative aux polices de caractères, est protégé par un copyright et
licencié par des fournisseurs de Sun.

Sun, Sun Microsystems, le logo Sun, le logo Java Coffee Cup, JavaServer,
et Java sont des marques de fabrique ou des marques déposées de Sun
Microsystems, Inc. aux Etats-Unis et dans d'autres pays.