Liferay 6.1.2-ce-ga3

com.liferay.portal.kernel.portlet
Interface LiferayPortletURL

All Superinterfaces:
BaseURL, PortletURL, ResourceURL, Serializable
All Known Implementing Classes:
LiferayStrutsPortletURLImpl, PortletURLImpl, PortletURLImplWrapper, StrutsActionPortletURL

public interface LiferayPortletURL
extends PortletURL, ResourceURL, Serializable

Represents a URL pointing to a portlet.

See Also:
PortletURLImpl

Field Summary
 
Fields inherited from interface javax.portlet.ResourceURL
FULL, PAGE, PORTLET, SHARED
 
Method Summary
 void addParameterIncludedInPath(String name)
          Adds a parameter that is included in the friendly URL path and does not need to appear in the query string.
 String getLifecycle()
          Returns the portlet lifecycle of this URL's target portlet.
 String getParameter(String name)
          Returns the first value of the URL parameter.
 Set<String> getParametersIncludedInPath()
          Returns the parameters that are included in the friendly URL path and do not need to appear in the query string.
 String getPortletId()
          Returns the ID of this URL's target portlet.
 Set<String> getRemovedParameterNames()
           
 Map<String,String> getReservedParameterMap()
          Returns the map of reserved parameters for this URL.
 String getResourceID()
          Returns the ID of this URL's target resource.
 boolean isAnchor()
          Returns true if this URL is an anchor pointing to the specified portlet on the page.
 boolean isCopyCurrentRenderParameters()
          Returns true if the render parameters in the current request should be copied to this URL.
 boolean isEncrypt()
          Returns true if this URL should be encrypted.
 boolean isEscapeXml()
          Returns true if this URL should be XML escaped.
 boolean isParameterIncludedInPath(String name)
          Returns true if the parameter is included in the friendly URL path.
 boolean isSecure()
          Returns true if this URL is secure (https).
 void setAnchor(boolean anchor)
          Sets whether this URL is an anchor pointing to the specified portlet on the page.
 void setControlPanelCategory(String controlPanelCategory)
           
 void setCopyCurrentRenderParameters(boolean copyCurrentRenderParameters)
          Sets whether the render parameters in the current request should be copied to this URL.
 void setDoAsGroupId(long doAsGroupId)
           
 void setDoAsUserId(long doAsUserId)
          Sets the ID of the user to impersonate.
 void setDoAsUserLanguageId(String doAsUserLanguageId)
          Sets the language ID of the user to impersonate.
 void setEncrypt(boolean encrypt)
          Sets whether this URL should be encrypted.
 void setEscapeXml(boolean escapeXml)
          Sets whether this URL should be XML escaped.
 void setLifecycle(String lifecycle)
          Sets the portlet lifecycle of this URL's target portlet.
 void setParameter(String name, String[] values, boolean append)
          Sets the URL parameter the values.
 void setParameter(String name, String value, boolean append)
          Sets the URL parameter to the value.
 void setPlid(long plid)
          Sets the portlet layout ID.
 void setPortletId(String portletId)
          Sets the ID of the target portlet.
 void setRefererPlid(long refererPlid)
          Sets the referer layout ID.
 void setRemovedParameterNames(Set<String> removedParamNames)
           
 
Methods inherited from interface javax.portlet.PortletURL
getPortletMode, getWindowState, removePublicRenderParameter, setPortletMode, setWindowState
 
Methods inherited from interface javax.portlet.ResourceURL
getCacheability, setCacheability, setResourceID
 
Methods inherited from interface javax.portlet.BaseURL
addProperty, getParameterMap, setParameter, setParameter, setParameters, setProperty, setSecure, toString, write, write
 

Method Detail

addParameterIncludedInPath

void addParameterIncludedInPath(String name)
Adds a parameter that is included in the friendly URL path and does not need to appear in the query string.

Parameters:
name - the name of the parameter

getLifecycle

String getLifecycle()
Returns the portlet lifecycle of this URL's target portlet.

Returns:
the portlet lifecycle of this URL's target portlet
See Also:
setLifecycle(String)

getParameter

String getParameter(String name)
Returns the first value of the URL parameter.

Parameters:
name - the name of the URL parameter
Returns:
the first value of the URL parameter

getParametersIncludedInPath

Set<String> getParametersIncludedInPath()
Returns the parameters that are included in the friendly URL path and do not need to appear in the query string.

Returns:
the names of the parameters that are included in the friendly URL path and do not need to appear in the query string

getPortletId

String getPortletId()
Returns the ID of this URL's target portlet.

Returns:
the ID of this URL's target portlet

getRemovedParameterNames

Set<String> getRemovedParameterNames()

getReservedParameterMap

Map<String,String> getReservedParameterMap()
Returns the map of reserved parameters for this URL.

