Saturday, June 3, 2006

Communication in JSF

Passing action parameters from JSF to backing beans

This can be done in several ways, with f:setPropertyActionListener, f:attribute and f:param.

f:setPropertyActionListener: with the h:commandLink and h:commandButton tags you can trigger a method of the backing bean using the action or the actionListener attribute. As you cannot directly pass some method parameters from the JSF to the backing bean, the f:setPropertyActionListener tag might be very useful to dynamically set the bean properties which can be used as parameters. This works in JSF 1.2 only. Here is an example:

<h:form>
    <h:commandLink value="Click here" action="#{myBean.action}">
        <f:setPropertyActionListener target="#{myBean.propertyName1}" value="propertyValue1" />
        <f:setPropertyActionListener target="#{myBean.propertyName2}" value="propertyValue2" />
    </h:commandLink>

    <h:commandButton value="Press here" action="#{myBean.action}">
        <f:setPropertyActionListener target="#{myBean.propertyName1}" value="propertyValue1" />
        <f:setPropertyActionListener target="#{myBean.propertyName2}" value="propertyValue2" />
    </h:commandButton>
</h:form>

This require at least a setter for propertyName1 and propertyName2 in the backing bean:

package mypackage;

public class MyBean {

    // Init --------------------------------------------------------------------------------------

    private String propertyName1;
    private String propertyName2;

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        System.out.println("propertyName1: " + propertyName1);
        System.out.println("propertyName2: " + propertyName2);
    }

    // Setters -----------------------------------------------------------------------------------

    public void setPropertyName1(String propertyName1) {
        this.propertyName1 = propertyName1;
    }

    public void setPropertyName2(String propertyName2) {
        this.propertyName2 = propertyName2;
    }

}

The properties propertyName1 and propertyName2 now should contain the values propertyValue1 and propertyValue2 respectively.

f:attribute: with the h:commandLink and h:commandButton tags you can also trigger a method of the backing bean using the actionListener attribute. With this you can also use the f:attribute tag to dynamically pass the parameters. Here is an example:

<h:form>
    <h:commandLink value="Click here" actionListener="#{myBean.action}">
        <f:attribute name="attributeName1" value="attributeValue1" />
        <f:attribute name="attributeName2" value="attributeValue2" />
    </h:commandLink>

    <h:commandButton value="Press here" actionListener="#{myBean.action}">
        <f:attribute name="attributeName1" value="attributeValue1" />
        <f:attribute name="attributeName2" value="attributeValue2" />
    </h:commandButton>
</h:form>

Those attributes can be retrieved using getAttributes() of the parent UI component, which on it's turn can be retrieved by the ActionEvent passed by the actionListener.

package mypackage;

import javax.faces.event.ActionEvent;

import net.balusc.util.FacesUtil;

public class MyBean {

    // Actions -----------------------------------------------------------------------------------

    public void action(ActionEvent event) {
        String attributeName1 = FacesUtil.getActionAttribute(event, "attributeName1");
        String attributeName2 = FacesUtil.getActionAttribute(event, "attributeName2");

        System.out.println("attributeName1: " + attributeName1);
        System.out.println("attributeName1: " + attributeName1);
    }

}
package net.balusc.util;

import javax.faces.event.ActionEvent;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static String getActionAttribute(ActionEvent event, String name) {
        return (String) event.getComponent().getAttributes().get(name);
    }

}

The variables attributeName1 and attributeName2 now should contain the values attributeValue1 and attributeValue2 respectively.

Take care that each attribute name should be unique and should not overwrite any default component attributes, like "id", "name", "value", "binding", "rendered", etc.

f:param: another way to pass parameters to the backing bean is using the f:param tag. This works on h:commandLink and h:outputLink only. The h:outputLink example is described in the next chapter. Here is the h:commandLink:

<h:form>
    <h:commandLink value="Click here" action="#{myBean.action}">
        <f:param name="parameterName1" value="parameterValue1" />
        <f:param name="parameterName2" value="parameterValue2" />
    </h:commandLink>
</h:form>

Those parameters can be retrieved using getRequestParameterMap() of the FacesContext. With the following utility method you can use the f:param name to request the f:param value of any f:param parameter specified in the command block:

package mypackage;

import net.balusc.util.FacesUtil;

public class MyBean {

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        String parameterName1 = FacesUtil.getRequestParameter("parameterName1");
        String parameterName2 = FacesUtil.getRequestParameter("parameterName2");

        System.out.println("parameterName1: " + parameterName1);
        System.out.println("parameterName2: " + parameterName2);
    }

}
package net.balusc.util;

import javax.faces.context.FacesContext;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static String getRequestParameter(String name) {
        return (String) FacesContext.getCurrentInstance().getExternalContext()
            .getRequestParameterMap().get(name);
    }

}

The variables parameterName1 and parameterName2 now should contain the values parameterValue1 and parameterValue2 respectively.

Back to top

Passing GET parameters from JSF to backing beans

