com.liferay.portletmvc4spring

Class GenericPortletBean

java.lang.Object

javax.portlet.GenericPortlet

com.liferay.portletmvc4spring.GenericPortletBean

All Implemented Interfaces:

javax.portlet.EventPortlet, javax.portlet.HeaderPortlet, javax.portlet.Portlet, javax.portlet.PortletConfig, javax.portlet.ResourceServingPortlet, Aware, EnvironmentAware, EnvironmentCapable

Direct Known Subclasses:

FrameworkPortlet

public abstract class GenericPortletBean
extends javax.portlet.GenericPortlet
implements EnvironmentCapable, EnvironmentAware

Simple extension of javax.portlet.GenericPortlet that treats its config parameters as bean properties.

A very handy superclass for any type of portlet. Type conversion is automatic. It is also possible for subclasses to specify required properties.

This portlet leaves request handling to subclasses, inheriting the default behaviour of GenericPortlet (doDispatch, processAction, etc).

This portlet superclass has no dependency on a Spring application context, in contrast to the FrameworkPortlet class which loads its own context.

Since:

2.0

Author:

William G. Thompson, Jr., John A. Lewis, Juergen Hoeller

See Also:

addRequiredProperty(java.lang.String), initPortletBean(), GenericPortlet.doDispatch(javax.portlet.RenderRequest, javax.portlet.RenderResponse), GenericPortlet.processAction(javax.portlet.ActionRequest, javax.portlet.ActionResponse), FrameworkPortlet

Field Summary

Fields

Modifier and Type	Field and Description
protected Log	logger Logger available to subclasses

Constructor Summary

Constructors

Constructor and Description
GenericPortletBean()

Method Summary

Modifier and Type	Method and Description
protected void	addRequiredProperty(String property) Subclasses can invoke this method to specify that this property (which must match a JavaBean property they expose) is mandatory, and must be supplied as a config parameter.
protected ConfigurableEnvironment	createEnvironment() Create and return a new StandardPortletEnvironment.
ConfigurableEnvironment	getEnvironment()
javax.portlet.PortletContext	getPortletContext() Overridden method that simply returns null when no PortletConfig set yet.
String	getPortletName() Overridden method that simply returns null when no PortletConfig set yet.
void	init() Map config parameters onto bean properties of this portlet, and invoke subclass initialization.
protected void	initBeanWrapper(BeanWrapper bw) Initialize the BeanWrapper for this GenericPortletBean, possibly with custom editors.
protected void	initPortletBean() Subclasses may override this to perform custom initialization.
void	setEnvironment(Environment environment)

Methods inherited from class javax.portlet.GenericPortlet

destroy, dispatchAnnotatedActionMethod, dispatchAnnotatedEventMethod, dispatchAnnotatedRenderMethod, doDispatch, doEdit, doHeaders, doHelp, doView, getContainerRuntimeOptions, getDefaultNamespace, getInitParameter, getInitParameterNames, getNextPossiblePortletModes, getPortletConfig, getPortletModes, getProcessingEventQNames, getPublicRenderParameterDefinitions, getPublicRenderParameterNames, getPublishingEventQNames, getResourceBundle, getSupportedLocales, getTitle, getWindowStates, init, processAction, processEvent, render, renderHeaders, serveResource

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Log logger

Logger available to subclasses

Constructor Detail

GenericPortletBean

public GenericPortletBean()

Method Detail

getEnvironment

public ConfigurableEnvironment getEnvironment()

If null, a new environment will be initialized via createEnvironment().

Specified by:

getEnvironment in interface EnvironmentCapable

getPortletContext

public final javax.portlet.PortletContext getPortletContext()

Overridden method that simply returns null when no PortletConfig set yet.

Specified by:

getPortletContext in interface javax.portlet.PortletConfig

Overrides:

getPortletContext in class javax.portlet.GenericPortlet

See Also:

GenericPortlet.getPortletConfig()

getPortletName

public final String getPortletName()

Overridden method that simply returns null when no PortletConfig set yet.

Specified by:

getPortletName in interface javax.portlet.PortletConfig

Overrides:

getPortletName in class javax.portlet.GenericPortlet

See Also:

GenericPortlet.getPortletConfig()

init

public final void init()
                throws javax.portlet.PortletException

Map config parameters onto bean properties of this portlet, and invoke subclass initialization.

Overrides:

init in class javax.portlet.GenericPortlet

Throws:

javax.portlet.PortletException - if bean properties are invalid (or required properties are missing), or if subclass initialization fails.

setEnvironment

public void setEnvironment(Environment environment)

Specified by:

setEnvironment in interface EnvironmentAware

Throws:

IllegalArgumentException - if environment is not assignable to ConfigurableEnvironment.

addRequiredProperty

protected final void addRequiredProperty(String property)

Subclasses can invoke this method to specify that this property (which must match a JavaBean property they expose) is mandatory, and must be supplied as a config parameter. This method would normally be called from a subclass constructor.

Parameters:

property - name of the required property

createEnvironment

protected ConfigurableEnvironment createEnvironment()

Create and return a new StandardPortletEnvironment. Subclasses may override in order to configure the environment or specialize the environment type returned.

initBeanWrapper

protected void initBeanWrapper(BeanWrapper bw)
                        throws BeansException

Initialize the BeanWrapper for this GenericPortletBean, possibly with custom editors.

Parameters:

bw - the BeanWrapper to initialize

Throws:

BeansException - if thrown by BeanWrapper methods

See Also:

PropertyEditorRegistry.registerCustomEditor(java.lang.Class<?>, java.beans.PropertyEditor)

initPortletBean

protected void initPortletBean()
                        throws javax.portlet.PortletException

Subclasses may override this to perform custom initialization. All bean properties of this portlet will have been set before this method is invoked. This default implementation does nothing.

Throws:

javax.portlet.PortletException - if subclass initialization fails