org.apache.ws.scout.registry

Class RegistryV3Impl

java.lang.Object

org.apache.ws.scout.registry.RegistryV3Impl

All Implemented Interfaces:

IRegistryBase, IRegistryV3

public class RegistryV3Impl
extends Object
implements IRegistryV3

RegistryImpl is the implementation of IRegistry.

The execute() function signature has been changed slightly from the jUDDI version, since the URL can no longer be decided dynamically (in an easy enough manner) as we don't use jUDDI data types anymore.

The function code is borrowed from jUDDI, with appropriate modifications so that xmlbeans data types are used intead of jUDDI data types.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_ADMIN_ENDPOINT
static String	DEFAULT_INQUIRY_ENDPOINT
static String	DEFAULT_PROTOCOL_HANDLER
static String	DEFAULT_PUBLISH_ENDPOINT
static String	DEFAULT_SECURITY_ENDPOINT
static String	DEFAULT_SECURITY_PROVIDER
static String	DEFAULT_TRANSPORT_CLASS
static String	DEFAULT_UDDI_NAMESPACE
static String	DEFAULT_UDDI_VERSION

Constructor Summary

Constructors

Constructor and Description
RegistryV3Impl(Properties props, String nodeName, String managerName) Creates a new instance of RegistryImpl.

Method Summary

Methods

Modifier and Type	Method and Description
DispositionReport	deleteBinding(String authInfo, String[] bindingKeyArray) "Used to remove an existing bindingTemplate from the bindingTemplates collection that is part of a specified businessService structure."
DispositionReport	deleteBusiness(String authInfo, String[] businessKeyArray) "Used to delete registered businessEntity information from the registry."
DispositionReport	deletePublisherAssertions(String authInfo, PublisherAssertion[] assertionArray)
DispositionReport	deleteService(String authInfo, String[] serviceKeyArray) "Used to delete an existing businessService from the businessServices collection that is part of a specified businessEntity."
DispositionReport	deleteTModel(String authInfo, String[] tModelKeyArray) "Used to delete registered information about a tModel.
JAXBElement<?>	execute(JAXBElement<?> uddiRequest, URI endPointURI)
String	execute(String uddiRequest, String urltype)
BindingDetail	findBinding(String serviceKey, CategoryBag categoryBag, TModelBag tModelBag, FindQualifiers findQualifiers, int maxRows) "Used to locate specific bindings within a registered businessService.
BusinessList	findBusiness(Name[] nameArray, DiscoveryURLs discoveryURLs, IdentifierBag identifierBag, CategoryBag categoryBag, TModelBag tModelBag, FindQualifiers findQualifiers, int maxRows) Used to locate information about one or more businesses.
ServiceList	findService(String businessKey, Name[] nameArray, CategoryBag categoryBag, TModelBag tModelBag, FindQualifiers findQualifiers, int maxRows) "Used to locate specific services within a registered businessEntity.
TModelList	findTModel(String name, CategoryBag categoryBag, IdentifierBag identifierBag, FindQualifiers findQualifiers, int maxRows) "Used to locate one or more tModel information structures.
URI	getAdminURI()
AssertionStatusReport	getAssertionStatusReport(String authInfo, String completionStatus)
AuthToken	getAuthToken(String userID, String cred) "Used to request an authentication token from an Operator Site.
BusinessDetail	getBusinessDetail(String businessKey) Used to get the full businessEntity information for a particular business entity.
BusinessDetail	getBusinessDetail(String[] businessKeyArray) "Used to get the full businessEntity information for one or more businesses.
static Class	getClassForName(String name)
URI	getInquiryURI()
String	getProtocolHandler()
PublisherAssertions	getPublisherAssertions(String authInfo)
URI	getPublishURI()
RegisteredInfo	getRegisteredInfo(String authInfo)
String	getSecurityProvider()
URI	getSecurityURI()
ServiceDetail	getServiceDetail(String serviceKey) "Used to get full details for a particular registered businessService.
ServiceDetail	getServiceDetail(String[] serviceKeyArray) "Used to get full details for a given set of registered businessService data.
TModelDetail	getTModelDetail(String tModelKey) "Used to get full details for a particular registered TModel.
TModelDetail	getTModelDetail(String[] tModelKeyArray) "Used to get full details for a given set of registered tModel data.
Transport	getTransport()
Transport	getTransport(String className) Returns an implementation of Transport based on the className passed in.
String	getUddiNamespace()
String	getUddiVersion()
BindingDetail	saveBinding(String authInfo, BindingTemplate[] bindingArray) "Used to register new bindingTemplate information or update existing bindingTemplate information.
BusinessDetail	saveBusiness(String authInfo, BusinessEntity[] businessArray) "Used to register new businessEntity information or update existing businessEntity information.
ServiceDetail	saveService(String authInfo, BusinessService[] serviceArray) "Used to register or update complete information about a businessService exposed by a specified businessEntity."
TModelDetail	saveTModel(String authInfo, TModel[] tModelArray) "Used to register or update complete information about a tModel."
void	setAdminURI(URI url)
void	setInquiryURI(URI inquiryURI)
void	setProtocolHandler(String protocolHandler)
PublisherAssertions	setPublisherAssertions(String authInfo, PublisherAssertion[] assertionArray)
void	setPublishURI(URI publishURI)
void	setSecurityProvider(String securityProvider)
void	setSecurityURI(URI securityURI)
void	setTransport(Transport transport)
void	setUddiNamespace(String uddiNS)
void	setUddiVersion(String uddiVersion)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_INQUIRY_ENDPOINT

