org.hippoecm.hst.core.linking

Interface HstLink

All Known Implementing Classes:

MockHstLink

public interface HstLink

HstLink is the object representing a link. The getPath() return you the value of the link, and getPathElements() returns you the path splitted on "/"'s. The String[] version is more practical because the HttpServletResponse.encodeURL(String) also encodes slashes. Furthermore, the HstSite that the link is meant for is accessible through this HstLink, because it is needed if the link is out of the scope of the current HstSite. The HstSite can access the VirtualHost through which in turn even links to different hosts can be created.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	getContainerResource()
Mount	getMount()
String	getPath() Note: This is *not* a url!
String[]	getPathElements()
String	getSubPath() Returns the subPath of this HstLink object.
boolean	isNotFound() When for example for some bean the (real) link cannot be created through the HstLinkCreator, a HstLink can be returned with a path that is for example from some configured property like '/pagenotfound'.
void	setContainerResource(boolean containerResource)
void	setNotFound(boolean notFound)
void	setPath(String path) (re)-sets the path of the HstLink
void	setSubPath(String subPath) sets the subPath of this HstLink.
String	toUrlForm(HstRequestContext requestContext, boolean fullyQualified)

Method Detail

getPath

String getPath()

Note: This is *not* a url!

Returns:

the path of this HstLink. Note: This is *not* a url! The value never starts or ends with a slash /

setPath

void setPath(String path)

(re)-sets the path of the HstLink

Parameters:

path -

getSubPath

String getSubPath()

Returns the subPath of this HstLink object. This part will be appended to the getPath() and delimited by ./. It will be before the queryString. Note that an empty String subPath will result in a URL having a ./ appended: An empty subPath is thus something different then a null subPath.

Returns:

the subPath of this HstLink object.

setSubPath

void setSubPath(String subPath)

sets the subPath of this HstLink. Note that setting the subPath to an empty String will result in a URL having a ./ appended: An empty subPath is thus something different then a null subPath.

Parameters:

subPath -

getContainerResource

boolean getContainerResource()

Returns:

true when the HstLink represents a container resource, like a repository binary

setContainerResource

void setContainerResource(boolean containerResource)

Parameters:

containerResource - sets the containerResource

toUrlForm

String toUrlForm(HstRequestContext requestContext,
               boolean fullyQualified)

Parameters:

requestContext -

fullyQualified - if true, the returned link is a fully qualified URL, in other words including http/https etc

Returns:

the url form of this HstLink, which is a url

getPathElements

String[] getPathElements()

Returns:

the path elements of this HstLink, which is the getPath() splitted on slashes

getMount

Mount getMount()

Returns:

the Mount that can represent this link. This might be an Mount which is a different one then the Mount the link was created in. This could result in a cross-domain (different hostname) link being created, depending on the backing Mount.getVirtualHost(). If no Mount is set, null can be returned

isNotFound

boolean isNotFound()

When for example for some bean the (real) link cannot be created through the HstLinkCreator, a HstLink can be returned with a path that is for example from some configured property like '/pagenotfound'. If this method returns true it indicates that the link is some hardcoded path for beans that cannot be linked to

Returns:

true when this HstLink indicates to be a link that is actually a notFound link

setNotFound

void setNotFound(boolean notFound)

Parameters:

notFound - true whether this HstLink is actually a notFound link