void |
close()
getImportReference
ImportReference getImportReference()
- Return the Import Reference for the imported service.
- Returns:
- The Import Reference for this registration, or
null
if this Import Registration is closed.
- Throws:
java.lang.IllegalStateException - When this registration was not properly
initialized. See getException().
update
boolean update(EndpointDescription endpoint)
- Update the local service represented by this
ImportRegistration.
After this method returns the EndpointDescription returned via
getImportReference() must have been updated.
- Parameters:
endpoint - The updated endpoint
- Returns:
true if the endpoint was successfully updated,
false otherwise. If the update fails then the
failure can be retrieved from getException().
- Throws:
java.lang.IllegalStateException - When this registration is closed, or if it
was not properly initialized. See getException().
java.lang.IllegalArgumentException - When the supplied
EndpointDescription does not represent the same endpoint
as this ImportRegistration.- Since:
- 1.1
close
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.
getException
java.lang.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.
- Returns:
- The exception that occurred during the initialization of this
registration or
null if no exception occurred.
|