This can be done easily using the h:outputLink tag with f:param:

<h:outputLink value="mypage.jsf">
    <f:param name="parameterName1" value="parameterValue1" />
    <f:param name="parameterName2" value="parameterValue2" />
    <h:outputText value="Click here" />
</h:outputLink>

Define those parameters in the faces-config.xml:

<managed-bean>
    <managed-bean-name>myBean</managed-bean-name>
    <managed-bean-class>mypackage.MyBean</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
    <managed-property>
        <property-name>parameterName1</property-name>
        <value>#{param.parameterName1}</value>
    </managed-property>
    <managed-property>
        <property-name>parameterName2</property-name>
        <value>#{param.parameterName2}</value>
    </managed-property>
</managed-bean>

And add those properties to the backing bean MyBean.java:

package mypackage;

public class MyBean {

    // Init --------------------------------------------------------------------------------------

    private String parameterName1;
    private String parameterName2;

    // Getters -----------------------------------------------------------------------------------

    public String getparameterName1() {
        return parameterName1;
    }

    public String getparameterName2() {
        return parameterName2;
    }

    // Setters -----------------------------------------------------------------------------------

    public void setparameterName1(String parameterName1) {
        this.parameterName1 = parameterName1;
    }

    public void setparameterName2(String parameterName2) {
        this.parameterName2 = parameterName2;
    }

}

The #{param} is a predefinied variable referring to the request parameter map which also can be retrieved by FacesContext.getCurrentInstance().getExternalContext().getRequestParameterMap(). Invoking a GET request using the following URL will set the parameter values automatically in the managed bean instance, thanks to the managed-property configuration in the faces-config.xml:
http://example.com/mypage.jsf?parameterName1=parameterValue1&parameterName2=parameterValue2

Back to top

Passing component attributes from JSF to backing beans

The f:attribute tag can also be used in conjunction with every UI component which is bound to the backing bean using the binding attribute of the UI component. All of those attributes can be retrieved using getAttributes() of the parent UI component. As you cannot directly pass some method parameters from the JSF to the getters and setters of the bound UI component in the backing bean, the f:attribute tag might be very useful to dynamically pass the parameters. Here is a basic JSF example with the h:outputText component bound to the backing bean:

<h:outputText binding="#{myBean.text}" value="#{myBean.textValue}">
    <f:attribute name="attributename" value="attributevalue" />
</h:outputText>

Take care that each attribute name should be unique and should not overwrite any default component attributes, like "id", "name", "value", "binding", "rendered", etc.

Here is the dummy example of the backing bean code:

package mypackage;

import javax.faces.component.html.HtmlOutputText;

public class MyBean {

    // Init --------------------------------------------------------------------------------------

    private HtmlOutputText text;

    // Getters -----------------------------------------------------------------------------------

    public HtmlOutputText getText() {
        return text;
    }

    public String getTextValue() {
        return (String) text.getAttributes().get("attributename");
    }

    // Setters -----------------------------------------------------------------------------------

    public void setText(HtmlOutputText text) {
        this.text = text;
    }

}

The value of the h:outputText now should contain the value set in the f:attribute tag.

Back to top

Passing objects from request to request

If you have a request scoped managed bean and you want to reuse a property, parameter and/or object for the next request, without reinitializing it again and again, then just use the h:inputhidden tag to save the object in it. Here is a basic JSF example:

<h:form>
    ...
    <h:inputHidden value="#{myBean.value}" />
    ...
</h:form>

One requirement is that the value should be a String, or Number, or Boolean (where JSF has built-in converters for which automatically converts between them and String) or a primitive, otherwise you have to write a custom converter for it.

You also can use the RequestMap to pass objects to the next request. Keep in mind that those will be garbaged after one request.

package net.balusc.util;

import javax.faces.context.FacesContext;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static Object getRequestMapValue(String key) {
        return FacesContext.getCurrentInstance().getExternalContext().getRequestMap().get(key);
    }

    // Setters -----------------------------------------------------------------------------------

    public static void setRequestMapValue(String key, Object value) {
        FacesContext.getCurrentInstance().getExternalContext().getRequestMap().put(key, value);
    }

}

Another way is to use the SessionMap to store the values which should be saved during one user session:

package net.balusc.util;

import javax.faces.context.FacesContext;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static Object getSessionMapValue(String key) {
        return FacesContext.getCurrentInstance().getExternalContext().getSessionMap().get(key);
    }

    // Setters -----------------------------------------------------------------------------------

    public static void setSessionMapValue(String key, Object value) {
        FacesContext.getCurrentInstance().getExternalContext().getSessionMap().put(key, value);
    }

}

This all is not needed for a session scoped managed bean as the managed bean instance won't be garbaged and re-instantiated on every request.

If you want to store static-like variables which are equal and accessible for all sessions, then you can use the ApplicationMap:

package net.balusc.util;

