org.jboss.portal.faces.loader
Class FacesPortlet

java.lang.Object
  org.jboss.portal.faces.loader.FacesPortlet

All Implemented Interfaces:

Portlet

public class FacesPortlet
extends java.lang.Object
implements Portlet

Version:

$Revision: 1.1 $

Author:

Julien Viet

Constructor Summary

FacesPortlet()

Method Summary

void	destroy() Called by the portlet container to indicate to a portlet that the portlet is being taken out of service.
void	init(PortletConfig config) Called by the portlet container to indicate to a portlet that the portlet is being placed into service.
void	processAction(ActionRequest request, ActionResponse response) Called by the portlet container to allow the portlet to process an action request.
void	render(RenderRequest request, RenderResponse response) Called by the portlet container to allow the portlet to generate the content of the response based on its current state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FacesPortlet

public FacesPortlet()

Method Detail

init

public void init(PortletConfig config)
          throws PortletException

Description copied from interface: Portlet

Called by the portlet container to indicate to a portlet that the portlet is being placed into service.

The portlet container calls the init method exactly once after instantiating the portlet. The init method must complete successfully before the portlet can receive any requests.

The portlet container cannot place the portlet into service if the init method

1. Throws a PortletException
2. Does not return within a time period defined by the portlet container.

Specified by:

init in interface Portlet

Parameters:

config - a PortletConfig object containing the portlet's configuration and initialization parameters

Throws:

PortletException - if an exception has occurred that interferes with the portlet's normal operation.

UnavailableException - if the portlet cannot perform the initialization at this time.

processAction

public void processAction(ActionRequest request,
                          ActionResponse response)
                   throws PortletException,
                          PortletSecurityException,
                          java.io.IOException

Description copied from interface: Portlet

Called by the portlet container to allow the portlet to process an action request. This method is called if the client request was originated by a URL created (by the portlet) with the RenderResponse.createActionURL() method.

Typically, in response to an action request, a portlet updates state based on the information sent in the action request parameters. In an action the portlet may:

• issue a redirect
• change its window state
• change its portlet mode
• modify its persistent state
• set render parameters

A client request triggered by an action URL translates into one action request and many render requests, one per portlet in the portal page. The action processing must be finished before the render requests can be issued.

Specified by:

processAction in interface Portlet

Parameters:

request - the action request

response - the action response

Throws:

PortletException - if the portlet has problems fulfilling the request

UnavailableException - if the portlet is unavailable to process the action at this time

PortletSecurityException - if the portlet cannot fullfill this request because of security reasons

java.io.IOException - if the streaming causes an I/O problem

render

public void render(RenderRequest request,
                   RenderResponse response)
            throws PortletException,
                   PortletSecurityException,
                   java.io.IOException

Description copied from interface: Portlet

Called by the portlet container to allow the portlet to generate the content of the response based on its current state.

Specified by:

render in interface Portlet

Parameters:

request - the render request

response - the render response

Throws:

PortletException - if the portlet has problems fulfilling the rendering request

UnavailableException - if the portlet is unavailable to perform render at this time

PortletSecurityException - if the portlet cannot fullfill this request because of security reasons

java.io.IOException - if the streaming causes an I/O problem

destroy

public void destroy()

Description copied from interface: Portlet

Called by the portlet container to indicate to a portlet that the portlet is being taken out of service.

Before the portlet container calls the destroy method, it should allow any threads that are currently processing requests within the portlet object to complete execution. To avoid waiting forever, the portlet container can optionally wait for a predefined time before destroying the portlet object.

This method enables the portlet to do the following:

• clean up any resources that it holds (for example, memory, file handles, threads)
• make sure that any persistent state is synchronized with the portlet current state in memory.

Specified by:

destroy in interface Portlet