Find JSRs
Submit this Search

Ad Banner

Summary  |  Proposal  |  Detail (Summary & Proposal)  |  Nominations
JSRs: Java Specification Requests
JSR 329: Portlet 2.0 Bridge for JavaServerTM Faces 1.2 Specification

Stage Access Start Finish
Maintenance Review Ballot View results 18 Aug, 2015 24 Aug, 2015
Maintenance Draft Review Download page 14 Jul, 2015 13 Aug, 2015
Transfer Ballot View results 02 Jun, 2015 15 Jun, 2015
Final Release Download page 13 Jan, 2011  
Final Approval Ballot View results 23 Nov, 2010 06 Dec, 2010
Proposed Final Draft Download page 18 Nov, 2010  
Public Review Ballot View results 03 Aug, 2010 09 Aug, 2010
Public Review Download page 08 Jul, 2010 09 Aug, 2010
Early Draft Review 2 Download page 21 Jul, 2009 04 Sep, 2009
Early Draft Review Download page 06 Mar, 2009 05 May, 2009
Expert Group Formation   10 Feb, 2009 01 Mar, 2009
JSR Review Ballot View results 27 Jan, 2009 09 Feb, 2009
Status: Maintenance
JCP version in use: 2.9
Java Specification Participation Agreement version in use: 2.0

The Portlet 2.0 Bridge defines the semantics for executing JavaServer Faces views within a portlet.


Specification Leads
  Michael Freedman Oracle
  Neil Griffin Liferay, Inc
Expert Group
  Adobe Systems Inc.
: James Ward
BEA Systems
: Brodi Beartusk
Bosch, Andy
: Andy Bosch
  Brasier, Matthew
: Matthew Brasier
Christian, Raschka
: Raschka Christian
Djeyassilane, Shankar
: Shankar Djeyassilane
  Haley, Jondean
: Jondean Haley
: Ate Douma
ICEsoft Technologies Inc.
: Ted Goddard
  Liferay, Inc
: Neil Griffin
Mann, Kito D. Marinschek, Martin
: Martin Marinschek
: Michael Freedman
: Roger Kitain
: Scott O'Bryan
  Red Hat
: Wesley Hales
Red Hat
: Stan Silvert
SAP Labs
: Nikolai Dokovski
  Spiegl, Thomas
: Thomas Spiegl
TIBCO Software Inc.
: Danny Machak
Tiwari, Shashank
: Shashank Tiwari

Updates to the Original Java Specification Request (JSR)

The following changes have been made to the original proposal.

The JSR Transfer Ballot was approved, and the Maintenance Leadership of the JSR has changed to Liferay.

Maintenance Lead: Neil Griffin

E-Mail Address:

Telephone Number: +1 407 312 7409

Fax Number: -

The Maintenance Lead has requested a JSR Transfer Ballot, to transfer the Maintenance Lead role from Oracle to Liferay. As part of this, the JSR has moved to JCP 2.9.

Original Java Specification Request (JSR)

Identification | Request | Contributions

Section 1. Identification

Submitting Member: Oracle Corporation

Name of Contact Person: Don Deutsch

E-Mail Address:

Telephone Number: +1 650 506 2275

Fax Number: -

Specification Lead: Michael Freedman

E-Mail Address:

Telephone Number: +1 650 506 4904

Fax Number: -

Initial Expert Group Membership:

Andy Bosch
Matt Brasier
Raschka Christian
Shankar Djeyassilane
Sun Microsystems
Red Hat Middleware LLC
TIBCO Software
Kito D. Mann
Martin Marinscheck
Thomas Spiegl
Icesoft Technologies
Shashank Tiwari
eXo Platform SAS
Adobe Systems Inc.

Supporting this JSR:

Adobe Systems Inc.
Andy Bosch
Matt Brasier
eXo Platform SAS
ICEsoft Technologies Inc.
Kito Mann
Martin Marinschek
Christian Raschka
Red Hat, Inc.
Sun Microsystems, Inc.
TIBCO Software Inc.
Shashank Tiwari

Section 2: Request

2.1 Please describe the proposed Specification:

The Java Portlet 2.0 Bridge for JavaServer Faces 1.2 Specification defines the required behavior of a control environment designed to run in a JSR 286 portlet and JSF 1.2 runtime. Its control behavior allows a JSF application/view to be accessed as a Java portlet.

Because the portlet bridge lies between the portlet container and the Faces runtime, its behavior and function depends on the semantics each expresses and supports. Differing versions of either the Portlet specification or the Faces specification requires a distinct bridge specification and implementation to fully express all available function. Though JSR 301, in defining the Portlet 1.0 Bridge for JavaServer Faces 1.2, provides a solid base for a Portlet 2.0 bridge the following new features in portlet 2.0 require a distinguished specification:

* ability to serve a resource directly from a portlet
* ability to send and receive events
* ability to define and operate on public render parameters
* ability to wrap portlet requests and response objects
* ability to use dispatch.forward.

2.2 What is the target Java platform? (i.e., desktop, server, personal, embedded, card, etc.)

At a minimum any platform that supports JSR 286 portlets and JavaServer Faces 1.2. Each of these dependent systems have a minimum requirement of running in a Java EE 5.x environment.

