org.acplt.oncrpc
Class OncRpcClientStub
java.lang.Object
|
+--org.acplt.oncrpc.OncRpcClientStub
- public abstract class OncRpcClientStub
- extends java.lang.Object
The abstract OncRpcClientStub
class is the base class to
build ONC/RPC-program specific clients upon. This class is typically
only used by jrpcgen generated clients, which provide a particular
set of remote procedures as defined in a x-file.
When you do not need the client proxy object any longer, you should
return the resources it occupies to the system. Use the close()
method for this.
client.close();
client = null; // Hint to the garbage (wo)man
- See Also:
OncRpcTcpClient
,
OncRpcUdpClient
Field Summary |
protected OncRpcClient |
client
The real ONC/RPC client which is responsible for handling a particular
IP protocol. |
Constructor Summary |
OncRpcClientStub(java.net.InetAddress host,
int program,
int version,
int port,
int protocol)
Construct a new OncRpcClientStub for communication with
a remote ONC/RPC server. |
OncRpcClientStub(OncRpcClient client)
Construct a new OncRpcClientStub which uses the given
client proxy object for communication with a remote ONC/RPC server. |
Method Summary |
void |
close()
Close the connection to an ONC/RPC server and free all network-related
resources. |
OncRpcClient |
getClient()
Returns ONC/RPC client proxy object used for communication with a
remote ONC/RPC server. |
Methods inherited from class java.lang.Object |
,
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
registerNatives,
toString,
wait,
wait,
wait |
client
protected OncRpcClient client
- The real ONC/RPC client which is responsible for handling a particular
IP protocol.
OncRpcClientStub
public OncRpcClientStub(java.net.InetAddress host,
int program,
int version,
int port,
int protocol)
throws OncRpcException,
java.io.IOException
- Construct a new
OncRpcClientStub
for communication with
a remote ONC/RPC server.
- Parameters:
host
- Host address where the desired ONC/RPC server resides.program
- Program number of the desired ONC/RPC server.version
- Version number of the desired ONC/RPC server.protocol
- Protocol to be used for
ONC/RPC calls. This information is necessary, so port lookups through
the portmapper can be done.- Throws:
- OncRpcException - if an ONC/RPC error occurs.
- java.io.IOException - if an I/O error occurs.
OncRpcClientStub
public OncRpcClientStub(OncRpcClient client)
throws OncRpcException,
java.io.IOException
- Construct a new
OncRpcClientStub
which uses the given
client proxy object for communication with a remote ONC/RPC server.
- Parameters:
client
- ONC/RPC client proxy object implementing a particular
IP protocol.
close
public void close()
throws OncRpcException
- Close the connection to an ONC/RPC server and free all network-related
resources. Well -- at least hope, that the Java VM will sometimes free
some resources. Sigh.
- Throws:
- OncRpcException - if an ONC/RPC error occurs.
getClient
public OncRpcClient getClient()
- Returns ONC/RPC client proxy object used for communication with a
remote ONC/RPC server.
- Returns:
- ONC/RPC client proxy.