org.apache.jetspeed.util.template
Class JetspeedTool

java.lang.Object
  org.apache.jetspeed.util.template.JetspeedTool

All Implemented Interfaces:

org.apache.turbine.services.pull.ApplicationTool

public class JetspeedTool

extends java.lang.Object

implements org.apache.turbine.services.pull.ApplicationTool

Utility class for accessing Jetspeed in a "pull" mode Since the tool stores a RunData object, it may not be shared between threads and/or requests

Version:

$Id: JetspeedTool.java,v 1.44 2005/05/19 15:59:40 morciuch Exp $

Author:

Raphaël Luta, David Sean Taylor, Mark Orciuch, Scott T. Weaver

Field Summary

protected JetspeedRunData

rundata RunData object for this request

Constructor Summary

JetspeedTool()
Empty constructor used by introspection

JetspeedTool(org.apache.turbine.util.RunData data)
The Tool constructor

Method Summary

static Portlet	getCustomizer(Portlet p) This method retrieves the appropriate customizer portlet for the current portlet
Entry	getEntryFromRequest() Retreives the Entry object for current portlet based on the "js_peid" parameter
org.apache.ecs.ConcreteElement	getPane(java.lang.String name) Returns the portlet content customized for the current user.
static java.lang.String	getParameter(org.apache.turbine.util.RunData data, java.lang.String parmStyle, java.lang.String parmName, java.lang.String parmValue, java.lang.String parmOptions) Returns a parameter rendered in specific parameter style
org.apache.ecs.ConcreteElement	getPortalElement(java.lang.String id) Return the content of a portal element given the id of the element.
org.apache.ecs.ConcreteElement	getPortlet(java.lang.String name) Deprecated. Use getPortletById()
org.apache.ecs.ConcreteElement	getPortletById(java.lang.String peid) Return the content of a portlet using the portlet's id (PEID).
org.apache.ecs.ConcreteElement	getPortletById(java.lang.String peid, boolean returnNull) Return the content of a portlet using the portlet's id (PEID).
org.apache.ecs.ConcreteElement	getPortletFromRegistry(org.apache.turbine.util.RunData data) Return the content of a portlet using the portlet's name.
org.apache.ecs.ConcreteElement	getPortletFromRegistry(java.lang.String portletName, java.lang.String controlName) Deprecated. Do not use this method because it's not secure. It will be removed after Beta 5.
static Portlet	getPortletInfoPortlet(org.apache.turbine.util.RunData data) This method retrieves the appropriate information portlet for the current portlet
static java.lang.String	getPortletParameter(org.apache.turbine.util.RunData data, Portlet portlet, java.lang.String parmName) Returns a parameter in its defined parameter style
static java.lang.String	getPortletParameter(org.apache.turbine.util.RunData data, Portlet portlet, java.lang.String parmName, java.lang.String parmValue) Returns a parameter in its defined parameter style
static java.lang.String	getPortletParameter(org.apache.turbine.util.RunData data, Portlet portlet, java.lang.String parmName, java.lang.String parmValue, java.lang.String parmOptions) Returns a parameter in its defined parameter style
SecurityReference	getSecurityReference(Entry entry) Retreives the correct SecurityReference for the portlet based on the current profile and the request.
int	getSecuritySource(Entry entry)
void	init(java.lang.Object data) This will initialise a JetspeedTool object that was constructed with the default constructor (ApplicationTool method).
void	refresh() Refresh method - does nothing

Methods inherited from class java.lang.Object

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

Field Detail

rundata

protected JetspeedRunData rundata

RunData object for this request

Constructor Detail

JetspeedTool

public JetspeedTool()

Empty constructor used by introspection

JetspeedTool

public JetspeedTool(org.apache.turbine.util.RunData data)

The Tool constructor

Parameters:

data - the RunData object for the current request

Method Detail

init

public void init(java.lang.Object data)

This will initialise a JetspeedTool object that was constructed with the default constructor (ApplicationTool method).

Specified by:

init in interface org.apache.turbine.services.pull.ApplicationTool

Parameters:

data - assumed to be a RunData object

refresh

public void refresh()

Refresh method - does nothing

Specified by:

refresh in interface org.apache.turbine.services.pull.ApplicationTool

getPane

public org.apache.ecs.ConcreteElement getPane(java.lang.String name)

Returns the portlet content customized for the current user. Currently, the layout engine does not handle panes, so the panes are mapped to real PSML files. If the pane name is null or "default", the profiler will automatically chose the PSML content, else the tool will try to load the PSML file with the specified name

Parameters:

name - the name of the pane to render

Returns:

the rendered content of the pane

getPortlet

public org.apache.ecs.ConcreteElement getPortlet(java.lang.String name)

Deprecated. Use getPortletById()

Return the content of a named portlet. This portlet is sought in the current PSML resource. If a control is attached to the portlet description, returns the defined portlet and control, otherwise use the default control. Note: This will return the FIRST portlet with a name = name. Use getPortletById().

Parameters:

name - the name of the portlet to render

Returns:

the rendered content of the portlet

getCustomizer

public static Portlet getCustomizer(Portlet p)

This method retrieves the appropriate customizer portlet for the current portlet

Parameters:

