Voyager ORB

com.objectspace.voyager.transport
Interface ITransport


public abstract interface ITransport

The ITransport interface can be implemented to allow a Voyager host to recognize alternative transport (networking) protocols, such as UDP or even IPX.
Note that any augmentation to the behavior of the tcp protocol over and obove that supplied by the TcpTransport implementation, should be implemented by overridding that class.


Method Summary
 ITransportConnection acquireConnection(java.lang.String localXURL, java.lang.String xurl)
          Returns a new or existing ITransportConnection bound to the localXURL value and connected to the given xurl value.
 ITransportServer acquireServer(java.lang.String xurl)
          Returns a new or existing ITransportServer implementation instance bound to the given local address and port (or other network address identifier used by this transport), specified by the xurl value.
 ITransportConnection getConnection(java.lang.String localXURL, java.lang.String xurl)
          Returns an existing ITransportConnection bound to the localXURL value and connected to the given xurl value.
 java.lang.String getProtocol()
          Returns a String representation of the protocol this transport provides, such as "tcp".
 ITransportServer getServer(java.lang.String xurl)
          Returns an existing ITransportServer implementation instance bound to the given local address and port (or other network address identifier used by this transport), specified by the xurl value.
 boolean isLocal(java.lang.String xurl)
          Returns true if the xurl value references the local vm/host.
 ITransportConnection newConnection(java.lang.String xurl)
          Returns a new ITransportConnection bound to the localXURL value and connected to the given xurl value.
 

Method Detail

getProtocol

public java.lang.String getProtocol()
Returns a String representation of the protocol this transport provides, such as "tcp".

acquireServer

public ITransportServer acquireServer(java.lang.String xurl)
                               throws java.io.IOException
Returns a new or existing ITransportServer implementation instance bound to the given local address and port (or other network address identifier used by this transport), specified by the xurl value. For example, "somehost.com:8000" if using tcp.
Throws:
java.io.IOException - Thrown if server cannot be created on given url.

getServer

public ITransportServer getServer(java.lang.String xurl)
Returns an existing ITransportServer implementation instance bound to the given local address and port (or other network address identifier used by this transport), specified by the xurl value. For example, "somehost.com:8000" if using tcp.

acquireConnection

public ITransportConnection acquireConnection(java.lang.String localXURL,
                                              java.lang.String xurl)
                                       throws java.io.IOException
Returns a new or existing ITransportConnection bound to the localXURL value and connected to the given xurl value.
Throws:
java.io.IOException - Thrown if connection cannot be created on given url.

getConnection

public ITransportConnection getConnection(java.lang.String localXURL,
                                          java.lang.String xurl)
Returns an existing ITransportConnection bound to the localXURL value and connected to the given xurl value.

newConnection

public ITransportConnection newConnection(java.lang.String xurl)
                                   throws java.io.IOException
Returns a new ITransportConnection bound to the localXURL value and connected to the given xurl value.
Throws:
java.io.IOException - Thrown if connection cannot be created on given url.

isLocal

public boolean isLocal(java.lang.String xurl)
Returns true if the xurl value references the local vm/host.

ObjectSpace Inc.

(c) Copyright 1997-1999 ObjectSpace, Inc.
14850 Quorum Drive, Suite 500
Dallas, Texas 75240