Java Web Services in a Nutshell

Name

ExternalLink

Synopsis

public interface ExternalLink extends RegistryObject, URIValidator {
// Public Instance Methods
    public abstract String getExternalURI(  )
       throws javax.xml.registry.JAXRException;             //L0
    public abstract Collection getLinkedObjects(  )
       throws javax.xml.registry.JAXRException;             //L0
    public abstract void setExternalURI(String uri)
       throws javax.xml.registry.JAXRException;
               //L0
}

A RegistryObject may have any number of ExternalLinks that act as references to information related to the object that resides outside of the registry. The location of the referenced information is given by a URI that can be set using the setExternalURI( ) method and retrieved by calling getExternalURI( ). The getLinkedObjects( ) method returns a Collection containing all of the RegistryObjects to which the ExternalLink has been applied using the RegistryObject addExternalLink( ) or addExternalLinks( ) methods. Compare this level 0 facility to ExtrinsicObject, which stores a copy of the information in a repository linked to the registry (but is available only with a level 1 JAXR provider).

Passed To

RegistryObject.{addExternalLink( ), removeExternalLink( )}

Returned By

javax.xml.registry.LifeCycleManager.createExternalLink( )