2.3 The Executive Committees would like to ensure JSR submitters think about how their proposed technology relates to all of the Java platform editions. Please provide details here for which platform editions are being targeted by this JSR, and how this JSR has considered the relationship with the other platform editions.

At a minimum any platform that supports JSR 286 portlets and JavaServer Faces 1.2. Each of these dependent systems have a minimum requirement of running in a Java EE 5.x environment.

Should this JSR be voted on by both Executive Committees?


2.5 What need of the Java community will be addressed by the proposed specification?

This will standardize the execution of JSF artifacts as portlets providing consistency and interoperability which should greatly enhance the desirability of implementing portlets in JSF.

2.6 Why isn't this need met by existing specifications?

JSR 301: The Portlet 1.0 Bridge for JavaServer Faces 1.2 defines the function of a bridge running in a Portlet 1.0 and Faces 1.2 environment. Portlet 2.0 introduces a wide variety of new features that Faces applications can and/or should access. This specification builds on the base of the Portlet 1.0 specification to expose these new features. In addition its explicitly tuned to the tweaks and clarifications defined in Portlet 2.0 to provide a more effective and natural expression of behavior than could be achieved in Portlet 1.0.

2.7 Please give a short description of the underlying technology or technologies:

The Portlet 2.0 Bridge for JavaServer faces 1.2 provides a transformation service, mapping between JSR portlet semantics and JSF MVC semantics. This specification standarizes this mapping behavior, though not the mapping implementation.

2.8 Is there a proposed package name for the API Specification? (i.e., javapi.something, org.something, etc.)

javax.portlet.faces package name will be used for API specifications.

2.9 Does the proposed specification have any dependencies on specific operating systems, CPUs, or I/O devices that you know of?


2.10 Are there any security issues that cannot be addressed by the current security model?


2.11 Are there any internationalization or localization issues?


2.12 Are there any existing specifications that might be rendered obsolete, deprecated, or in need of revision as a result of this work?


2.13 Please describe the anticipated schedule for the development of this specification.

To be determined by the expert group, initial target is to have a working EG by spring 2009, an early public draft by spring 2009, a complete public draft by fall 2009 and a final version by mid 2010.

2.14 Please describe the anticipated working model for the Expert Group working on developing this specification.

E-mail discussion, teleconferencing as needed (likely regular -- weekly/bi-weekly), and occasional face-2-face meetings.

2.15 It is important to the success of the community and each JSR that the work of the Expert Group be handled in a manner which provides the community and the public with insight into the work the Expert Group is doing, and the decisions that the Expert Group has made. The Executive Committees would like to ensure Spec Leads understand the value of this transparency and ask that each JSR have an operating plan in place for how their JSR will address the involvement of the community and the public. Please provide your plan here, and refer to the Spec Lead Guide for a more detailed description and a set of example questions you may wish to answer in your plan.

Transparency will be achieved by releasing regular (early) public drafts of the specification as the work progresses and by tracking, updating and posting an accurate schedule.

2.16 Please describe how the RI and TCK will de delivered, i.e. as part of a profile or platform edition, or stand-alone, or both. Include version information for the profile or platform in your answer.


2.17 Please state the rationale if previous versions are available stand-alone and you are now proposing in 2.13 to only deliver RI and TCK as part of a profile or platform edition (See sections 1.1.5 and 1.1.6 of the JCP 2 document).

The license will be a free-of-charge open source license compatible with Java EE licensing.

2.18 Please provide a description of the business terms for the Specification, RI and TCK that will apply when this JSR is final.

We currently anticipate that the specification license will be the standard JCP specification license. The RI will be licensed under the Apache 2.0 distribution license and the TCK will be an Oracle specific license that will grant the licensee a nonexclusive, nontransferable, royalty-free limited license to use the programs solely for purposes of compliance verification/testing.

Section 3: Contributions

3.1 Please list any existing documents, specifications, or implementations that describe the technology. Please include links to the documents if they are publicly available.

List existing documents, specifications, or implementations that describe the technology. Please include links to publically available material.

JSR 301: Portlet 1.0 Bridge for JavaServer Faces 1.2 (Proposed Final draft)

JSR 286: Java Portlet Specification 2.0

JSR 252: JavaServer Faces Specification 1.2

This is an implementation of Portlet 2.0 Bridge on which the first Early Public Draft of the specification will likely be based:

Apache MyFaces Portlet 2.0 Bridge implementation

3.2 Explanation of how these items might be used as a starting point for the work.

The JSR 301 specification will provide the foundation for this specification. This specification should merely be a recasting of the JSR 301 specification taking into account the changes between portlet 1.0 and portlet 2.0. This will include both new function and changes/enhancements to existing function.

The Portlet 2.0 specification and JavaServer Faces 1.2 specification guide and constrain the development of this specification. That is since the purpose of this specification is to define a bridge between these two containers, each of these container's specification will guide how the function is expressed.

The Apache MyFaces Portlet 2.0 Bridge implementation is the location of this specifications RI. As development of both this specification and RI have been underway for some time under the auspices of JSR 301 (with the prior blessing of the JCP). This implementation reflects both the current understanding of the bridge function as well as will be the location for future expression as the specification matures.