Package org.acplt.oncrpc
Class OncRpcClientStub
- java.lang.Object
-
- org.acplt.oncrpc.OncRpcClientStub
-
public abstract class OncRpcClientStub extends java.lang.Object
The abstractOncRpcClientStub
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
- Version:
- $Revision: 1.1.1.1 $ $Date: 2003/08/13 12:03:44 $ $State: Exp $ $Locker: $
- Author:
- Harald Albrecht
- See Also:
OncRpcTcpClient
,OncRpcUdpClient
-
-
Field Summary
Fields Modifier and Type Field Description protected OncRpcClient
client
The real ONC/RPC client which is responsible for handling a particular IP protocol.
-
Constructor Summary
Constructors Constructor Description OncRpcClientStub(java.net.InetAddress host, int program, int version, int port, int protocol)
Construct a newOncRpcClientStub
for communication with a remote ONC/RPC server.OncRpcClientStub(OncRpcClient client)
Construct a newOncRpcClientStub
which uses the given client proxy object for communication with a remote ONC/RPC server.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description 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.
-
-
-
Field Detail
-
client
protected OncRpcClient client
The real ONC/RPC client which is responsible for handling a particular IP protocol.
-
-
Constructor Detail
-
OncRpcClientStub
public OncRpcClientStub(java.net.InetAddress host, int program, int version, int port, int protocol) throws OncRpcException, java.io.IOException
Construct a newOncRpcClientStub
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 newOncRpcClientStub
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.- Throws:
OncRpcException
java.io.IOException
-
-
Method Detail
-
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.
-
-