- All Known Implementing Classes:
@ProviderType public interface ImportRegistrationAn Import Registration associates an active proxy service to a remote endpoint. The Import Registration can be used to delete the proxy associated with an endpoint. It is created with the
RemoteServiceAdmin.importService(EndpointDescription)method. When this Import Registration has been closed, all methods must return
All Methods Instance Methods Abstract Methods Modifier and Type Method Description
close()Close this Import Registration.
getException()Return the exception for any error during the import process.
getImportReference()Return the Import Reference for the imported service.
update(EndpointDescription endpoint)Update the local service represented by this
ImportReference getImportReference()Return the Import Reference for the imported service.
- The Import Reference for this registration, or
nullif this Import Registration is closed.
IllegalStateException- When this registration was not properly initialized. See
boolean update(EndpointDescription endpoint)Update the local service represented by this
ImportRegistration. After this method returns the
getImportReference()must have been updated.
endpoint- The updated endpoint
trueif the endpoint was successfully updated,
falseotherwise. If the update fails then the failure can be retrieved from
IllegalStateException- When this registration is closed, or if it was not properly initialized. See
IllegalArgumentException- When the supplied
EndpointDescriptiondoes not represent the same endpoint as this
void close()Close this Import Registration. This must close the connection to the endpoint and unregister the proxy. After this method returns, all other methods must return
null. This method has no effect when this registration has already been closed or is being closed.
Throwable getException()Return the exception for any error during the import process. If the Remote Service Admin for some reasons is unable to properly initialize this registration, then it must return an exception from this method. If no error occurred, this method must return
null. The error must be set before this Import Registration is returned. Asynchronously occurring errors must be reported to the log.
- The exception that occurred during the initialization of this
nullif no exception occurred.