lumis.portal.url
Class GenericURLResolver

java.lang.Object
  lumis.portal.url.GenericURLResolver

All Implemented Interfaces:

IURLResolver

public class GenericURLResolver
extends Object
implements IURLResolver

Generic implementation of IURLResolver.

The web resource's property lumis.portal.url.IURLResolver.pattern is used to customize the friendly path generated by this resolver. The value of the property is a EL expression where the following variables may be used:

• wr: the WebResource instance.
• ancestralPath: the friendly path of the nearest ancestral web resource that has a friendly path value set. If no such web resource exists, it is resolved to null
• param: Maps a request parameter name to a single value.
• paramValues: Maps a request parameter name to an array of values.
• paramsPath: an automatic generated path fragment containing parameter names and values. The path starts with slash if it is non-empty, otherwise it does not contain an starting slash. GUID format parameter values and values for special parameters are ignored.
• currentPath: the current path value in the pipeline. Corresponds to the parameter given in resolveFriendlyPath(WebResource, String).

The resulting value is normalized by:

• converting all word characters to lower case ASCII characters (without accents)
• replacing other characters, except '/', by '-'

The default pattern (used if the pattern property is not set) is: ${ancestralPath}/${wr.title}${paramsPath}

Since:

5.0.0

Constructor Summary

GenericURLResolver()

Method Summary

protected boolean	isParameterVisible(String name, String[] values) Indicates if a parameter is to be shown in the string generated by paramsPath.
protected String	normalize(String value) Normalizes a string value to the form it should take in the friendly path.
String	resolveFriendlyPath(WebResource resource, String currentPath) Resolves the friendly path for a web resource.
protected Object	resolveVariable(String variableName, WebResource webResource, String currentPath) Resolves a variable in the friendly path expression.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericURLResolver

public GenericURLResolver()

Method Detail

resolveFriendlyPath

public String resolveFriendlyPath(WebResource resource,
                                  String currentPath)
                           throws PortalException

Description copied from interface: IURLResolver

Resolves the friendly path for a web resource.

Specified by:

resolveFriendlyPath in interface IURLResolver

Parameters:

resource - the web resource.

currentPath - the path value resolved by previous IURLResolver in the resolution pipeline, or an empty String if this is the first resolver in the pipeline.

Returns:

the resolved friendly path value. The final friendly path for the resolution pipeline must start with '/', or be an empty string for no friendly path.

Throws:

PortalException

Since:

5.0.0

resolveVariable

protected Object resolveVariable(String variableName,
                                 WebResource webResource,
                                 String currentPath)
                          throws ELException

Resolves a variable in the friendly path expression.

Parameters:

variableName - the name of the variable to be resolved.

webResource - the web resource.

currentPath - the current path in the friendly path resolution.

Returns:

the variable value.

Throws:

ELException - if the variable could not be resolved.

Since:

5.0.0

See Also:

resolveFriendlyPath(WebResource, String)

isParameterVisible

protected boolean isParameterVisible(String name,
                                     String[] values)

Indicates if a parameter is to be shown in the string generated by paramsPath.

Parameters:

name - the parameter name.

values - the parameter values.

Returns:

true if the parameter is to be shown, false otherwise.

Since:

5.0.0

normalize

protected String normalize(String value)

Normalizes a string value to the form it should take in the friendly path.

Parameters:

value - the string value to be normalized.

Returns:

the normalized value.

Since:

5.0.0