TcpServer

This object allows you to create a TCP server, allowing you to listen to incoming connections.

Constructor function.

var myObject = new TcpServer(events);

1. events - (object) the events that can be called
   • onNewConnection - (onNewConnection) called when a client is trying to establish a connection

var myObject = new TcpServer();

var myObject = new TcpServer({
	onNewConnection: function()
	{
		Console.print("New client!");
	}
});

Start listening for clients.

myObject.listen(address, port);

myObject.listen(address);

myObject.listen();

1. address - (string) the address where to listen (default: all network interfaces)
2. port - (integer) the port number (default: choose a port automatically)

• (TcpServer) this TcpServer

• (ListenError) unable to start listening

Freezes the execution until a new connection arrives or waitTime time elapsed.

myObject.waitForNewConnection(waitTime);

myObject.waitForNewConnection();

1. waitTime - (integer) the time to wait (milliseconds, default: 30000)

• (TcpServer) this TcpServer

• (WaitForNewConnectionError) waiting for new connection failed

Returns the next pending connection as a Tcp object that can be used to read and write to the client. You should store this object if you want to write to this client later.

myObject.nextPendingConnection();

• (Tcp) the new client as a Tcp object

• (NoPendingConnectionError) there is no pending connection

Returns the ip address on which this server is listening.

myObject.address();

• (string) the ip address on which this server is listening

Returns the port used by this server.

myObject.port();

• (integer) the port used by this server

Called when a new client has connected.

myObject.onNewConnection = function() {};

myObject.onNewConnection = function()
{
	var client = myObject.nextPendingConnection();
 
	// do something with the client...
};