We just released JBoss Portlet Bridge Beta3 along with some good supporting documentation and example projects. See the documentation for full details.

For those that want to jump right in, you can run the following archetype and have it deployed on JBoss AS + Portal in minutes:

 
mvn archetype:generate -DarchetypeGroupId=org.jboss.portletbridge.archetypes -DarchetypeArtifactId=1.2-basic -DarchetypeVersion=1.0.0.B3 -DgroupId=org.whatever.project -DartifactId=myprojectname -DarchetypeRepository=http://repository.jboss.org/maven2/ -Dversion=1.0.0.B3 

 
mvn install cargo:start -Premote-portal -Dpc20 

 
mvn cargo:deploy -Premote-portal -Dpc20 

• The EG is currently discussing a lot of significant clarifications and improvements. For example, working with the JSF 2.0 EG to allow certain needs and working on Portlet 2.0 areas of the spec.
• There is currently a lot of discussion about navigation between portlet modes. Once this is nailed down in the spec, we will implement it.
• The Portlet 1.0 version should be getting close to public review.

• Namespacing In situations where you need to use the id of an element in your JSF/xhtml markup, you would normally see something like 'form1:myBtn' in the rendered markup. But now with the bridge namespacing you will see something similar to:

  jbpns_2fdefault_2fNews_2fStories_2fStoryTemplateWindow12snpbj:_viewRoot:form1:myBtn

  To overcome this, you can use the following expression in your Facelets page to prepend the namespace to your javascript code:

  document.getElementById('#{facesContext.externalContext.response.namespace}the_rest_of_JSF_ID

  since this uses the portletResponse, once you try to view this page on the servlet application side, you will get an exception. To avoid this, you need to check for the type of response in your backing bean and assign a new "safe" namespace variable for the UI.
• Excluding Attributes from the Bridge Request Scope When your application uses request attributes on a per request basis and you do not want that particular attribute to be managed in the extended bridge request scope, you must use the following configuration in your faces-config.xml. Below you will see that any attribute namespaced as foo.bar or any attribute beginning with foo.baz(wildcard) will be excluded from the bridge request scope and only be used per that application's request.

   
  <application> 
  <application-extension> 
  <bridge:excluded-attributes> 
  <bridge:excluded-attribute>foo.bar</bridge:excluded-attribute> 
  <bridge:excluded-attribute>foo.baz.*</bridge:excluded-attribute> 
  </bridge:excluded-attributes> 
  </application-extension> 
  </application>