org.openmuc.jositransport
Class ClientTSAP

java.lang.Object
  extended by org.openmuc.jositransport.ClientTSAP

public class ClientTSAP
extends java.lang.Object

This class implements a client Transport Service Access Point (TSAP) over TCP/IP as defined in RFC 1006, ISO 8072, and ISO 8073. It can be used to create TConnections that connect to remote ServerTSAPs.


Constructor Summary
ClientTSAP()
          Use this constructor to create a client TSAP that will start connections to remote TSAPs.
ClientTSAP(javax.net.SocketFactory socketFactory)
          Use this constructor to create a client TSAP that will start connections to remote TSAPs.
 
Method Summary
 TConnection connectTo(java.net.InetAddress address, int port)
          Connect to a remote TSAP that is listening at the destination address.
static int getMaxTPDUSize(int maxTPDUSizeParam)
          Get the maximum TPDUSize.
 int getMaxTPDUSizeParam()
          Get the maxTPDUSize Parameter to be used by this TSAP
 void setConnectTimeout(int timeout)
           
 void setMaxTPDUSizeParam(int maxTPDUSizeParam)
          Set the maxTPDUSize.
 void setMessageFragmentTimeout(int messageFragmentTimeout)
          Set the TConnection timeout for receiving data once the beginning of a message has been received.
 void setMessageTimeout(int messageTimeout)
          Set the TConnection timeout for waiting for the first byte of a new message.
 void setSocketFactory(javax.net.SocketFactory socketFactory)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ClientTSAP

public ClientTSAP()
Use this constructor to create a client TSAP that will start connections to remote TSAPs.


ClientTSAP

public ClientTSAP(javax.net.SocketFactory socketFactory)
Use this constructor to create a client TSAP that will start connections to remote TSAPs. You could pass an SSLSocketFactory to enable SSL.

Method Detail

setMessageTimeout

public void setMessageTimeout(int messageTimeout)
Set the TConnection timeout for waiting for the first byte of a new message. Default is 0 (unlimited)

Parameters:
messageTimeout - in milliseconds

setMessageFragmentTimeout

public void setMessageFragmentTimeout(int messageFragmentTimeout)
Set the TConnection timeout for receiving data once the beginning of a message has been received. Default is 60000 (60seconds)

Parameters:
messageFragmentTimeout - in milliseconds

setMaxTPDUSizeParam

public void setMaxTPDUSizeParam(int maxTPDUSizeParam)
Set the maxTPDUSize. The default maxTPDUSize is 65531 (see RFC 1006). Only use this function if you want to change this.

Parameters:
maxTPDUSizeParam - The maximum length is equal to 2^(maxTPDUSizeParam) octets. Note that the actual TSDU size that can be transfered is equal to TPDUSize-3. Default is 65531 octets (see RFC 1006), 7 <= maxTPDUSizeParam <= 16, needs to be set before listening or connecting

getMaxTPDUSizeParam

public int getMaxTPDUSizeParam()
Get the maxTPDUSize Parameter to be used by this TSAP

Returns:
the maximum TPDU size

getMaxTPDUSize

public static int getMaxTPDUSize(int maxTPDUSizeParam)
                          throws java.io.IOException
Get the maximum TPDUSize. This is equal to 2^(maxTPDUSizeParam)

Parameters:
maxTPDUSizeParam -
Returns:
the maximum TPDU size
Throws:
java.io.IOException

connectTo

public TConnection connectTo(java.net.InetAddress address,
                             int port)
                      throws java.io.IOException
Connect to a remote TSAP that is listening at the destination address.

Parameters:
address - remote InetAddress
port - remote port
Returns:
the Connection Object
Throws:
java.io.IOException - is thrown if connection was unsuccessful.

setConnectTimeout

public void setConnectTimeout(int timeout)

setSocketFactory

public void setSocketFactory(javax.net.SocketFactory socketFactory)