public static final String DEFAULT_INQUIRY_ENDPOINT

See Also:

Constant Field Values

DEFAULT_PUBLISH_ENDPOINT

public static final String DEFAULT_PUBLISH_ENDPOINT

See Also:

Constant Field Values

DEFAULT_SECURITY_ENDPOINT

public static final String DEFAULT_SECURITY_ENDPOINT

See Also:

Constant Field Values

DEFAULT_ADMIN_ENDPOINT

public static final String DEFAULT_ADMIN_ENDPOINT

See Also:

Constant Field Values

DEFAULT_TRANSPORT_CLASS

public static final String DEFAULT_TRANSPORT_CLASS

See Also:

Constant Field Values

DEFAULT_SECURITY_PROVIDER

public static final String DEFAULT_SECURITY_PROVIDER

See Also:

Constant Field Values

DEFAULT_PROTOCOL_HANDLER

public static final String DEFAULT_PROTOCOL_HANDLER

See Also:

Constant Field Values

DEFAULT_UDDI_VERSION

public static final String DEFAULT_UDDI_VERSION

See Also:

Constant Field Values

DEFAULT_UDDI_NAMESPACE

public static final String DEFAULT_UDDI_NAMESPACE

See Also:

Constant Field Values

Constructor Detail

RegistryV3Impl

public RegistryV3Impl(Properties props,
              String nodeName,
              String managerName)
               throws InvalidRequestException

Creates a new instance of RegistryImpl.

Throws:

InvalidRequestException

Method Detail

execute

public String execute(String uddiRequest,
             String urltype)
               throws TransportException

Specified by:

execute in interface IRegistryBase

Parameters:

uddiRequest -

Returns:

String

Throws:

RegistryV3Exception

TransportException

execute

public JAXBElement<?> execute(JAXBElement<?> uddiRequest,
                     URI endPointURI)
                       throws RegistryV3Exception

Throws:

RegistryV3Exception

getAdminURI

public URI getAdminURI()

Returns:

Returns the adminURL.

setAdminURI

public void setAdminURI(URI url)

Parameters:

url - The adminURL to set.

getInquiryURI

public URI getInquiryURI()

Specified by:

getInquiryURI in interface IRegistryBase

Specified by:

getInquiryURI in interface IRegistryV3

Returns:

Returns the inquiryURL.

setInquiryURI

public void setInquiryURI(URI inquiryURI)

Specified by:

setInquiryURI in interface IRegistryBase

Specified by:

setInquiryURI in interface IRegistryV3

Parameters:

inquiryURI - The inquiryURI to set.

getProtocolHandler

public String getProtocolHandler()

Returns:

Returns the protocolHandler.

setProtocolHandler

public void setProtocolHandler(String protocolHandler)

Parameters:

protocolHandler - The protocolHandler to set.

getPublishURI

public URI getPublishURI()

Specified by:

getPublishURI in interface IRegistryBase

Specified by:

getPublishURI in interface IRegistryV3

Returns:

Returns the publishURL.

getSecurityURI

public URI getSecurityURI()

