Supporting JSF 3

Overview

The JViews Web technologies provide fundamental support to JSF 3.0 Reference Implementation with following capabilities:

      • JViews JSF components work under JSF 3.0 reference implementation run time.

      • JViews JSF components support custom component features in JSF 3.

      • JViews JSF components support Facelets 2 technologies in JSF 3.

      • JViews JSF components support jsf3 Partial Page Rendering technology without using the <f:ajax> tag.

Note

JViews Web technologies have their own Ajax implementation and do not therefore use the JSF 3 Ajax mechanism. When both JViews JSF components and other JSF 3 components are used on the same page, Ajax requests sent from JViews components do not enter the JSF 3 Ajax queue and are not managed by the JSF 3 Ajax mechanism.

Prerequisites for using JSF 3

To enable the JViews component to support JSF 3 run time, you must add the JSF 3 specific jar to your application classpath. For example:

Example    

classpath=jviews-jsf3-facelets-support.jar; jviews-xxx-all.jar

Using JViews JSF components to trigger the partial page rendering feature of JSF 3

JViews provides a new JSF 3 specific Facelets interactor called the ajaxInteractor to allow you to trigger the partial page rendering (PPR) feature of JSF 3 without using the <f:ajax> tag.

The ajaxInteractor allows you to trigger PPR actions to other JSF 3 components that you specify. When the user clicks a view that has an ajaxInteractor attached to it, a jsf.ajax.request() query is sent and JSF 3 components with specified IDs are re-rendered without the need to refresh the entire page.

Attributes

Name

Required

Type

Description

id

true

java.lang.String

The ID of this component.

render

true

java.lang.String

The IDs of the components to be rendered by the ajaxInteractor. This component sends a jsf.ajax.request() query to enable the JSF 3 to re-render the specified components.

Separate multiple IDs to be rendered with a space.

Usage

Before you can use the ajaxInteractor, you must ensure that the JSF 3 Ajax JavaScript library has been imported on your page.

The following code example shows how you can import the JSF 3 Ajax JavaScript library:

<h:outputScript name="jsf.js" library="javax.faces" target="head" />

The ajaxInteractor can be combined with any other interactor by using the interactorGroup.

The following code example shows how the ajaxInteractor can be combined with other interactors:

<html xmlns="http://www.w3.org/1999/xhtml"

   xmlns:f="http://java.sun.com/jsf/core"

   xmlns:h="http://java.sun.com/jsf/html"

   xmlns:jvf="http://www.ilog.com/jviews/tlds/jviews-framework-faces.tld"

   xmlns:jv="http://www.ilog.com/jviews/tlds/jviews-faces.tld" >

 

<h:body>

   <h:form prependId="false" id="helloForm">

      <h:outputScript name="jsf.js" library="javax.faces" target="head" />

 

      <h:outputText id="out1" value="#{count1.number}" />

      <h:outputText id="out2" value="#{count1.number}" />

 

      <jvf:objectSelectInteractor id="select"

          valueChangeListener="#{frameworkBean.selectObject}"

          invocationContext="IMAGE_SERVLET_CONTEXT" />

      <jv:ajaxInteractor id="ajax" render="out1 out2" />

      <jv:interactorGroup id="interactorGroup" interactors="select ajax" />

      <jvf:view id="view" style="width:500px;height:300px"

          view="#{frameworkBean.view}" interactorId="interactorGroup" />

 

   </h:form>

</h:body>

Using JSF 3 components to render JViews JSF components

To render JViews components, wrap the JViews component with a JSF container tag, for example, h:panelGrid and render the id of this panelGrid.

<h:commandButton id="button1" value="diagrammer"

   onclick="jsf.ajax.request(this,event,{render:'diagrammer_panelgrid'});return false;" />

 

<h:panelGrid id="diagrammer_panelgrid">

   <jvdf:diagrammerView id="diagrammer"

      style="width:500px;height:300px" data="/data/molecule.idpr"/>

</h:panelGrid>