Slot

   

---

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 ServiceBinding s 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( )

---