com.ibm.portal.resolver
Interface PocURL

All Superinterfaces:

Addressable, Constants, Disposable, DisposableURL, URL

public interface PocURL
extends DisposableURL, Addressable, Constants

The PocURL is a URL that addresses a piece of content (POC). Depending on the way the actual URL instance has been achieved, such a URL might represent the view of a resource or its binary representation. The binding to the actual resource might happen early (i.e. at URL generation time) or late (only when the URL is invoked).

Via the writeCopy and writeDispose methods the URL can be written to a stream. writeDispose should be used wherever possible as this methods has a smaller performance impact than writeCopy. The PocURL should be disposed if it is no longer used by calling the dispose() method. The writeDispose however writes the URL to a stream and disposes it in one single step, so if writeDispose is called, the object must not be disposed additionally.

Since:

6.0.1

See Also:

com.ibm.portal.state.EngineURL}

Field Summary

Fields inherited from interface com.ibm.portal.resolver.Constants

ALL_BINDING_SET, ALL_BINDINGS, DEFAULT_BINDING_SET, DEFAULT_BINDINGS, DEFAULT_POST_BINDING_SET, DEFAULT_POST_BINDINGS, HTTP_BINDING, HTTP_DELETE_BINDING, HTTP_GET_BINDING, HTTP_POST_BINDING, KEY_DIGEST, KEY_MIME_TYPE, KEY_MODE, KEY_POCURI_PARAM, KEY_URI, KEY_VERB, PORTLET_CONTENT_LOCATION_TYPE, RESOLVER_EXTENSION_POINT, SCHEME_PORTLET, VALUE_DOWNLOAD, VALUE_LOOKUP, VALUE_VIEW, WP_SELECTION_BINDING

Method Summary

java.lang.String	getMode() Returns the mode that is currently associated with the resouce
java.util.Map<java.lang.String,java.lang.String[]>	getParameters() Returns a modifiable version of the parameters used to address the object, never null, but potentially the empty map.
void	setAddressable(Addressable aAddr) Associates the URI and parameters of the addressable object
void	setMode(java.lang.String aMode) Associates a mode with the URI.
void	setProtected(java.lang.Boolean bFlag) Indicates if the URL points to the private area or to the public area .
void	setSecure(java.lang.Boolean bFlag) Indicates the security setting for this URL.
void	setURI(java.net.URI aURI) Associates a POC URI with the URL object.

Methods inherited from interface com.ibm.portal.state.DisposableURL

toString, java.io.Writer)">writeCopy, writeDispose

Methods inherited from interface com.ibm.portal.URL

java.io.Writer)">write

Methods inherited from interface com.ibm.portal.Disposable

dispose

Methods inherited from interface com.ibm.portal.resolver.data.Addressable

getURI

Method Detail

setAddressable

void setAddressable(Addressable aAddr)
                    throws StateException,
                           java.net.URISyntaxException

Associates the URI and parameters of the addressable object

Parameters:

aAddr -

Throws:

StateException

java.net.URISyntaxException

setURI

void setURI(java.net.URI aURI)
            throws StateException

Associates a POC URI with the URL object.

Parameters:

aURI - URI that identifies the target resource, not null

Throws:

StateException - - if the association could not be performed

setMode

void setMode(java.lang.String aMode)

Associates a mode with the URI. The mode identifies the way the client intends to interact with the resource, e.g. VIEW or DOWNLOAD.

Parameters:

aMode - mode identifier, may be null to represent the default mode.

getMode

java.lang.String getMode()

Returns the mode that is currently associated with the resouce

Returns:

mode identifier, might return null

setProtected

void setProtected(java.lang.Boolean bFlag)

Indicates if the URL points to the private area or to the public area .

Parameters:

bFlag - true, if the URL should point to the private area

setSecure

void setSecure(java.lang.Boolean bFlag)

Indicates the security setting for this URL. Secure set to true indicates that the portlet requests a secure connection between the client and the portlet window for this URL. Secure set to false indicates that the portlet does not need a secure connection for this URL. If the security is not set for a URL, it will stay the same as the current request.

Parameters:

bFlag - true, if portlet requests to have a secure connection between its portlet window and the client; false, if the portlet does not require a secure connection.

getParameters

java.util.Map<java.lang.String,java.lang.String[]> getParameters()

Returns a modifiable version of the parameters used to address the object, never null, but potentially the empty map. The key is of type String, the values of type String[]. Clients may modify this map to associate parameters with the PocURL

Specified by:

getParameters in interface Addressable

Returns:

the modifiable parameter map