import javax.faces.context.FacesContext;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static Object getApplicationMapValue(String key) {
        return FacesContext.getCurrentInstance().getExternalContext().getApplicationMap().get(key);
    }

    // Setters -----------------------------------------------------------------------------------

    public static void setApplicationMapValue(String key, Object value) {
        FacesContext.getCurrentInstance().getExternalContext().getApplicationMap().put(key, value);
    }

}

Of course this one is also not needed for an application scoped managed bean.

Back to top

Passing new hidden values to backing beans

If you want to pass new hidden input values to the backing beans, either manipulated by Javascript or hardcoded manually, then you can use a plain vanilla HTML hidden input field with a form-unique name. Its value will be available in the getRequestParameterMap(). You can obtain it directly in the action method or even define a managed property for it in the backing bean. The example below makes use of the managed-property entry.

<h:form>
    <h:commandButton value="submit" action="#{myBean.action}"
        onclick="this.form.hiddenInput.value='foo';" />
    <input type="hidden" name="hiddenInput" />
</h:form>

The relevant part of the faces-config.xml:

<managed-bean>
    <managed-bean-name>myBean</managed-bean-name>
    <managed-bean-class>mypackage.MyBean</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
    <managed-property>
        <property-name>hiddenInput</property-name>
        <value>#{param.hiddenInput}</value>
    </managed-property>
</managed-bean>

The backing bean (the getter is indeed not required):

package mypackage;

import javax.faces.context.FacesContext;

public class MyBean {

    // Init --------------------------------------------------------------------------------------

    private String hiddenInput;

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        System.out.println("hiddenInput: " + hiddenInput);
        
        // It is also available as follows:
        System.out.println(FacesContext.getCurrentInstance().getExternalContext()
            .getRequestParameterMap().get("hiddenInput"));
        // In this case the property as well as managed-property are redundant.
    }

    // Setters -----------------------------------------------------------------------------------

    public void setHiddenInput(String hiddenInput) {
        this.hiddenInput = hiddenInput;
    }

}
Back to top

Communication between managed beans

You can have more than one managed bean in a scope. If required by design, then you can use getSessionMap() of the FacesContext to communicate between the managed beans during one browser session. This can be very useful for user-sessions by example.

An example of two managed beans in the faces-config.xml:

<managed-bean>
    <managed-bean-name>myBean1</managed-bean-name>
    <managed-bean-class>mypackage.MyBean1</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
</managed-bean>

<managed-bean>
    <managed-bean-name>myBean2</managed-bean-name>
    <managed-bean-class>mypackage.MyBean2</managed-bean-class>
    <managed-bean-scope>session</managed-bean-scope>
</managed-bean>

The managed beans myBean1 and myBean2 are instances of the backing beans MyBean1.java and MyBean2.java, which can be accessed by JSF pages. It don't matter whether the managed-bean-scope is set to request or session. With the managed-bean-scope set to session, the same instance of the backing bean will be used during the whole session. When the scope is set to request, then each request (form action) will create a new instance of the backing bean everytime.

You can use the getSessionMapValue() and setSessionMapValue() of the FacesUtil which is mentioned in the former paragraph to get and set values in the SessionMap. Here is an use example:

package mypackage;

import net.balusc.util.FacesUtil;

public class MyBean1 {

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        String value = "value1";
        FacesUtil.setSessionMapValue("MyBean1.value", value);
    }

}
package mypackage;

import net.balusc.util.FacesUtil;

public class MyBean2 {

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        String value = (String) FacesUtil.getSessionMapValue("MyBean1.value");
    }

}

The variable value now should contain the value value1. Of course only if already set by another managed bean.

Back to top

Injecting managed beans in each other

You can also inject the one managed bean in the other managed bean as a property. This may be useful if you have an application scoped bean for e.g. configurations and you want to use it in a session or request scoped bean. This is also useful if you want to keep the large data of datatables in session scope and the form actions in request scope.

Here is an example of an application scoped and request scoped managed bean in the faces-config.xml where the application scoped bean is injected in the request scoped bean:

<managed-bean>
    <managed-bean-name>myBean1</managed-bean-name>
    <managed-bean-class>mypackage.MyBean1</managed-bean-class>
    <managed-bean-scope>application</managed-bean-scope>
</managed-bean>

<managed-bean>
    <managed-bean-name>myBean2</managed-bean-name>
    <managed-bean-class>mypackage.MyBean2</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
    <managed-property>
        <property-name>myBean1</property-name>
        <value>#{myBean1}</value>
    </managed-property>
</managed-bean>

Where the MyBean2 look like:

package mypackage;

public class MyBean2 {

    // Init --------------------------------------------------------------------------------------

    private MyBean1 myBean1;

    // Getters -----------------------------------------------------------------------------------

    public MyBean1 getMyBean1() {
        return myBean1;
    }

    // Setters -----------------------------------------------------------------------------------

    public void setMyBean1(MyBean1 myBean1) {
        this.myBean1 = myBean1;
    }

}
Back to top

