JBoss.orgCommunity Documentation

Chapter 2. Getting started with JBoss Portlet Bridge

2.1. What's New in 2.0?
2.1.1. Eventing
2.1.2. Portlet Served Resources
2.1.3. Public Render Parameters
2.2. Bridge Frameworks and Extensions
2.2.1. Seam Bridgelets
2.2.2. RichFaces Bridgelets
2.3. Before you start
2.4. Maven Archetypes
2.5. Video Tutorials

JBoss Portlet Bridge not only gives you the ability to run JSF web applications in a portlet, but also gives you the benefit of running supported JBoss frameworks like Seam and RichFaces.

The JBoss Portlet Bridge currently supports JBoss Portal, GateIn, JSF 1.2, JBoss Seam, and JBoss Richfaces. There are configurations that apply to supporting each framework. See section Chapter 3, Bridge Configuration for instructions.

The JBoss Portlet Bridge project is also actively developing extensions, and to differentiate from just another "project" that has boring ol' "extensions" we coined the term "Bridgelets" - because what would a project with Java and JSF be without having "*let" on the end of it? Not very cool in my opinion ;) With that said, in this current release we decided to bring all of our bridgelets into the impl code base since they are critical in most JSF portlet applications. Now it only takes a single line of configuration to utilize these features.

Current version and compatibilty information can be easily located on the JBPB wiki. Ensure you are using compatible versions of all integrated frameworks before you begin.

JBoss Portal and GateIn provides it's latest distribution included in JBoss Application Server. All of the guesswork has been eliminated so that you can unzip and run the Portal with a few clicks. Get the latest here (ensure you choose the Portal + JBoss AS link)

Next, all that's left is to download the JBoss Portlet Bridge distribution and cofigure your portlet to use the bridge. Or, you can run a provided archetype Section 2.4, “Maven Archetypes” and deploy the generated war in a few easy steps. This will also give you an empty project to play around with or start from scratch.

Use the following archetype command to use any combination JSF 1.2, RichFaces, or Seam as a portlet.

         mvn archetype:generate -DarchetypeCatalog=http://bit.ly/fLm527

Lesson 1: Getting Started With The Bridge

Lesson 2: Portlet 1.0 Advanced Seam and RichFaces

Lesson 3: Seam and Portlet 2.0 Eventing

Lesson 4: Running the 2.0 bridge on GateIn and deploy using JBoss Tools

Lesson 5: GateIn JMX Metrics and Dashboard Demo

Lesson 6: 2.0.0 FINAL and Best Practices for JSF IPC

Lesson 7: Running JSF Apps Over WSRP v2

Check here for the latest videos.