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, toString, wait, wait, wait

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 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.

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.