Accessing another managed bean

If you have more than one managed bean in a scope and you want to get the current instance of the another managed bean and get access to it's properties, then there are seven ways to get the instance using the FacesContext. You can use getRequestMap, getSessionMap, getApplicationMap, getVariableResolver, createValueBinding, getELResolver (since JSF 1.2) or createValueExpression (since JSF 1.2).

An example of two managed beans in the faces-config.xml:

<managed-bean>
    <managed-bean-name>myBean1</managed-bean-name>
    <managed-bean-class>mypackage.MyBean1</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
</managed-bean>

<managed-bean>
    <managed-bean-name>myBean2</managed-bean-name>
    <managed-bean-class>mypackage.MyBean2</managed-bean-class>
    <managed-bean-scope>session</managed-bean-scope>
</managed-bean>

The managed beans myBean1 and myBean2 are instances of the backing beans MyBean1.java and MyBean2.java, which can be accessed by JSF pages. It don't matter whether the managed-bean-scope is set to request or session. Only take care that you can use the getRequestMap method only when the scope of the another managed bean is set to request, and you can use the getSessionMap only when the scope of the another managed bean is set to session.

The JSF use example:

<h:form>
    <h:commandButton action="#{myBean1.action1}" value="action1" />
    <h:commandButton action="#{myBean1.action2}" value="action2" />
    <h:commandButton action="#{myBean1.action3}" value="action3" />
    <h:commandButton action="#{myBean1.action4}" value="action4" />
    <h:commandButton action="#{myBean1.action5}" value="action5" />
    <h:commandButton action="#{myBean1.action6}" value="action6" />
    <h:commandButton action="#{myBean1.action7}" value="action7" />
    <h:outputText binding="#{myBean2.text}" />
</h:form>

Here is the first bean, MyBean1.java. Note that you should access the another managed bean by the managed-bean-name as definied in the faces-config.xml.

package mypackage;

import javax.faces.context.FacesContext;

public class MyBean1 {

    // Actions -----------------------------------------------------------------------------------

    // Using RequestMap. NOTE: myBean2 should be request scoped!
    public void action1() {
        MyBean2 myBean2 = (MyBean2) FacesContext.getCurrentInstance().getExternalContext()
            .getRequestMap().get("myBean2");
                            
        // This only works if myBean2 is request scoped.
        if (myBean2 != null) {
            myBean2.getText().setValue("action1");
        }
    }

    // Using SessionMap. NOTE: myBean2 should be session scoped!
    public void action2() {
        MyBean2 myBean2 = (MyBean2) FacesContext.getCurrentInstance().getExternalContext()
            .getSessionMap().get("myBean2");
                            
        // This only works if myBean2 is session scoped.
        if (myBean2 != null) {
            myBean2.getText().setValue("action2");
        }
    }

    // Using ApplicationMap. NOTE: myBean2 should be application scoped!
    public void action3() {
        MyBean2 myBean2 = (MyBean2) FacesContext.getCurrentInstance().getExternalContext()
            .getApplicationMap().get("myBean2");
                            
        // This only works if myBean2 is application scoped.
        if (myBean2 != null) {
            myBean2.getText().setValue("action3");
        }
    }

    // Using VariableResolver. NOTE: this is deprecated since JSF 1.2!
    public void action4() {
        FacesContext context = FacesContext.getCurrentInstance();
        MyBean2 myBean2 = (MyBean2) context.getApplication()
            .getVariableResolver().resolveVariable(context, "myBean2");

        myBean2.getText().setValue("action4");
    }

    // Using ValueBinding. NOTE: this is deprecated since JSF 1.2!
    public void action5() {
        FacesContext context = FacesContext.getCurrentInstance();
        MyBean2 myBean2 = (MyBean2) context.getApplication()
            .createValueBinding("#{myBean2}").getValue(context);

        myBean2.getText().setValue("action5");
    }

    // Using ELResolver. NOTE: this is implemented since JSF 1.2!
    public void action6() {
        FacesContext context = FacesContext.getCurrentInstance();
        MyBean2 myBean2 = (MyBean2) context.getELContext()
            .getELResolver().getValue(context.getELContext(), null, "myBean2");

        myBean2.getText().setValue("action6");
    }

    // Using ValueExpression. NOTE: this is implemented since JSF 1.2!
    public void action7() {
        FacesContext context = FacesContext.getCurrentInstance();
        MyBean2 myBean2 = (MyBean2) context.getApplication().getExpressionFactory()
            .createValueExpression(context.getELContext(), "#{myBean2}", MyBean2.class)
                .getValue(context.getELContext());

        myBean2.getText().setValue("action7");
    }

}

The second bean, MyBean2.java:

package mypackage;

import javax.faces.component.html.HtmlOutputText;

public class MyBean2 {

    // Init --------------------------------------------------------------------------------------

    private HtmlOutputText text;

    // Getters -----------------------------------------------------------------------------------

    public HtmlOutputText getText() {
        return text;
    }