Specified by:

getSecurityURI in interface IRegistryBase

Returns:

Returns the publishURL.

setPublishURI

public void setPublishURI(URI publishURI)

Specified by:

setPublishURI in interface IRegistryBase

Specified by:

setPublishURI in interface IRegistryV3

Parameters:

publishURI - The publishURI to set.

setSecurityURI

public void setSecurityURI(URI securityURI)

Specified by:

setSecurityURI in interface IRegistryBase

Parameters:

publishURI - The publishURI to set.

getSecurityProvider

public String getSecurityProvider()

Returns:

Returns the securityProvider.

setSecurityProvider

public void setSecurityProvider(String securityProvider)

Parameters:

securityProvider - The securityProvider to set.

getTransport

public Transport getTransport()

Specified by:

getTransport in interface IRegistryBase

Specified by:

getTransport in interface IRegistryV3

Returns:

Returns the transport.

setTransport

public void setTransport(Transport transport)

Specified by:

setTransport in interface IRegistryBase

Specified by:

setTransport in interface IRegistryV3

Parameters:

transport - The transport to set.

getUddiNamespace

public String getUddiNamespace()

Returns:

Returns the uddiNS.

setUddiNamespace

public void setUddiNamespace(String uddiNS)

Parameters:

uddiNS - The uddiNS to set.

getUddiVersion

public String getUddiVersion()

Returns:

Returns the uddiVersion.

setUddiVersion

public void setUddiVersion(String uddiVersion)

Parameters:

uddiVersion - The uddiVersion to set.

deleteBinding

public DispositionReport deleteBinding(String authInfo,
                              String[] bindingKeyArray)
                                throws RegistryV3Exception

"Used to remove an existing bindingTemplate from the bindingTemplates collection that is part of a specified businessService structure."

Specified by:

deleteBinding in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

deleteBusiness

public DispositionReport deleteBusiness(String authInfo,
                               String[] businessKeyArray)
                                 throws RegistryV3Exception

"Used to delete registered businessEntity information from the registry."

Specified by:

deleteBusiness in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

deletePublisherAssertions

public DispositionReport deletePublisherAssertions(String authInfo,
                                          PublisherAssertion[] assertionArray)
                                            throws RegistryV3Exception

Specified by:

deletePublisherAssertions in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

deleteService

public DispositionReport deleteService(String authInfo,
                              String[] serviceKeyArray)
                                throws RegistryV3Exception

"Used to delete an existing businessService from the businessServices collection that is part of a specified businessEntity."

Specified by:

deleteService in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

deleteTModel

public DispositionReport deleteTModel(String authInfo,
                             String[] tModelKeyArray)
                               throws RegistryV3Exception

"Used to delete registered information about a tModel. If there are any references to a tModel when this call is made, the tModel will be marked deleted instead of being physically removed."

Specified by:

deleteTModel in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

findBusiness

public BusinessList findBusiness(Name[] nameArray,
                        DiscoveryURLs discoveryURLs,
                        IdentifierBag identifierBag,
                        CategoryBag categoryBag,
                        TModelBag tModelBag,
                        FindQualifiers findQualifiers,
                        int maxRows)
                          throws RegistryV3Exception

Used to locate information about one or more businesses. Returns a businessList message that matches the conditions specified.

Specified by:

findBusiness in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

findBinding

public BindingDetail findBinding(String serviceKey,
                        CategoryBag categoryBag,
                        TModelBag tModelBag,
                        FindQualifiers findQualifiers,
                        int maxRows)
                          throws RegistryV3Exception

"Used to locate specific bindings within a registered businessService. Returns a bindingDetail message."

Specified by:

findBinding in interface IRegistryV3

Throws:

RegistryV3Exception

findService

public ServiceList findService(String businessKey,
                      Name[] nameArray,
                      CategoryBag categoryBag,
                      TModelBag tModelBag,
                      FindQualifiers findQualifiers,
                      int maxRows)
                        throws RegistryV3Exception

"Used to locate specific services within a registered businessEntity. Return a serviceList message." From the XML spec (API, p18) it appears that the name, categoryBag, and tModelBag arguments are mutually exclusive.

Specified by:

findService in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

findTModel

public TModelList findTModel(String name,
                    CategoryBag categoryBag,
                    IdentifierBag identifierBag,
                    FindQualifiers findQualifiers,
                    int maxRows)
                      throws RegistryV3Exception

