Package lumis.portal.hyperlink

Class GenericHyperLinkResolver

java.lang.Object

lumis.portal.hyperlink.GenericHyperLinkResolver

All Implemented Interfaces:

IHyperLinkResolver

Direct Known Subclasses:

DouiHyperLinkResolver

@StableMinor(version="17.0",
             sinceVersion="4.0")
public class GenericHyperLinkResolver
extends java.lang.Object
implements IHyperLinkResolver

A generic implementation for resolving hyperlinks. This implementation contains some protected methods that may be overriden for easier customization.

Since:

4.0.10

Version:

$Revision: 26587 $ $Date: 2024-08-26 21:09:17 -0300 (Mon, 26 Aug 2024) $

Constructor Summary

Constructors

Constructor	Description
GenericHyperLinkResolver()

Method Summary

Modifier and Type	Method	Description
protected IServiceInterfaceUrl	createUrl(SessionConfig sessionConfig, HyperLinkConfig hyperLinkConfig, java.lang.String pageId, ITransaction transaction)	Creates an URL for the given hyperlink.
protected boolean	interfaceInstanceCanBeUsedAsLinkTarget(java.lang.String interfaceInstanceId)	Returns whether the interface instance with the given identifier can be used in hyperlinks or not.
protected void	keepPagePreviousState(IServiceInterfaceUrl url, HyperLinkConfig hyperLinkConfig)	Configures the URL object to keep the current page previous parameters.
protected java.lang.String	resolveDestinationInterfaceId(SessionConfig sessionConfig, HyperLinkConfig hyperLinkConfig, ITransaction transaction)	Resolves the interface that should be the destination for the given hyperlinkConfig
protected java.lang.String	resolveDestinationPageId(SessionConfig sessionConfig, HyperLinkConfig hyperLinkConfig, ITransaction transaction)	Tries to resolve the destination page for the specified hyperlink.
IServiceInterfaceUrl	resolveHyperLink(SessionConfig sessionConfig, HyperLinkConfig hyperLinkConfig, ITransaction transaction)	Resolves an hyperlink to the corresponding URL.
protected void	setUrlParameters(SessionConfig sessionConfig, IServiceInterfaceUrl url, java.util.Map<java.lang.String,java.lang.String[]> parameters, ITransaction transaction)	Replaces the parameters in the url with the parameters in the given map.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericHyperLinkResolver

public GenericHyperLinkResolver()

Method Detail

resolveHyperLink

public IServiceInterfaceUrl resolveHyperLink(SessionConfig sessionConfig,
                                             HyperLinkConfig hyperLinkConfig,
                                             ITransaction transaction)
                                      throws PortalException

Resolves an hyperlink to the corresponding URL.

If no destination service interface instance was specified in the hyperLinkConfig, then this method calls resolveDestinationPageId(SessionConfig, HyperLinkConfig, ITransaction) to resolve the destination page. If there is a destination service interface instance or a destination page could be resolved, then createUrl(SessionConfig, HyperLinkConfig, String, ITransaction) is called to create the resulting URL.

Otherwise, if the requested interface and service instance can be resolved to be displayed in an auto administration page, a URL to it is returned.

Otherwise null is returned.

Specified by:

resolveHyperLink in interface IHyperLinkResolver

Parameters:

sessionConfig - the user session information.

hyperLinkConfig - hyperlink information

transaction - the transaction for persistence access.

Returns:

the url, or null if the hyperlink could not be resolved.

Throws:

PortalException

createUrl

protected IServiceInterfaceUrl createUrl(SessionConfig sessionConfig,
                                         HyperLinkConfig hyperLinkConfig,
                                         java.lang.String pageId,
                                         ITransaction transaction)
                                  throws PortalException

Creates an URL for the given hyperlink.

This implementation call setUrlParameters(SessionConfig, IServiceInterfaceUrl, Map, ITransaction) to fill the created URL's parameters.

Parameters:

sessionConfig - the user session information.

hyperLinkConfig - the hyperlink value.

pageId - the destination page. If null the created URL will not have an explicit pageId specified.

transaction - the transaction for persistence access.

Returns:

the created URL, or null if the arguments could not be resolved into a URL.

Throws:

PortalException

Since:

4.0.10

keepPagePreviousState

protected void keepPagePreviousState(IServiceInterfaceUrl url,
                                     HyperLinkConfig hyperLinkConfig)

Configures the URL object to keep the current page previous parameters. The HyperLinkConfig(IServiceInterfaceRequest, lumis.portal.serviceinterface.IServiceInterfaceResponse) constructor must have been used or this method will have no effect.

Note that the parameters that belongs to the target of the URL will be replaced as defined by the URL. This method is intended to preserve the previous parameters of other targets in the current page.

Parameters:

url - the URL object.

hyperLinkConfig - the HyperLinkConfig being used to create the URL object.

Since:

5.6.0

See Also:

IServiceInterfaceUrl.setTargetScope(int, String), HyperLinkConfig.setTargetId(String), HyperLinkConfig.setTargetType(int)

setUrlParameters

protected void setUrlParameters(SessionConfig sessionConfig,
                                IServiceInterfaceUrl url,
                                java.util.Map<java.lang.String,java.lang.String[]> parameters,
                                ITransaction transaction)
                         throws PortalException

Replaces the parameters in the url with the parameters in the given map. To customize the parameters set in the url, this method may be overrided.

Parameters:

sessionConfig - the user session information.

url - the url to set parameters.

parameters - the parameters to set in the url.

transaction - the transaction for persistence access.

Throws:

PortalException

Since:

4.0.10

See Also:

PortalRequestParameters.isReservedParameter(String)

resolveDestinationPageId

protected java.lang.String resolveDestinationPageId(SessionConfig sessionConfig,
                                                    HyperLinkConfig hyperLinkConfig,
                                                    ITransaction transaction)
                                             throws PortalException

Tries to resolve the destination page for the specified hyperlink. Calls the resolveDestinationInterfaceId(SessionConfig, HyperLinkConfig, ITransaction) method for resolving the destination interface id if it is not specified in the hyperLinkConfig.

Parameters:

sessionConfig - the user session information.

hyperLinkConfig - the hyperlink.

transaction - the transaction for persistence access.

Returns:

the pageId, or null if the destination page could not be resolved.

Throws:

PortalException

Since:

4.0.10

resolveDestinationInterfaceId

protected java.lang.String resolveDestinationInterfaceId(SessionConfig sessionConfig,
                                                         HyperLinkConfig hyperLinkConfig,
                                                         ITransaction transaction)
                                                  throws PortalException

Resolves the interface that should be the destination for the given hyperlinkConfig

Parameters:

sessionConfig - the user session information.

hyperLinkConfig - the hyperLink information.

transaction - theh transaction for persistence access.

Returns:

the resolved destination interface id, or null if it could not be resolved.

Throws:

PortalException

Since:

4.0.10

interfaceInstanceCanBeUsedAsLinkTarget

protected boolean interfaceInstanceCanBeUsedAsLinkTarget(java.lang.String interfaceInstanceId)
                                                  throws PortalException

Returns whether the interface instance with the given identifier can be used in hyperlinks or not.

Parameters:

interfaceInstanceId - the interface instance identifier.

Returns:

whether the interface instance with the given identifier can be used in hyperlinks or not.

Throws:

PortalException

Since:

10.2.0