    // Setters -----------------------------------------------------------------------------------

    public void setText(HtmlOutputText text) {
        this.text = text;
    }

}
Back to top

Returning current managed bean instance of self

You can also let the backing bean return the current managed bean instance of self using a static method. Here is an example with a request scoped managed bean:

<managed-bean>
    <managed-bean-name>myBean1</managed-bean-name>
    <managed-bean-class>mypackage.MyBean1</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
</managed-bean>

<managed-bean>
    <managed-bean-name>myBean2</managed-bean-name>
    <managed-bean-class>mypackage.MyBean2</managed-bean-class>
    <managed-bean-scope>session</managed-bean-scope>
</managed-bean>

Where the MyBean1 look like:

package mypackage;

import javax.faces.context.FacesContext;

public class MyBean1 {

    // Init --------------------------------------------------------------------------------------

    private static final String MANAGED_BEAN_NAME = "myBean1";

    // Actions -----------------------------------------------------------------------------------

    public static MyBean1 getCurrentInstance() {
        return (MyBean1) FacesContext.getCurrentInstance().getExternalContext()
            .getRequestMap().get(MANAGED_BEAN_NAME);
    }

}

So you can get the current instance of MyBean1 in the another bean as follows:

package mypackage;

public class MyBean2 {

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        MyBean1 myBean1 = MyBean1.getCurrentInstance();
    }

}

You can find an use example in the FriendlyUrlAction bean in the Friendly URL's in JSF article.

Back to top

Lookup the managed bean name inside the backing bean

You can have more than one managed bean instance of the same backing bean. This might be useful if you want to implement different ways to use the backing bean. When you need to know the assigned managed bean name inside the current instance of the backing bean, then you need to lookup the values of the requestmap, sessionmap or applicationmap and compare them with the current instance of the backing bean. If it is equal, then the associated key is the same as the managed bean name.

package net.balusc.util;

import java.util.Map;

import javax.faces.context.ExternalContext;

public class FacesUtil {

    // Helpers -----------------------------------------------------------------------------------

    public static String lookupManagedBeanName(Object bean) {
        ExternalContext externalContext = FacesContext.getCurrentInstance().getExternalContext();

        // Get requestmap.
        Map<String, Object> requestMap = externalContext.getRequestMap();
    
        // Lookup the current bean instance in the request scope.
        for (String key : requestMap.keySet()) {
            if (bean.equals(requestMap.get(key))) {
                // The key is the managed bean name.
                return key;
            }
        }
    
        // Bean is not in the request scope. Get the sessionmap then.
        Map<String, Object> sessionMap = externalContext.getSessionMap();

        // Lookup the current bean instance in the session scope.
        for (String key : sessionMap.keySet()) {
            if (bean.equals(sessionMap.get(key))) {
                // The key is the managed bean name.
                return key;
            }
        }

        // Bean is also not in the session scope. Get the applicationmap then.
        Map<String, Object> applicationMap = externalContext.getApplicationMap();

        // Lookup the current bean instance in the application scope.
        for (String key : applicationMap.keySet()) {
            if (bean.equals(applicationMap.get(key))) {
                // The key is the managed bean name.
                return key;
            }
        }

        // Bean is also not in the application scope.
        // Is the bean's instance actually a managed bean instance then? =)
        return null;
    }

}

You can call it as follows:

package mypackage;

import net.balusc.util.FacesUtil;

public class MyBean {

    // Actions -----------------------------------------------------------------------------------

    public void action() {
        String managedBeanName = FacesUtil.lookupManagedBeanName(this);
    }

}

Although remember that this is not always a good practice. If you can, rather subclass (extend) the backing bean into another backing bean and if necessary override or add some more code. Then assign another managed bean name to the subclassed backing bean.

Back to top

Accessing the FacesContext inside HttpServlet or Filter

Other Servlets than the FacesServlet and all Filters cannot directly access the FacesContext in the same web container, because they are sitting in the ServletContext outside the FacesContext. When you want to request the FacesContext instance outside the FacesContext, you'll get FacesContext.getCurrentInstance() == null. In this case you need to precreate the FacesContext yourself.

package mypackage;

import java.io.IOException;
import java.util.Map;

import javax.faces.context.FacesContext;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import net.balusc.util.FacesUtil;

public class MyServlet extends HttpServlet {

    // Actions -----------------------------------------------------------------------------------

    public void doGet(HttpServletRequest request, HttpServletResponse response) {
        doSomething(request, response);
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response) {
        doSomething(request, response);
    }

    private void doSomething(HttpServletRequest request, HttpServletResponse response) {

        // Get the FacesContext inside HttpServlet.
        FacesContext facesContext = FacesUtil.getFacesContext(request, response);

        // Now you can do your thing with the facesContext.
    }

}

And here is how you can precreate the FacesContext:

package net.balusc.util;

