/*Copyright (c) 2008 Nikos Siatras
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.*/
package Extasys.Network.TCP.Client.Connectors;
import Extasys.DataFrame;
import Extasys.Network.TCP.Client.Connectors.Packets.IncomingTCPClientPacket;
import Extasys.Network.TCP.Client.Connectors.Packets.MessageCollectorTCPClientPacket;
import Extasys.Network.TCP.Client.Connectors.Packets.OutgoingTCPClientPacket;
import Extasys.Network.TCP.Client.ExtasysTCPClient;
import Extasys.Network.TCP.Client.Connectors.Tools.TCPClientMessageCollector;
import Extasys.Network.TCP.Client.Exceptions.ConnectorCannotSendPacketException;
import Extasys.Network.TCP.Client.Exceptions.ConnectorDisconnectedException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.InetAddress;
import java.net.Socket;
/**
*
* @author Nikos Siatras
*/
public class TCPConnector
{
private ExtasysTCPClient fMyTCPClient;
private String fName;
private InetAddress fServerIP;
private int fServerPort;
private boolean fActive;
protected boolean fIsConnected = false;
//Socket properties.
public Socket fConnection;
private int fReadBufferSize;
public InputStream fInput;
public OutputStream fOutput;
private ReadIncomingDataThread fReadIncomingDataThread;
//Data throughput.
public int fBytesIn = 0;
public int fBytesOut = 0;
//Message collector properties.
private boolean fUseMessageCollector;
private String fETX;
private TCPClientMessageCollector fMessageCollector;
//Messages IO.
public IncomingTCPClientPacket fLastIncomingPacket = null;
public MessageCollectorTCPClientPacket fLastMessageCollectorPacket = null;
private OutgoingTCPClientPacket fLastOutgoingPacket = null;
/**
* Constructs a new TCP Connector.
* @param myTCPClient is the TCP connector's main Extasys TCP Client.
* @param name is the connector's name.
* @param serverIP is the server's ip address the connector will use to connect.
* @param serverPort is the server's tcp port the connector will use to connect.
* @param readBufferSize is the read buffer size in bytes for this connection.
*/
public TCPConnector(ExtasysTCPClient myTCPClient, String name, InetAddress serverIP, int serverPort, int readBufferSize)
{
fMyTCPClient = myTCPClient;
fName = name;
fServerIP = serverIP;
fServerPort = serverPort;
fReadBufferSize = readBufferSize;
}
/**
* Constructs a new TCP Connector with message collector use (ETX).
* @param myTCPClient is the TCP connector's main Extasys TCP Client.
* @param name is the connector's name.
* @param serverIP is the server's ip address the connector will connect to.
* @param serverPort is the server's tcp port the connector will connect to.
* @param readBufferSize is the read buffer size in bytes for this connection.
* @param ETX is the End of Text character.
*/
public TCPConnector(ExtasysTCPClient myTCPClient, String name, InetAddress serverIP, int serverPort, int readBufferSize, char ETX)
{
fMyTCPClient = myTCPClient;
fName = name;
fServerIP = serverIP;
fServerPort = serverPort;
fReadBufferSize = readBufferSize;
fUseMessageCollector = true;
fETX = String.valueOf(ETX);
fMessageCollector = new TCPClientMessageCollector(this, ETX);
}
/**
* Constructs a new TCP Connector with message collector use (Splitter).
* @param myTCPClient is the TCP connector's main Extasys TCP Client.
* @param name is the connector's name.
* @param serverIP is the server's ip address the connector will connect to.
* @param serverPort is the server's tcp port the connector will connect to.
* @param readBufferSize is the read buffer size in bytes for this connection.
* @param splitter is the message splitter.
*/
public TCPConnector(ExtasysTCPClient myTCPClient, String name, InetAddress serverIP, int serverPort, int readBufferSize, String splitter)
{
fMyTCPClient = myTCPClient;
fName = name;
fServerIP = serverIP;
fServerPort = serverPort;
fReadBufferSize = readBufferSize;
fUseMessageCollector = true;
fETX = splitter;
fMessageCollector = new TCPClientMessageCollector(this, splitter);
}
/**
* Start the connector (connect to the server).
*/
public void Start() throws Exception
{
if (!fActive)
{
fActive = true;
try
{
fConnection = new Socket(fServerIP, fServerPort);
fInput = fConnection.getInputStream();
fOutput = fConnection.getOutputStream();
}
catch (Exception ex)
{
Stop();
throw new Exception(ex.getMessage());
}
fLastIncomingPacket = null;
fLastMessageCollectorPacket = null;
fLastOutgoingPacket = null;
try
{
fReadIncomingDataThread = new ReadIncomingDataThread(this);
fReadIncomingDataThread.start();
}
catch (Exception ex)
{
Stop();
throw new Exception(ex.getMessage());
}
}
}
/**
* Stop the connector (disconnect from the server).
*/
public void Stop()
{
if (fActive)
{
try
{
if (fConnection != null)
{
fConnection.close();
}
}
catch (Exception ex)
{
}
try
{
if (fInput != null)
{
fInput.close();
}
}
catch (Exception ex)
{
}
fInput = null;
try
{
if (fOutput != null)
{
fOutput.close();
}
}
catch (Exception ex)
{
}
fOutput = null;
if (fLastIncomingPacket != null)
{
fLastIncomingPacket.Cancel();
}
if (fLastMessageCollectorPacket != null)
{
fLastMessageCollectorPacket.Cancel();
}
if (fLastOutgoingPacket != null)
{
fLastOutgoingPacket.Cancel();
}
fActive = false;
fIsConnected = false;
if (fReadIncomingDataThread != null)
{
fReadIncomingDataThread.Dispose();
}
if (fUseMessageCollector)
{
fMessageCollector.Dispose();
fMessageCollector = null;
}
try
{
fMyTCPClient.OnDisconnect(this);
}
catch (Exception ex)
{
}
fConnection = null;
}
}
/**
* Send string data to server.
* @param data is the string to send.
*/
public void SendData(String data) throws ConnectorDisconnectedException, ConnectorCannotSendPacketException
{
try
{
byte[] bytes = data.getBytes();
SendData(bytes, 0, bytes.length);
}
catch (Exception ex)
{
throw new ConnectorCannotSendPacketException(this, null);
}
}
/**
* Send data to server.
* @param bytes is the byte array to be send.
* @param offset is the position in the data buffer at witch to begin sending.
* @param length is the number of the bytes to be send.
*/
public void SendData(byte[] bytes, int offset, int length) throws ConnectorDisconnectedException, ConnectorCannotSendPacketException
{
if (fIsConnected)
{
fLastOutgoingPacket = new OutgoingTCPClientPacket(this, bytes, offset, length, fLastOutgoingPacket);
}
else
{
throw new ConnectorDisconnectedException(this);
}
}
/**
* Returns the main Extasys TCP Client of the connector.
* @return the main Extasys TCP Client of the connector.
*/
public ExtasysTCPClient getMyExtasysTCPClient()
{
return fMyTCPClient;
}
/**
* Returns the active state of this connector.
* @return True if connector is active and connected.
*/
public boolean isActive()
{
return fActive;
}
/**
* Returns the name of this connector.
* @return the name of this connector
*/
public String getName()
{
return fName;
}
/**
* Returns the remote server's ip address.
* @return the remote server's ip address
*/
public InetAddress getServerIPAddress()
{
return fServerIP;
}
/**
* Returns the remote server TCP port.
* @return the remote server TCP port.
*/
public int getServerPort()
{
return fServerPort;
}
/**
* Returns the read buffer size of the connection.
* @return the read buffer size of the connection
*/
public int getReadBufferSize()
{
return fReadBufferSize;
}
/**
* Return the number of bytes received from this connector.
* @return the number of bytes received from this connector.
*/
public int getBytesIn()
{
return fBytesIn;
}
/**
* Returns the number of bytes send from this connector.
* @return the number of bytes send from this connector.
*/
public int getBytesOut()
{
return fBytesOut;
}
/**
* Returns the active state of the message collector.
* @return True if this connector uses message collector.
*/
public boolean isMessageCollectorInUse()
{
return fUseMessageCollector;
}
/**
* Returns the message collector of this connector.
* @return the message collector of this connector.
*/
public TCPClientMessageCollector getMyMessageCollector()
{
return fMessageCollector;
}
/**
* Returns the message collector's End of Text character or splitter.
* @return the message collector's End of Text character or splitter.
*/
public String getETX()
{
return fETX;
}
/**
* Returns True if this conenctor is connected to the host.
* @return True if this conenctor is connected to the host.
*/
public boolean isConnected()
{
return fIsConnected;
}
}
/**
* This thread reads the incoming data.
* @author Nikos Siatras
*/
class ReadIncomingDataThread extends Thread
{
private TCPConnector fMyTCPConnector;
private byte[] fReadBuffer;
private boolean fActive = false;
public ReadIncomingDataThread(TCPConnector myTCPConnector)
{
fMyTCPConnector = myTCPConnector;
fReadBuffer = new byte[myTCPConnector.getReadBufferSize()];
if (!fMyTCPConnector.fIsConnected)
{
fMyTCPConnector.fIsConnected = true;
fMyTCPConnector.getMyExtasysTCPClient().OnConnect(fMyTCPConnector);
}
}
@Override
public void start()
{
fActive = true;
super.start();
}
public void Dispose()
{
fActive = false;
try
{
this.interrupt();
}
catch (Exception ex)
{
}
}
@Override
public void run()
{
int bytesRead = 0;
while (fActive)
{
try
{
bytesRead = fMyTCPConnector.fInput.read(fReadBuffer);
fMyTCPConnector.fBytesIn += bytesRead;
if (bytesRead > 0)
{
if (!fMyTCPConnector.isMessageCollectorInUse()) //No message collector.
{
try
{
fMyTCPConnector.fLastIncomingPacket = new IncomingTCPClientPacket(fMyTCPConnector, new DataFrame(fReadBuffer, 0, bytesRead), fMyTCPConnector.fLastIncomingPacket);
}
catch (Exception ex)
{
fMyTCPConnector.Stop();
}
}
else //Message collector is enabled.
{
try
{
fMyTCPConnector.fLastMessageCollectorPacket = new MessageCollectorTCPClientPacket(fMyTCPConnector, new String(fReadBuffer, 0, bytesRead), fMyTCPConnector.fLastMessageCollectorPacket);
}
catch (Exception ex)
{
fMyTCPConnector.Stop();
}
}
}
else
{
fMyTCPConnector.Stop();
}
}
catch (IOException ex)
{
fMyTCPConnector.Stop();
}
catch (Exception ex)
{
}
}
}
}