"Used to locate one or more tModel information structures. Returns a tModelList structure."

Specified by:

findTModel in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getAssertionStatusReport

public AssertionStatusReport getAssertionStatusReport(String authInfo,
                                             String completionStatus)
                                               throws RegistryV3Exception

Specified by:

getAssertionStatusReport in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getAuthToken

public AuthToken getAuthToken(String userID,
                     String cred)
                       throws RegistryV3Exception

"Used to request an authentication token from an Operator Site. Authentication tokens are required to use all other APIs defined in the publishers API. This server serves as the program's equivalent of a login request."

Specified by:

getAuthToken in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getBusinessDetail

public BusinessDetail getBusinessDetail(String businessKey)
                                 throws RegistryV3Exception

Used to get the full businessEntity information for a particular business entity. Returns a businessDetail message.

Specified by:

getBusinessDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getBusinessDetail

public BusinessDetail getBusinessDetail(String[] businessKeyArray)
                                 throws RegistryV3Exception

"Used to get the full businessEntity information for one or more businesses. Returns a businessDetail message."

Specified by:

getBusinessDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getPublisherAssertions

public PublisherAssertions getPublisherAssertions(String authInfo)
                                           throws RegistryV3Exception

Specified by:

getPublisherAssertions in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getRegisteredInfo

public RegisteredInfo getRegisteredInfo(String authInfo)
                                 throws RegistryV3Exception

Specified by:

getRegisteredInfo in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getServiceDetail

public ServiceDetail getServiceDetail(String serviceKey)
                               throws RegistryV3Exception

"Used to get full details for a particular registered businessService. Returns a serviceDetail message."

Specified by:

getServiceDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getServiceDetail

public ServiceDetail getServiceDetail(String[] serviceKeyArray)
                               throws RegistryV3Exception

"Used to get full details for a given set of registered businessService data. Returns a serviceDetail message."

Specified by:

getServiceDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getTModelDetail

public TModelDetail getTModelDetail(String tModelKey)
                             throws RegistryV3Exception

"Used to get full details for a particular registered TModel. Returns a tModelDetail message."

Specified by:

getTModelDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getTModelDetail

public TModelDetail getTModelDetail(String[] tModelKeyArray)
                             throws RegistryV3Exception

"Used to get full details for a given set of registered tModel data. Returns a tModelDetail message."

Specified by:

getTModelDetail in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

setPublisherAssertions

public PublisherAssertions setPublisherAssertions(String authInfo,
                                         PublisherAssertion[] assertionArray)
                                           throws RegistryV3Exception

Specified by:

setPublisherAssertions in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

saveBinding

public BindingDetail saveBinding(String authInfo,
                        BindingTemplate[] bindingArray)
                          throws RegistryV3Exception

"Used to register new bindingTemplate information or update existing bindingTemplate information. Use this to control information about technical capabilities exposed by a registered business."

Specified by:

saveBinding in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

saveBusiness

public BusinessDetail saveBusiness(String authInfo,
                          BusinessEntity[] businessArray)
                            throws RegistryV3Exception

"Used to register new businessEntity information or update existing businessEntity information. Use this to control the overall information about the entire business. Of the save_x APIs this one has the broadest effect."

Specified by:

saveBusiness in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

saveService

public ServiceDetail saveService(String authInfo,
                        BusinessService[] serviceArray)
                          throws RegistryV3Exception

"Used to register or update complete information about a businessService exposed by a specified businessEntity."

Specified by:

saveService in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

saveTModel

public TModelDetail saveTModel(String authInfo,
                      TModel[] tModelArray)
                        throws RegistryV3Exception

"Used to register or update complete information about a tModel."

Specified by:

saveTModel in interface IRegistryV3

Throws:

RegistryV3Exception;

RegistryV3Exception

getTransport

public Transport getTransport(String className)

Returns an implementation of Transport based on the className passed in. If a null value is passed then the default Transport implementation "org.apache.ws.scout.transport.AxisTransport" is created and returned.

Returns:

Transport

getClassForName

public static Class getClassForName(String name)
                             throws ClassNotFoundException,
                                    NoClassDefFoundError

Parameters:

name -

Returns:

The class object for the name given

Throws:

ClassNotFoundException

NoClassDefFoundError