import javax.faces.FactoryFinder;
import javax.faces.component.UIViewRoot;
import javax.faces.context.FacesContext;
import javax.faces.context.FacesContextFactory;
import javax.faces.lifecycle.Lifecycle;
import javax.faces.lifecycle.LifecycleFactory;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class FacesUtil {

    // Getters -----------------------------------------------------------------------------------

    public static FacesContext getFacesContext(
        HttpServletRequest request, HttpServletResponse response)
    {
        // Get current FacesContext.
        FacesContext facesContext = FacesContext.getCurrentInstance();

        // Check current FacesContext.
        if (facesContext == null) {

            // Create new Lifecycle.
            LifecycleFactory lifecycleFactory = (LifecycleFactory)
                FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY); 
            Lifecycle lifecycle = lifecycleFactory.getLifecycle(LifecycleFactory.DEFAULT_LIFECYCLE);

            // Create new FacesContext.
            FacesContextFactory contextFactory  = (FacesContextFactory)
                FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);
            facesContext = contextFactory.getFacesContext(
                request.getSession().getServletContext(), request, response, lifecycle);

            // Create new View.
            UIViewRoot view = facesContext.getApplication().getViewHandler().createView(
                facesContext, "");
            facesContext.setViewRoot(view);                

            // Set current FacesContext.
            FacesContextWrapper.setCurrentInstance(facesContext);
        }

        return facesContext;
    }

    // Helpers -----------------------------------------------------------------------------------

    // Wrap the protected FacesContext.setCurrentInstance() in a inner class.
    private static abstract class FacesContextWrapper extends FacesContext {
        protected static void setCurrentInstance(FacesContext facesContext) {
            FacesContext.setCurrentInstance(facesContext);
        }
    }     

}

Think twice about this practice and don't misuse it. If you're using a Filter and you want to access the FacesContext, then rather use a PhaseListener instead and listen on the first phase (the PhaseId.RESTORE_VIEW). If you just want to pass objects (attributes) from the ServletContext to the FacesContext using a HttpServlet, then rather use the getAttribute() and setAttribute() methods of the HttpServletRequest (which reflects to the RequestMap), or the HttpSession (which reflects to the SessionMap), or the ServletContext (which reflects to the ApplicationMap).

The HttpSession is accessible in the HttpServlet using HttpServletRequest#getSession() and the ServletContext is accessible in the HttpServlet using the inherited method getServletContext().

Back to top

Copyright - There is no copyright on the code. You can copy, change and distribute it freely. Just mentioning this site should be fair.

(C) June 2006, BalusC

38 comments:

Joachim said...

Thanks, fine article about parameters in JSF action calls. But you should add a note that commas in ths "attrvalue1" string causes lot of trouble.

Feba said...

This section is one of the most referred section, during our development, which is in JSF. Thanks a lot for all your tips, and also to your posts in related topics in Sun's forum.

Cheers !!

Feba Mary

Gunjan Bohra said...

Thanks for this fine artical .
And thank for you effort on Sun forum ...

Noah said...

Thanks for the tips. One additional comment about "Accessing the FacesContext inside HttpServlet or Filter". This approach works great, but we found that if we were calling different servlets that used this approach, we need to call "context.release()" at the end of each servlet call. If you look at the source code in the FacesServlet, you can see the same approach is used.

Thanks,
Noah

Sandro Mancuso said...

Thank you very much for your article. It is very well written and helpful.
The best that I read so far about the topic.

Cheers.

Sandro

frosted said...

Great article! Do you know of a way to pass parameters to the rendered attribute of an inputText or any other such field?

Cheers!

BalusC said...

Use f:attribute. See the section "Passing component attributes from JSF to backing beans".

frosted said...

Thanks for the VERY quick response. I think the problem is that rendered expects to see a property of a backing bean rather than a method call, thus there is no UIComponent being passed to the method, if I am correct. I believe "action" and "actionListener" behave differently, and execute a set method signature, whereas rendered only looks for a "getProperty" method with no args. I could be wrong, though...it's happened before...a few hundred times :)

BalusC said...

That section actually demonstrates exactly what you need. In your specific case just replace the h:outputText by h:inputText, the HtmlOutputText by HtmlInputText, the value="" by rendered="" and public String getTextValue() by public boolean isRendered() -or so. Inside the isRendered() method, the attribute value is available to you the same way.

frosted said...

Yes, you are correct. Thank you so much again! One more quick question, is there any way in said method (isRendered(), for example) to get a reference to the current element on which the rendered attribute method is being executed. I am trying to set up a generic enough security-related method that will not have to be written for each component. A daunting task, for sure. Again, thanks for all the help so far :)

demonm said...

Hello! I tried to adopt example with attributes to use it with dataTable, but had problems with null here. Maybe problem in using non-standard components, because I use ICEfaces (AJAX on background). I posted my problem on it support forum here
http://www.icefaces.org/JForum/posts/list/0/6520.page

Maybe somebody can help me with solution. Thanks in advance!

BalusC said...