p - the portlet to customize

Returns:

the portlet object of the appropriate customizer

getPortletInfoPortlet

public static Portlet getPortletInfoPortlet(org.apache.turbine.util.RunData data)

This method retrieves the appropriate information portlet for the current portlet

Parameters:

data - the RunData for this request

Returns:

the portlet object of the appropriate customizer

getPortalElement

public org.apache.ecs.ConcreteElement getPortalElement(java.lang.String id)

Return the content of a portal element given the id of the element.

Parameters:

id - The portlet id

Returns:

the rendered content of the portlet

getPortletById

public org.apache.ecs.ConcreteElement getPortletById(java.lang.String peid)

Return the content of a portlet using the portlet's id (PEID). This portlet is sought in the current PSML resource. If a control is attached to the portlet description, returns the defined portlet and control, otherwise use the default control.

Parameters:

peid - the peid of the portlet to render

Returns:

the rendered content of the portlet

getPortletById

public org.apache.ecs.ConcreteElement getPortletById(java.lang.String peid,
                                                     boolean returnNull)

Return the content of a portlet using the portlet's id (PEID). This portlet is sought in the current PSML resource. If a control is attached to the portlet description, returns the defined portlet and control, otherwise use the default control.

Parameters:

peid - the peid of the portlet to render

returnNull - allows the method to return null or not

Returns:

the rendered content of the portlet

getPortletFromRegistry

public org.apache.ecs.ConcreteElement getPortletFromRegistry(org.apache.turbine.util.RunData data)

Return the content of a portlet using the portlet's name. This portlet is sought in the registry. This is useful when you want to get portlet's content without actually having the portlet in user's profile (for example, to preview a portlet before adding it to the profile).

If a control name is specified to the portlet description, returns the defined portlet and control, otherwise use the default control.

Issues to resolve:

• is new portlet instance created everytime someone previews the same portlet?
• should use the same skin as the current pane
• if TitlePortletControl is used, the action icons (max, min, etc) are not functional. Also, customize icon should not be present.
• interactive portlets (such as DatabaseBrowser) lose functionality (such as sorting in DatabaseBrowser).

Returns:

the rendered content of the portlet

getPortletFromRegistry

public org.apache.ecs.ConcreteElement getPortletFromRegistry(java.lang.String portletName,
                                                             java.lang.String controlName)

Deprecated. Do not use this method because it's not secure. It will be removed after Beta 5.

Return the content of a portlet using the portlet's name. This portlet is sought in the registry. This is useful when you want to get portlet's content without actually having the portlet in user's profile (for example, to preview a portlet before adding it to the profile).

If a control name is specified to the portlet description, returns the defined portlet and control, otherwise use the default control.

Issues to resolve:

• is new portlet instance created everytime someone previews the same portlet?
• should use the same skin as the current pane
• if TitlePortletControl is used, the action icons (max, min, etc) are not functional. Also, customize icon should not be present.
• interactive portlets (such as DatabaseBrowser) lose functionality (such as sorting in DatabaseBrowser).

Parameters:

portletName - Name of the portlet as defined in registry

controlName - Optional control name to use in displaying the portlet

Returns:

the rendered content of the portlet

getPortletParameter

public static java.lang.String getPortletParameter(org.apache.turbine.util.RunData data,
                                                   Portlet portlet,
                                                   java.lang.String parmName)

Returns a parameter in its defined parameter style

Parameters:

data - for this request

portlet - portlet instance

parmName - parameter name

Returns:

current parameter value using specified presentation style

getPortletParameter

public static java.lang.String getPortletParameter(org.apache.turbine.util.RunData data,
                                                   Portlet portlet,
                                                   java.lang.String parmName,
                                                   java.lang.String parmValue)

Returns a parameter in its defined parameter style

Parameters:

data - for this request

portlet - portlet instance

parmName - parameter name

parmValue - current parameter value

Returns:

current parameter value using specified presentation style

getPortletParameter

public static java.lang.String getPortletParameter(org.apache.turbine.util.RunData data,
                                                   Portlet portlet,
                                                   java.lang.String parmName,
                                                   java.lang.String parmValue,
                                                   java.lang.String parmOptions)

Returns a parameter in its defined parameter style

Parameters:

data - for this request

portlet - portlet instance

parmName - parameter name

parmValue - current parameter value

Returns:

current parameter value using specified presentation style

getParameter

public static java.lang.String getParameter(org.apache.turbine.util.RunData data,
                                            java.lang.String parmStyle,
                                            java.lang.String parmName,
                                            java.lang.String parmValue,
                                            java.lang.String parmOptions)

Returns a parameter rendered in specific parameter style

Parameters:

data - for this request

parmStyle - parameter style

parmName - parameter name

parmValue - current parameter value

Returns:

current parameter value using specified presentation style

getSecurityReference

public SecurityReference getSecurityReference(Entry entry)

Retreives the correct SecurityReference for the portlet based on the current profile and the request.

getSecuritySource

public int getSecuritySource(Entry entry)

getEntryFromRequest

public Entry getEntryFromRequest()
                          throws java.lang.Exception

Retreives the Entry object for current portlet based on the "js_peid" parameter

Throws:

java.lang.Exception