| java.lang.Object
 __PACKAGE__.__NAME__
| __NAME__ | | public class __NAME__ implements Portlet(Code) | | The Portlet interface is used by the portlet container to
invoke the portlets. Every portlet has to implement this interface,
either by directly implementing it, or by using an existing class
implementing the Portlet interface.
A portlet is a Java technology based web component, managed by a portlet container, that
processes requests and generates dynamic content. Portlets are used by portals as
pluggable user interface components that provide a presentation layer to Information
Systems.
The content generated by a portlet is called a fragment. A fragment is a piece of
markup (e.g. HTML, XHTML, WML) adhering to certain rules and can be aggregated
with other fragments to form a complete document. The content of a portlet is normally
aggregated with the content of other portlets to form the portal page. The lifecycle of a
portlet is managed by the portlet container.
The portlet container instanciates portlets, manages their lifecycle
and invoking them to process requests. The lifecycle consists of:
- initializing the portlet using using the
init method
- request processsing
- taking the portlet out of service using the
destroy method
Request processing is divided into two types:
- action requests handled through the
processAction method,
to perform actions targeted to the portlet
- render requests handled through the
render method,
to perform the render operation
|
| Method Summary | |
| public void | destroy()
Called by the portlet container to indicate to a portlet that the
portlet is being taken out of service. | | public void | init(PortletConfig config)
Calle_d by the portlet container to indicate to a portlet that the
portlet is being placed into service. | | public void | processAction(ActionRequest request, ActionResponse actionResponse)
Notifies this portlet that a client request is triggered by an action URL to
this portlet. | | public void | render(RenderRequest request, RenderResponse response)
Notifies this portlet to generate its markup using the
given request/response pair. |
| __NAME__ | | public __NAME__()(Code) | | |
| destroy | | public void destroy()(Code) | | 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.
|
| init | | public void init(PortletConfig config) throws PortletException(Code) | | Calle_d 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
- Throws a
PortletException
- Does not return within a time period defined by the portlet container.
Parameters:
config - a PortletConfig object containing the portlet'sconfiguration and initialization parameters
exception:
PortletException - if an exception has occurred thatinterferes with the portlet's normaloperation.
exception:
UnavailableException - if the portlet is unavailable to perform init |
| processAction | | public void processAction(ActionRequest request, ActionResponse actionResponse) throws PortletException, java.io.IOException(Code) | | Notifies this portlet that a client request is triggered by an action URL to
this portlet.
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
change its persistent state
set render parameters
This method is only called if the portlet has created
an action URL with RenderResponse.createActionURL().
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.
Parameters:
request - the portlet request
Parameters:
actionResponse - the action response
exception:
PortletException - if the portlet has problems fulfilling therequest
exception:
UnavailableException - if the portlet is unavailable to perform processAction
exception:
PortletSecurityException - if the portlet cannot fullfill this request because of security reasons
exception:
IOException - if the streaming causes an I/O problem |
| render | | public void render(RenderRequest request, RenderResponse response) throws PortletException, java.io.IOException(Code) | | Notifies this portlet to generate its markup using the
given request/response pair. Depending
on the the current state and the requesting client device,
the markup might differ.
The state of a portlet may include, but is not restricted to:
the window state
the portlet portlet mode
render parameter
request attributes
preference data
session data
Parameters:
request - the portlet request
Parameters:
response - the render response
exception:
PortletException - if the portlet has problems fulfilling therendering request
exception:
UnavailableException - if the portlet is unavailable to perform render
exception:
PortletSecurityException - if the portlet cannot fullfill this request because of security reasons
exception:
IOException - if the streaming causes an I/O problem |
|
|