Service Description Interface (required): Defines an operation for
acquiring the Producer's metadata.
Markup Interface (required): Defines operations for getting markup
from a portlet as well as processing user interactions with that markup.
Contains also the operation for Consumer assistance in pre-initializing
HTTP-cookies.
Registration Interface (optional): Defines operations for establishing,
updating and destroying a regisration. Each registration reflects a particular
relationship between a Consumer and a Producer.
Portlet Management Interface (optional): Defines operations for getting
portlet metadata, cloning portlets for further customization and interacting
with the property interface.
All methods are implemented by calling the corresponding sub-components
(Producer- and Provider-side components). Additionally each method implementation
performs high level checks (e.g. a parameter validation to ensure that all required
input parameters are available) and maps internal exceptions to exceptions defined
vy WSRP.
Involves additional servlet related objects -> no mapping of the interfaces
possible
register(RegistrationData request) Calls the ConsumerRegistry to register a certain consumer.
Returns a registration context including a new registration handle.
Throws InvalidHandleFault if there is no portlet to be cloned in the PortletPool
that corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException -
Deregisters a certain consumer identified by a registration handle
within the ConsumerRegistry. Throws an InvalidRegistration if
there is no consumer registered with the given registration handle.
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException - throws: InvalidRegistration - The given registrationhandle is invalid / not yet registered
Removes all portlets corresponding to the provided portlet handles from the
PortletPool. All portlet handles refering to portlets that cannot be destroyed
(e.g. portlet handles from Producer Offered Portlets) will be returned within the
DestroyPortletResponse as DestroyFailed-objects.
Throws InvalidRegistration if there is no registration with the given
registration handle available within the ConsumerRegistry (case registration
is required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException -
Requests the markup for rendering the current state of a portlet by calling
the PortletInvoker.
Throws InvalidHandleFault if there is no portlet in the PortletPool that
corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Fetches the portlet description from the DescriptionHandler to figure out
whether the portlet supports template processing or not. If so, it checks whether
templates are provided or not.
Parameters: request - a generated wrapper containing all input arguments for this method MarkupResponse exception: java.rmi.RemoteException -
Fetches a PortletDescription from the DescriptionHandler.
Throws InvalidHandleFault if there is no portlet in the PortletPool that
corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException -
Fetches the current property values of a portlet and returns them.
Throws InvalidHandleFault if there is no portlet in the PortletPool
that corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method PropertyList containing all properties of the adressed portlet exception: java.rmi.RemoteException -
Returns a model description containing the property descriptions of all properties
of a portlet.
Throws InvalidHandleFault if there is no portlet in the PortletPool
that corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException -
Allows a Producer to provide information about its capabilities. Producers
may choose to restrict the information returned in ServiceDescription based on
the supplied RegistrationContext.
Checks registration (if required) by querying the ConsumerRegistry and calls
the DescriptionHandler to get the service description.
Parameters: request - a generated wrapper containing all input arguments for this method ServiceDescription exception: java.rmi.RemoteException -
Throws InvalidRegistration if there is no registration with the given
registration handle available within the ConsumerRegistry (if registration is
required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException - null throws: MissingParameterFault - throws: InvalidRegistration -
Modifies the registration of a certain consumer. Throws an InvalidRegistration
if there is no consumer registered with the given registration handle.
Parameters: request - a generated wrapper containing all input arguments for this method A RegistrationState-object if the Producer chooses to have the Consumer providepersistent storage for those registration states, else null. exception: java.rmi.RemoteException -
Invokes a blocking interaction with the adressed portlet by calling
the PortletInvoker
Throws InvalidHandleFault if there is no portlet in the PortletPool that
corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method BlockingInteractionResponse exception: java.rmi.RemoteException -
Calls the ConsumerRegistry to register a certain consumer.
Returns a registration context including a new registration handle.
Parameters: request - a generated wrapper containing all input arguments for this method RegistrationContext exception: java.rmi.RemoteException -
Destroys the sessions adressed by the delivered sessionIDs.
Returns null by default.
Throws InvalidRegistration if there is no registration with the given
registration handle available within the ConsumerRegistry (case registration is
required).
Parameters: request - a generated wrapper containing all input arguments for this method null
Throws InvalidHandleFault if there is no portlet in the PortletPool
that corresponds to the provided portlet handle. Throws InvalidRegistration
if there is no registration with the given registration handle available within
the ConsumerRegistry (case registration is required).
Parameters: request - a generated wrapper containing all input arguments for this method exception: java.rmi.RemoteException -