During the first time that the component binding getter is invoked, the attribute will indeed return null, simply because it is not set yet. Obtain the attribute in the action method or in the getter of the datalist.

Nicolas said...

To begin with, thanks for the article and all your help at the Java Forums. I'm left with a doubt, though. Have you found any "tidy" ways to pass a collection from two beans in request scope?
As in <h:inputHidden id="items" value="#{myBean.myCollection}">

Thanks again and happy new year.

BalusC said...

Nicolas: for non-String and non-Number typed objects you'll have to write a Converter or, in this case better, to use the RequestMap.

Nicolas said...

Hi Balus. I've been trying your suggestion and focused on using the RequestMap. My problem is that the collection items are being passed from/to the same backing bean. In other words, I've got the same page in faces-context from-view-id and to-view-id. When filling values with requestMap.put(..) in that situation, I find that they're not loaded afterwards.
If this is the wrong place to be asking you questions, and you still want to help, you can reach me at gmail with username s.nico.zeitlin
Thanks again!

merkas said...

If I have session scoped beans what's the benefits using ELResolver to access another managed bean instead of using SessionMap?

BalusC said...

The only benefit is that you don't need to specify the scope. If you ever change the scope in the faces-config.xml, you'll also have to change the codings.

dim5b said...

Great article, i am looking to create a login based application therefore I have a request scope bean loginBean and within the login action create UserBean(usernane,pwd)which is session scoped. here begins my problem.. i am looking to use ajax push (icefaces)
http://www.icefaces.org/JForum/posts/list/4351.page
In this post they instruct to create a request scoped bean to update the PersistentFacesState of the session bean were do I inject this ...

nohacks said...

Great stuff...Thanks for all the work !!

I have a question.

When I use this:

((h:form))
((h:commandLink value="Click here" actionListener="#{myBean.action}"))
((f:attribute name="attributeName1" value="attributeValue1" /))
((f:attribute name="attributeName2" value="attributeValue2" /))
((/h:commandLink))

((h:commandButton value="Press here" actionListener="#{myBean.action}"))
((f:attribute name="attributeName1" value="attributeValue1" /))
((f:attribute name="attributeName2" value="attributeValue2" /))
((/h:commandButton))
((/h:form))



package mypackage;

import javax.faces.event.ActionEvent;

import net.balusc.util.FacesUtil;

public class MyBean {

// Actions -----------------------------------------------------------------------------------

public void action(ActionEvent event) {
String attributeName1 = FacesUtil.getActionAttribute(event, "attributeName1");
String attributeName2 = FacesUtil.getActionAttribute(event, "attributeName2");

System.out.println("attributeName1: " + attributeName1);
System.out.println("attributeName1: " + attributeName1);
}

}

-----------------------------

I am calling MyBean.Action.

Works great for passing value to bean from JSP. How do I use that bean Action to move to the next JSP page? Since it is a void and does not return anything for faces-config.xml to navigate??

Thanks
Phil

nohacks said...

Hey,

I fixed my issue..

thanks for your time.

Nohacks

Phil

harpreet said...

Thanks Baluc

It helped me great.
Awsome blog.


Harry

cptnRidesFaster said...

Hi,

Just wanted to thank you for your blog.

While much of what is out there focuses on solutions to highly specialized esoteric problems which I probably won't ever encounter, your blog contains examples of how to solve and implement very simple and usable solutions.

This is extremely important. Keep the examples rolling. Nothing is ever too simple.

Leonardo said...

Great!!! It saved my life!

Dj said...

I'm learning JSF from your blog and I noticed an interesting behavior when using f:setPropertyActionListner. It works great when passing in strings but if fails when I pass it a value expression (value expression does evaluate correctly). ex:

h:commandButton value="Press here" action="#{myBean.action}"
f:setPropertyActionListener target="#{myBean.propertyName1}" value="#{bean2.propertyValue1}"
...

have you noticed this from your experience?

BalusC said...

Apparently bean2 is request scoped and the getter of its propertyValue1 returns null in the next request. Either put it in the session scope or use h:inputHidden to retain this value for the next request.

Dj said...

now i see the light!:) how did you become so good at jsf? what do you recommend I do to come up to speed? i'm currently reading your blog and writing a sample app so I can learn the framework.
Thanks.

Luke said...

Great article.
I've a question for pass parameter to backing bean.

