org.exoplatform.services.wsrp.consumer
Interface Producer

All Known Implementing Classes:

ProducerImpl

public interface Producer

A consumer representation of a WSRP-producer providing WSRP-portlets. Generally a producer can expose up to four WSRP-Interfaces. These interfaces are Markup-, Service Description-,Registration- and Portlet Management Interface. Whereas the Registration- and Portlet Management Interface are optional.

Author:

Stephan Laertz, Benjamin Mestrallet

Method Summary

org.exoplatform.services.wsrp.type.ReturnAny	deregister() End an existing consumer producer relationship and remove the registration context
String	getDescription() Get a description of the producer.
String[]	getDesiredLocales()
String	getID() Get the ID of the producer.
String	getMarkupInterfaceEndpoint() Get the URL of the producers markup interface.
String	getName() Get the name of the producer.
org.exoplatform.services.wsrp.type.PortletDescription	getPortletDescription(String portletHandle) Get the portlet description of the portlet with the given handle or null if the producer doesn't know an portlet with this handle.
org.exoplatform.services.wsrp.intf.WSRP_v1_PortletManagement_PortType	getPortletManagementInterface() Get the producers portlet management interface.
String	getPortletManagementInterfaceEndpoint() Get the URL of the producers portlet management interface.
org.exoplatform.services.wsrp.type.RegistrationContext	getRegistrationContext() Get the current registration context of the consumer registered at this producer or null if no registration is required or happend so far.
org.exoplatform.services.wsrp.type.RegistrationData	getRegistrationData() Get the registration data the consumer uses to register at this producer.
org.exoplatform.services.wsrp.intf.WSRP_v1_Registration_PortType	getRegistrationInterface() Get the producers registration interface.
String	getRegistrationInterfaceEndpoint() Get the URL of the producers registration interface.
org.exoplatform.services.wsrp.type.ServiceDescription	getServiceDescription() Same as getServiceDescription(false)
org.exoplatform.services.wsrp.type.ServiceDescription	getServiceDescription(boolean newRequest) Get the service description of the producer
org.exoplatform.services.wsrp.intf.WSRP_v1_ServiceDescription_PortType	getServiceDescriptionInterface() Get the producers service description interface.
String	getServiceDescriptionInterfaceEndpoint() Get the URL of the producers service description interface.
boolean	isPortletManagementInferfaceSupported() Check wether the optional portlet management interface is supported
boolean	isRegistrationInterfaceSupported() Check wether the optional registration interface is supported
boolean	isRegistrationRequired() Indicates wether or not the producer requires consumer registration.
org.exoplatform.services.wsrp.type.RegistrationState	modifyRegistration(org.exoplatform.services.wsrp.type.RegistrationData registrationData) Can be used to modify the relationship between consumer and producer.
org.exoplatform.services.wsrp.type.RegistrationContext	register(org.exoplatform.services.wsrp.type.RegistrationData registrationData) Method establishes a relationship between consumer and producer.
void	setDescription(String description) Set a description of the producer.
void	setDesiredLocales(String[] desiredLocales)
void	setID(String id) Set the ID of the producer to he given value.
void	setMarkupInterfaceEndpoint(String url) Set the URL of the producers markup interface.
void	setName(String name) Set the name of the producer.
void	setPortletManagementInterfaceEndpoint(String url) Set the URL of the producers portlet management interface.
void	setRegistrationData(org.exoplatform.services.wsrp.type.RegistrationData regData) Set the registration the consumer uses the register at this producer.
void	setRegistrationInterfaceEndpoint(String url) Set the URL of the producers registration interface.
void	setServiceDescriptionInterfaceEndpoint(String url) Set the URL of the producers service description interface.

Method Detail

getDesiredLocales

String[] getDesiredLocales()

setDesiredLocales

void setDesiredLocales(String[] desiredLocales)

getName

String getName()

Get the name of the producer.

Returns:

The name of the producer

setName

void setName(String name)

Set the name of the producer.

Parameters:

name - The name of the producer

getID

String getID()

Get the ID of the producer.

Returns:

The ID of the producer

setID

void setID(String id)

Set the ID of the producer to he given value.

Parameters:

id - ID of the producer.

getDescription

String getDescription()

Get a description of the producer.

Returns:

A description of the producer

setDescription

void setDescription(String description)

Set a description of the producer.

Parameters:

description - Some descriptive information about the producer

getServiceDescriptionInterfaceEndpoint

String getServiceDescriptionInterfaceEndpoint()

Get the URL of the producers service description interface.

Returns:

URL of the service description interface.

setServiceDescriptionInterfaceEndpoint

void setServiceDescriptionInterfaceEndpoint(String url)

Set the URL of the producers service description interface.

Parameters:

