public interface Exporter
Details of the export and unexport behavior, including the communication protocols used for remote invocation and additional remote invocation semantics, are defined by the particular implementation of this interface.
|Modifier and Type||Method and Description|
Exports the specified remote object and returns a proxy that can be used to invoke remote methods on the exported remote object.
Unexports the remote object that was exported by this
Remote export(Remote impl) throws ExportException
The returned proxy implements an implementation-specific set of remote interfaces of the remote object and may also implement additional implementation-specific interfaces.
A remote interface is an interface that extends the interface
java.rmi.Remote and whose methods each declare at least
one exception whose type is
or one of its superclasses.
This method should not be called from within an object constructor, otherwise the object reference will escape during construction, leaving the remote object implementation in an undefined state.
impl- a remote object to export
ExportException- if a problem occurs exporting the object
SecurityException- if a
SecurityExceptionoccurs exporting the object
IllegalStateException- if an object has already been exported with this
boolean unexport(boolean force)
Exportersuch that it will no longer receive remote method invocations that were made possible as a result of exporting it with this
Exporter. The unexport operation may not occur if the
false. This method must only be invoked after the
exportmethod has been invoked on this
Exporterinstance to export a remote object successfully.
This method returns
true if upon return, the remote
object is no longer exported with this
false if the remote object remains exported with this
Exporter. This method will always return
true if it has returned
force parameter serves to indicate whether or not
the caller desires the unexport to occur even if there are known
remote calls pending or in progress to the remote object that were
made possible by this
true, then the remote object will be forcibly unexported even if there are remote calls pending or in progress, and this method will return
false, then this acts as a hint to the implementation that the remote object should not be unexported if there are known remote calls pending or in progress, and this method will either unexport the remote object and return
trueor not unexport the remote object and return
false. If the implementation detects that there are indeed remote calls pending or in progress, then it should return
false; otherwise, it must return
true. If the implementation does not support being able to unexport conditionally based on knowledge of remote calls pending or in progress, then it must implement this method as if
If the remote object is unexported as a result of this method, then the implementation may (and should, if possible) prevent remote calls in progress from being able to communicate their results successfully.
true, the remote object will be unexported even if there are remote calls pending or in progress; if
false, the remote object may only be unexported if there are no known remote calls pending or in progress
trueif the remote object is unexported when this method returns and
IllegalStateException- if an object has not been exported with this
Copyright 2007-2013, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.