This method is only used internally. Reserved parameters contain special, Liferay specific information, such as p_p_id and p_p_lifecycle.

Returns:
the reserved parameter names and values in a read-only map

getResourceID

String getResourceID()
Returns the ID of this URL's target resource.

Returns:
the ID of this URL's target resource

isAnchor

boolean isAnchor()
Returns true if this URL is an anchor pointing to the specified portlet on the page.

Returns:
whether this URL is an anchor pointing to the specified portlet on the page
See Also:
setAnchor(boolean)

isCopyCurrentRenderParameters

boolean isCopyCurrentRenderParameters()
Returns true if the render parameters in the current request should be copied to this URL.

Returns:
whether the render parameters in the current request should be copied to this URL
See Also:
setCopyCurrentRenderParameters(boolean)

isEncrypt

boolean isEncrypt()
Returns true if this URL should be encrypted.

Returns:
true if this URL should be encrypted; false otherwise
See Also:
setEncrypt(boolean)

isEscapeXml

boolean isEscapeXml()
Returns true if this URL should be XML escaped.

Returns:
true if this URL should be XML escaped; false otherwise
See Also:
setEscapeXml(boolean)

isParameterIncludedInPath

boolean isParameterIncludedInPath(String name)
Returns true if the parameter is included in the friendly URL path.

Parameters:
name - the name of the parameter to check for inclusion in the path
Returns:
whether the parameter is included in the friendly URL path
See Also:
addParameterIncludedInPath(String)

isSecure

boolean isSecure()
Returns true if this URL is secure (https).

Returns:
true if this URL is secure; false otherwise

setAnchor

void setAnchor(boolean anchor)
Sets whether this URL is an anchor pointing to the specified portlet on the page.

An anchor URL will cause the user's browser to automatically jump down to the specified portlet after the page loads, avoiding the need to scroll.

Parameters:
anchor - whether this URL is an anchor pointing to the specified portlet on the page

setControlPanelCategory

void setControlPanelCategory(String controlPanelCategory)

setCopyCurrentRenderParameters

void setCopyCurrentRenderParameters(boolean copyCurrentRenderParameters)
Sets whether the render parameters in the current request should be copied to this URL.

New parameters set on this URL will appear before the copied render parameters.

Parameters:
copyCurrentRenderParameters - whether the render parameters in the current request should be copied to this URL

setDoAsGroupId

void setDoAsGroupId(long doAsGroupId)

setDoAsUserId

void setDoAsUserId(long doAsUserId)
Sets the ID of the user to impersonate.

When a page is accessed while impersonating a user, it will appear exactly as it would to that user.

Parameters:
doAsUserId - the ID of the user to impersonate in the portlet this URL points to

setDoAsUserLanguageId

void setDoAsUserLanguageId(String doAsUserLanguageId)
Sets the language ID of the user to impersonate. This will only have an effect when a user is being impersonated via setDoAsUserId(long).

The language set here will override the impersonated user's default language.

Parameters:
doAsUserLanguageId - the language ID of the user to impersonate

setEncrypt

void setEncrypt(boolean encrypt)
Sets whether this URL should be encrypted.

In an encrypted URL, the value of every parameter will be encrypted using the company's key. This allows sensitive information to be placed in the URL without being vulnerable to snooping.

Note that this is not the same as making a URL secure.


setEscapeXml

void setEscapeXml(boolean escapeXml)
Sets whether this URL should be XML escaped.

If a URL is XML escaped, it will automatically have special characters escaped when it is converted to a string or written to a Writer.

Parameters:
escapeXml - whether this URL should be XML escaped

setLifecycle

void setLifecycle(String lifecycle)
Sets the portlet lifecycle of this URL's target portlet.

Valid lifecycles are:

Parameters:
lifecycle - the portlet lifecycle

setParameter

void setParameter(String name,
                  String value,
                  boolean append)
Sets the URL parameter to the value.

Parameters:
name - the name of the URL parameter
value - the value of the URL parameter
append - whether the new value should be appended to any existing values for the parameter. If append is false any existing values will be overwritten with the new value.

setParameter

void setParameter(String name,
                  String[] values,
                  boolean append)
Sets the URL parameter the values.

Parameters:
name - the name of the URL parameter
values - the values of the URL parameter
append - whether the new values should be appended to any existing values for the parameter. If append is false any existing values will be overwritten with the new values.

setPlid

void setPlid(long plid)
Sets the portlet layout ID.

Parameters:
plid - the portlet layout ID

setPortletId

void setPortletId(String portletId)
Sets the ID of the target portlet.


setRefererPlid

void setRefererPlid(long refererPlid)
Sets the referer layout ID.

Parameters:
refererPlid - the referer layout ID

setRemovedParameterNames

void setRemovedParameterNames(Set<String> removedParamNames)

Liferay 6.1.2-ce-ga3