<sql:query sql = "SELECT PLI_ITEM_NO,PLI_TRNH_LEN,PLI_TRNH_WID,PLI_TRNH_DEP FROM PLI_PLAN_ITEM WHERE PLI_PLAN_ID = ${pid} AND PLI_ITEM_NO = ${iid}" var = "itemresult" dataSource="${db}">
</sql:query>
<table id="ro-item" cellspacing="0" cellpadding="3" border="0">
<c:forEach var="itemrow" items="${itemresult.rows}">
<c:set var="irl" value="${itemrow.PLI_TRNH_LEN}"/>
<c:set var="irw" value="${itemrow.PLI_TRNH_WID}"/>
<c:set var="ird" value="${itemrow.PLI_TRNH_DEP}"/>
<tr><td>Length:</td*lt;
<td><h:inputText id="itemlength" value="#{irl}" size="6"></h:inputText>m</td></tr>
<tr><td>Width:</td>
<td><h:inputText id="itemwidth" value="#{irw}" size="6"></h:inputText>m
</td></tr>
<tr><td>Depth:</td>
<td><h:inputText id="itemdepth" value="#{ird}" size="6"></h:inputText>m</td></tr>
</c:forEach>
</table>
<h:commandButton id="submit" value="Submit" actionListener="#{planBean.action}">
<f:attribute name="attributeName1" value="attributeValue1" />
<f:attribute name="attributeName2" value="attributeValue2" />
</h:commandButton>

When user clicks the commandbutton, it will throw a NullPointException. I wonder why I can't pass the variable to the backing bean. Thank you in advance.

bvh said...

This is a fantastic article especially for JSF beginners like me. I have tried the samples and everything works great.
However I could not understand how I can specify what action should be executed if I provide the user with a url such as:

http://mycompany.com/product.jsp?product_id=123

How can I specify that the above link should execute MyBean.abcAction and if the result is “success” then user gets redirected to the product’s page otherwise to an error page?

I have the task of sending emails to users and in these emails I have to provide users with links to the latest products added to the database. In a pure JSP the link would look like the one above.

I am not sure if this can be done with commandButton or commandLink as they seem to use the session id which will be invalid in an email.

I would very much appreciate if somebody could help me with this.

Regards,
Byurhan

Luke said...

Sorry I made a mistake. Instead of <f:attribute name="attributeName1" value="attributeValue1" />
It should be <f:attribute name="attributeName1" value="#{irl}" />
Thank you.

dmanohar said...

Excellent article
so handy to refer

chandra shekar yeruva said...

hi Baluc can you please let me know how to pass value in input hidden.
My scenario as folllows..
I am getting some additional inforamtion from request and i need to get that info from request and need to pass to a bean to refer somewhere.how can i do that one.

h:inputHidden id="hidden value 1" value = "value got from servlet request."

how can i set the value "value got from servlet request" to a bean property.?

Can anyone help me on this I am a new guy to JSF.

calfred56 said...

Hi,

Great site. I've been able to use the posts on storing/accessing user objects in the various Faces contexts.

I have a JSF prototype application that is deployed in Tomcat 5.5. When using a browser that supports tabs connects to this application on more than one tab, I'm finding that the tabs seem to share a common JSF Session.

Is there a way to force different tabs to use different sessions?

If not, is there a technique for tracking when the user switches between browser tabs?

Thanks,
Charlie

Bauke said...

There is not.

To solve your problem, keep the data in question request scoped instead of session scoped. You can use h:inputHidden or requestMap to transfer data from request to request.

calfred56 said...

Thanks. I was afraid that was going the be answer :-)

Irina said...

I have application that displays customer data in the table form. I don’t know the data structure in advance, so I came up with the following architecture:

I have report.jsp page that include reporttable.jsp or custom reportable.jsp

report.jsp
...
<f:subview id="invTable">
<jsp:include page="#{reportBean.tableJsp}"/>
</f:subview>
...


tableJsp string is pointed to /reporttable.jsp or /customer1/reporttable.jsp depending on the customer needs.

reporttable.jsp
...
<h:dataTable id="tableData" value="#{reportBean.reportData}" var="rpt" >
<c:forEach items="#{reportBean.columnNames}" var="name">
<h:column>
<f:facet name="header">
<h:outputText value="#{name}" />
</f:facet>
<h:outputText value="#{rpt[name]}"/>
</h:column>
</c:forEach>
</h:dataTable>
...


For the customer that need something different I create customer1Bean that will return customized reportDate

/customer1/reportable.jsp
It maybe different from the generic jsp, but also can be almost the same except the bean it calls
...
<h:dataTable id="tableData" value="#{customer1Bean.reportData}" var="rpt" >
...

I am wondering, if there is a way to call correct bean dynamically, so I don’t have to duplicate pages if they are the same.

I would appreciate any suggestions.
Irina.

calfred56 said...

Hi Irina,

Is it possible to have your list beans implement a common Java interface? Especially one that can support generic methods like:

Object getValue(String name) and
void setValue(String name, Object value)?

If so, it might be possible to stash the field (column) names in hidden inputs, and pass the values in as the 'name' argument.

I haven't actually tried this, but it seems like it has the potential to work.

Charlie

Raja Nagendra Kumar said...

This is Awsome knowlege on JSF.. Your insites into jsf programing is great..

Regards,
Raja Nagendra Kumar,
C.T.O
www.tejasoft.com

f0rsa said...

Hi first thanks for article..

Do you have any idea how to pass an h:inputText value as an attributes.I have try lots of thing but I couldn't manage .