Previous section   Next section
ServiceBinding javax.xml.registry.infomodel

JAXR 1.0; JWSDP 1.0, J2EE 1.4
public interface ServiceBinding extends RegistryObject, URIValidator {
// Public Instance Methods
    public abstract void addSpecificationLink(SpecificationLink specificationLink) 
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void addSpecificationLinks(Collection specificationLinks)
       throws javax.xml.registry.JAXRException;             //L0
    public abstract String getAccessURI(  )
       throws javax.xml.registry.JAXRException;             //L0
    public abstract javax.xml.registry.infomodel.Service getService(  )
       throws javax.xml.registry.JAXRException;             //L0
    public abstract Collection getSpecificationLinks(  )
       throws javax.xml.registry.JAXRException;
               //L0
    public abstract ServiceBinding getTargetBinding(  )
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void removeSpecificationLink(SpecificationLink specificationLink) 
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void removeSpecificationLinks(Collection specificationLinks) 
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void setAccessURI(String uri)
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void setTargetBinding(ServiceBinding binding)
       throws javax.xml.registry.JAXRException;             //L0
}

A Service has one or more associated ServiceBindings that provide the information necessary for a developer to discover how to use and access the service. A Service that can be accessed using more than one protocol or that is available at several different locations requires a separate ServiceBinding for each. The Service object to which a binding corresponds can be obtained from its getService( ) method, while the URI at which the service instance resides can be found by calling the getAccessURI( ) method.

Information that describes the service can be linked to the binding using a SpecificationLink, which may point to a WSDL document stored in an associated repository or at a location given by its URL. Refer to the description of the SpecificationLink interface, later in this chapter, for a description of the ways in which it can be used to refer to service documentation.

In some cases, a ServiceBinding may not refer directly to an instance of the service but to another ServiceBinding. When this is true, the target binding can be retrieved using the getTargetBinding( ) method.

Passed To

javax.xml.registry.infomodel.Service.{addServiceBinding( ), removeServiceBinding( )}, ServiceBinding.setTargetBinding( )

Returned By

javax.xml.registry.LifeCycleManager.createServiceBinding( ), ServiceBinding.getTargetBinding( ), SpecificationLink.getServiceBinding( )


  Previous section   Next section