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