url - of the service description interface.

getServiceDescriptionInterface

org.exoplatform.services.wsrp.intf.WSRP_v1_ServiceDescription_PortType getServiceDescriptionInterface()

Get the producers service description interface.

Returns:

service description interface.

getMarkupInterfaceEndpoint

String getMarkupInterfaceEndpoint()

Get the URL of the producers markup interface.

Returns:

URL of the markup interface.

setMarkupInterfaceEndpoint

void setMarkupInterfaceEndpoint(String url)

Set the URL of the producers markup interface.

Parameters:

url - of the markup interface.

getPortletManagementInterfaceEndpoint

String getPortletManagementInterfaceEndpoint()

Get the URL of the producers portlet management interface.

Returns:

URL of the portlet management interface.

setPortletManagementInterfaceEndpoint

void setPortletManagementInterfaceEndpoint(String url)

Set the URL of the producers portlet management interface.

Parameters:

url - of the portlet management interface.

getPortletManagementInterface

org.exoplatform.services.wsrp.intf.WSRP_v1_PortletManagement_PortType getPortletManagementInterface()

Get the producers portlet management interface.

Returns:

portlet management interface.

getRegistrationInterfaceEndpoint

String getRegistrationInterfaceEndpoint()

Get the URL of the producers registration interface.

Returns:

URL of the registration interface.

setRegistrationInterfaceEndpoint

void setRegistrationInterfaceEndpoint(String url)

Set the URL of the producers registration interface.

getRegistrationInterface

org.exoplatform.services.wsrp.intf.WSRP_v1_Registration_PortType getRegistrationInterface()

Get the producers registration interface.

Returns:

registration interface.

isRegistrationRequired

boolean isRegistrationRequired()

Indicates wether or not the producer requires consumer registration.

Returns:

True if consumer registration is required.

getRegistrationData

org.exoplatform.services.wsrp.type.RegistrationData getRegistrationData()

Get the registration data the consumer uses to register at this producer.

Returns:

The consumer registration data

setRegistrationData

void setRegistrationData(org.exoplatform.services.wsrp.type.RegistrationData regData)

Set the registration the consumer uses the register at this producer.

Parameters:

regData - The registration data which is used to register at this producer

getServiceDescription

org.exoplatform.services.wsrp.type.ServiceDescription getServiceDescription(boolean newRequest)
                                                                            throws WSRPException

Get the service description of the producer

Parameters:

newRequest - If set to true a new request is send to the producer otherwise a cached service description is used if available

Returns:

Service description of the producer

Throws:

WSRPException

getServiceDescription

org.exoplatform.services.wsrp.type.ServiceDescription getServiceDescription()
                                                                            throws WSRPException

Same as getServiceDescription(false)

Throws:

WSRPException

getPortletDescription

org.exoplatform.services.wsrp.type.PortletDescription getPortletDescription(String portletHandle)
                                                                            throws WSRPException

Get the portlet description of the portlet with the given handle or null if the producer doesn't know an portlet with this handle.

Parameters:

portletHandle - The portlet handle of the portlet

Returns:

The portlet description of the portlet with the given handle

Throws:

WSRPException

getRegistrationContext

org.exoplatform.services.wsrp.type.RegistrationContext getRegistrationContext()
                                                                              throws WSRPException

Get the current registration context of the consumer registered at this producer or null if no registration is required or happend so far.

Returns:

The current registration context of the consumer at this producer or null.

Throws:

WSRPException

register

org.exoplatform.services.wsrp.type.RegistrationContext register(org.exoplatform.services.wsrp.type.RegistrationData registrationData)
                                                                throws WSRPException

Method establishes a relationship between consumer and producer.

Parameters:

registrationData - Data which is used to register the consumer

Returns:

The registration context received by the producer

Throws:

WSRPException

modifyRegistration

org.exoplatform.services.wsrp.type.RegistrationState modifyRegistration(org.exoplatform.services.wsrp.type.RegistrationData registrationData)
                                                                        throws WSRPException

Can be used to modify the relationship between consumer and producer.

Parameters:

registrationData - The new registration data

Returns:

New registration context

Throws:

WSRPException

deregister

org.exoplatform.services.wsrp.type.ReturnAny deregister()
                                                        throws WSRPException

End an existing consumer producer relationship and remove the registration context

Returns:

Can be anything

Throws:

WSRPException

isRegistrationInterfaceSupported

boolean isRegistrationInterfaceSupported()

Check wether the optional registration interface is supported

Returns:

true if a registration interface endpoint URL is set

isPortletManagementInferfaceSupported

boolean isPortletManagementInferfaceSupported()

Check wether the optional portlet management interface is supported

Returns:

true if a portlet management interface endpoint URL is set