Bidirectional XML support

How it works
=============

The Client opens a HTTP/1.0 connection to the server.
Using that connection, client and server can exchange
data in both directions.

Server-to-client communication is done the traditional
way. The server just sends more and more data.

Client-to-server communication is similar: After sending
the HTTP request and receiving the HTTP response header, 
the client can continue sending data through the already
established connection.

IRCG will notice the incoming data and deliver it 
to an arbitrary server using a HTTP POST.  This invokes
e.g. a PHP script which can operate on the data and
cause further actions.

IRCG PHP API
============

bool ircg_set_on_read_data(int connection, string host, int port, string data);

Parameters:

connection: IRCG id as returned by ircg_pconnect
host:       Hostname or IP of the HTTP server (usually "127.0.0.1")
port:       e.g. 80
data:       Beginning of the HTTP header (see example a few lines later)


PHP/Flash Example
=================


Login snippet
-------------

<?php

# note the \0 at the end of each format string
# we deliver raw XML as sent using ircg_msg()

ircg_register_format_messages("name", array("%r\0", "%r\0", "%r\0"));

$id = ircg_pconnect(..);

# make sure that there is only ONE CRLF at the end of the 4th parameter.
# IRCG will use it to create a full POST request

ircg_set_on_read_data($id, "127.0.0.1", "8000", 
		"POST /submit.php HTTP/1.0\r\nHost: server.name\r\n");
 





Flash Actionscript snippet
--------------------------

sock = new XMLSocket();

sock.onConnect = function(status) {
	if (status) {
		socket.send('GET /msgs.php?sid=xyz HTTP/1.0\r\n\r\n');
	}
}


sock.onData = function(src) {
	if (http_response) {
		sock.onXML(new XML(src));
	} else {
		http_response = true;

		sock.onConnected();
	}
}

sock.onConnected = function() {
	sock.send('<cmd type="join">#event</cmd>');
}

sock.onXML = function (xmlObj) {
	// process XML data in xmlObj, e.g. update display
}

http_response = false;

sock.connect("your.web.server", 8000);