net.razorvine.pyro

Class PyroProxy

java.lang.Object

net.razorvine.pyro.PyroProxy

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

NameServerProxy

public class PyroProxy
extends java.lang.Object
implements java.io.Serializable

Proxy for Pyro objects.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	hostname
java.lang.String	objectid
int	port

Constructor Summary

Constructors

Constructor and Description
PyroProxy() No-args constructor for (un)pickling support
PyroProxy(PyroURI uri) Create a proxy for the remote Pyro object denoted by the uri
PyroProxy(java.lang.String hostname, int port, java.lang.String objectid) Create a proxy for the remote Pyro object on the given host and port, with the given objectid/name.

Method Summary

Methods

Modifier and Type	Method and Description
void	__setstate__(java.lang.Object[] args) called by the Unpickler to restore state args: pyroUri, pyroOneway(hashset), pyroSerializer, pyroTimeout
void	call_oneway(java.lang.String method, java.lang.Object... arguments) Call a method on the remote Pyro object this proxy is for, using Oneway call semantics (return immediately).
java.lang.Object	call(java.lang.String method, java.lang.Object... arguments) Call a method on the remote Pyro object this proxy is for.
void	close() Close the network connection of this Proxy.
protected void	connect() (re)connect the proxy to the remote Pyro daemon.
void	finalize()
protected void	handshake() Perform the Pyro protocol connection handshake with the Pyro daemon.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

hostname

public java.lang.String hostname

port

public int port

objectid

public java.lang.String objectid

Constructor Detail

PyroProxy

public PyroProxy()

No-args constructor for (un)pickling support

PyroProxy

public PyroProxy(PyroURI uri)
          throws java.net.UnknownHostException,
                 java.io.IOException

Create a proxy for the remote Pyro object denoted by the uri

Throws:

java.net.UnknownHostException

java.io.IOException

PyroProxy

public PyroProxy(java.lang.String hostname,
         int port,
         java.lang.String objectid)
          throws java.net.UnknownHostException,
                 java.io.IOException

Create a proxy for the remote Pyro object on the given host and port, with the given objectid/name.

Throws:

java.net.UnknownHostException

java.io.IOException

Method Detail

connect

protected void connect()
                throws java.net.UnknownHostException,
                       java.io.IOException

(re)connect the proxy to the remote Pyro daemon.

Throws:

java.net.UnknownHostException

java.io.IOException

call

public java.lang.Object call(java.lang.String method,
                    java.lang.Object... arguments)
                      throws PickleException,
                             PyroException,
                             java.io.IOException

Call a method on the remote Pyro object this proxy is for.

Parameters:

method - the name of the method you want to call

arguments - zero or more arguments for the remote method

Returns:

the result Object from the remote method call (can be anything, you need to typecast/introspect yourself).

Throws:

PickleException

PyroException

java.io.IOException

call_oneway

public void call_oneway(java.lang.String method,
               java.lang.Object... arguments)
                 throws PickleException,
                        PyroException,
                        java.io.IOException

Call a method on the remote Pyro object this proxy is for, using Oneway call semantics (return immediately).

Parameters:

method - the name of the method you want to call

arguments - zero or more arguments for the remote method

Throws:

PickleException

PyroException

java.io.IOException

close

public void close()

Close the network connection of this Proxy. If you re-use the proxy, it will automatically reconnect.

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

handshake

protected void handshake()
                  throws java.io.IOException

Perform the Pyro protocol connection handshake with the Pyro daemon.

Throws:

java.io.IOException

__setstate__

public void __setstate__(java.lang.Object[] args)
                  throws java.io.IOException

called by the Unpickler to restore state args: pyroUri, pyroOneway(hashset), pyroSerializer, pyroTimeout

Throws:

java.io.IOException