com.bea.wsrp.services.registration
Interface ConsumerRegistrationServiceLocal

All Superinterfaces

javax.ejb.EJBLocalObject

public interface ConsumerRegistrationServiceLocal
extends javax.ejb.EJBLocalObject

This interface is intended to be implemented only by Oracle Weblogic Portal. Oracle Systems reserves the right to add abstract methods to this interface without notice. Implementations of this interface by other parties must not be expected to compile without change in future versions of Oracle Weblogic Portal.

Method Summary

void	associatePortletToConsumer(int registrationHandle, int portletInstanceId) Associates a portletInstance with the consumer that the former was created for.
void	deregister(int registrationHandle) Deregisters a consumer with this producer.
void	dissociatePortletFromConsumer(int registrationHandle, int portletInstanceId) Dissociates a portlet from a consumer it is associated with.
List<com.bea.wsrp.producer.types.wsrp_producer_config.RegistrationPropertyDescriptionType>	getRegistrationProperties(List uris) Retrieves all configured registration properties.
List<IPropertyDescription>	getRegistrationPropertyDescriptions(List<String> uris) Retrieves all configured registration properties.
List<RegistrationPropertyValue>	getRegistrationPropertyValues(int registrationHandle) Retrieves registration properties and their values for the given consumer.
boolean	isPortletAssociated(int registrationHandle, int portletInstanceId) Determines if a portlet is associated with a consumer.
boolean	isRegistered(int registrationHandle) Checks to see if a given registrationHandle is valid.
void	modifyRegistration(int registrationHandle, String webappName, String consumerName, String consumerAgent, Map properties, boolean isStrict) Modifies an existing registration for this producer.
int	register(String webappName, String consumerName, String consumerAgent, Map properties, boolean isStrict) Registers a consumer with this producer.

Methods inherited from interface javax.ejb.EJBLocalObject

getEJBLocalHome, getPrimaryKey, isIdentical, remove

Method Detail

register

int register(String webappName,
             String consumerName,
             String consumerAgent,
             Map properties,
             boolean isStrict)
             throws javax.ejb.EJBException

Registers a consumer with this producer.

Parameters

webappName - The name of the webapp performing the registration

consumerName - The consumer's name

consumerAgent - The consumer's agent

properties - The registration properties

isStrict - Flag to specify is registration should fail if any property value is unacceptable

Returns

The generated registration handle

Throws

javax.ejb.EJBException

modifyRegistration

void modifyRegistration(int registrationHandle,
                        String webappName,
                        String consumerName,
                        String consumerAgent,
                        Map properties,
                        boolean isStrict)
                        throws javax.ejb.EJBException

Modifies an existing registration for this producer.

Parameters

registrationHandle - The registration handle for the consumer to be deregistered

webappName - The name of the webapp performing the registration modification

consumerName - The consumer's name

consumerAgent - The consumer's agent

properties - The registration properties

isStrict - Flag to specify is modify registration should fail if any property value is unacceptable

Throws

javax.ejb.EJBException

deregister

void deregister(int registrationHandle)
                throws javax.ejb.EJBException

Deregisters a consumer with this producer.

Parameters

registrationHandle - The registration handle for the consumer to be deregistered

Throws

javax.ejb.EJBException

isRegistered

boolean isRegistered(int registrationHandle)
                     throws javax.ejb.EJBException

Checks to see if a given registrationHandle is valid.

Parameters

registrationHandle - The registration handle to check for validity

Returns

Whether or not the registrationHandle was found in the persistent store

Throws

javax.ejb.EJBException

associatePortletToConsumer

void associatePortletToConsumer(int registrationHandle,
                                int portletInstanceId)
                                throws javax.ejb.EJBException

Associates a portletInstance with the consumer that the former was created for.

Parameters

registrationHandle - consumer registration handle

portletInstanceId - instance id of the portlet

Throws

javax.ejb.EJBException

isPortletAssociated

boolean isPortletAssociated(int registrationHandle,
                            int portletInstanceId)
                            throws javax.ejb.EJBException

Determines if a portlet is associated with a consumer.

Parameters

registrationHandle - consumer registration handle

portletInstanceId - instance id of the portlet

Returns

true if the portlet is associated with the consumer

Throws

javax.ejb.EJBException

getRegistrationProperties

List<com.bea.wsrp.producer.types.wsrp_producer_config.RegistrationPropertyDescriptionType> getRegistrationProperties(List uris)
                                                                                                                     throws javax.ejb.EJBException

Retrieves all configured registration properties.

Returns

An array of registration properties, empty if none defined

Throws

javax.ejb.EJBException

See Also

getRegistrationPropertyDescriptions(List)

getRegistrationPropertyValues

List<RegistrationPropertyValue> getRegistrationPropertyValues(int registrationHandle)
                                                              throws javax.ejb.EJBException

Retrieves registration properties and their values for the given consumer.

Returns

the list of registration property values

Throws

javax.ejb.EJBException

dissociatePortletFromConsumer

void dissociatePortletFromConsumer(int registrationHandle,
                                   int portletInstanceId)
                                   throws Exception

Dissociates a portlet from a consumer it is associated with.

Parameters

registrationHandle - consumer registration handle

portletInstanceId - instance id of the portlet

Throws

Exception - Indicates a generic error has occurred executing the operation

getRegistrationPropertyDescriptions

List<IPropertyDescription> getRegistrationPropertyDescriptions(List<String> uris)
                                                               throws Exception

Retrieves all configured registration properties.

Parameters

uris - The list of property set files to look at or null for all files

Returns

An array of registration properties, empty if none defined

Throws

EJBException

Exception