I’ve been helping this guy from India with an Ajax / XML chat app. I wrote one ages ago, but I think it broke. So, since I’m already giving a how-to, I might as well write it down.
Ajax For Newbies
If you are familiar with XML, the buzzword "Ajax", the XMLHttpRequest() object, and DOM scripting, skip to the juicy part. If not, keep on reading.
An XML Primer for Ajax
XML looks kind of like HTML, but it is quite different. For the sake of brevity, XML is a structured data file that draws from SGML. The difference is that it must be well formed and that the tags can be "arbitrarily" named (unless you specify a DTD).
Going into more detail would not be pragmatic since the JavaScript XML parsers only care about whether or not the XML is well-formed. So, here is an example XML file:
<messages>
<message>
<from>
Fred
</from>
<body>
Fred here... Just making a post!
</body>
</message>
<message>
<from>
Joey
</from>
<body>
Hey, Fred. Thanks for the post.
</body>
</message>
</messages>
The good thing about good XML is that it has metadata built in. You can read it and know what is what. The code above is obviously a group of messages. Inside the messages group is a message. In this case, there are two of them. Inside each message is a from and a body. The from, of course, contains the name of the person who sent the message. It follows that the body contains the message body. This XML file will be used later.
XMLHttpRequest Primer for Ajax
XMLHttpRequest, at least on browsers that aren’t Internet Explorer 6 or less, is a native object in JavaScript that allows the client to send a request to the server "in the background." That is, the browser doesn’t have to physically go to the page. This makes it easy to update parts of pages without iframe, frame and other hacks.
I’ll give you the condensed version of how to use it for the sake of brevity. I’m sort of copy / pasting code from Apple’s Developer documents because their example does XMLHttpRequest() the right way.
// This needs to be in the global scope so we can use it in other functions.
var xml_obj;
/*
We will be sending loadXMLDoc the url of the page we want to call,
the query string to post to the url, and a function to call when
the script updates.
*/
function loadXMLDoc(url,query_string,callback) {
xml_obj = false;
// Try native XMLHttpRequest first.
if(window.XMLHttpRequest) {
try {
xml_obj = new XMLHttpRequest();
} catch(e) {
xml_obj = false;
}
// If native fails, fall back to IE is ActiveX objects.
} else if(window.ActiveXObject) {
try {
xml_obj = new ActiveXObject("Msxml2.XMLHTTP");
} catch(e) {
try {
xml_obj = new ActiveXObject("Microsoft.XMLHTTP");
} catch(e) {
xml_obj = false;
}
}
}
if(xml_obj) {
// Any time the state of the request changes, callback will be called.
xml_obj.onreadystatechange = callback;
// Set the parameters of the request.
// POST can also be GET. We use the URL from above.
// The <q>true</q> tells whether the request should be asynchronous.
xml_obj.open("POST", url, true);
xml_obj.setRequestHeader("Content-Type","application/x-www-form-urlencoded");
// Since we are POSTing, we send the query string as a header
// instead of as a string at the end of the URL.
xml_obj.send(query_string);
}
else{
alert("Failed to create XMLHttpRequest!");
}
}
/*
This is an example callback function.
*/
function messagesRetrieved(){
if (xml_obj.readyState == 4){
// When readyState is 4, the request is complete.
if (xml_obj.status == 200){
// When status is 200, we know there are no server errors or anything.
// and we can process the data.
}
else{
alert("There was a problem retrieving the XML data:
" + xml_obj.statusText);
}
}
}
// How we would call the loadXMLDoc
loadXMLDoc("http://domain.com/myurl.php","action=get_messages",messagesRetrieved);
Hopefully, from the comments in the script, you can see what is going on. When the request starts, the xml_obj.readyState property will be update. Once the request is complete, there will be several properties available.
* xml_obj.responseXML is the most important for Ajax, since that is where the data is stored as an object. Yes, JavaScript automagically parses the XML and puts it in an object for you.
* xml_obj.responseText is nice because it will print out the text returned from the server. It’s great for debugging.
* xml_obj.status is the server status code of the request. This should be 200 or something is wrong with your scripts.
What is Ajax About, Then?
As I said, the term "Ajax" is a buzzword. It’s a short way of saying, "JavaScript using XMLHttpRequest to get XML from a server in the background."
There are other methods that are probably get called Ajax, but aren’t. For example, XMLHttpRequest allows the server to send back text instead of XML ("Ajat"?). Also, if the asynchronous flag is set to false, the request doesn’t run "in the background." Instead the script that is running waits for a response from the server before it continues.
It just turns out XML is slightly more usable for complex stuff and that synchronous requests defeat the point. Though "Ajat" have many uses.
DOM Scripting
DOM scripting is the key to Ajax. Ajax is pretty useless if you can’t extract the data. Basically put, the DOM is HTML / XML represented in an object. DOM Scripting, then, is using JavaScript (or some other language, I suppose) to manipulate this object. If you manipulate the DOM of your HTML page, it will reflect visibly in the browser.
DOM scripting replaces old-school document.write coding. Instead, you insert nodes (aka tags) or remove nodes from the DOM, and thus the page. The great thing is that XML files can be represented as a DOM object. That means that you can manipulate the XML the same way you manipulate the HTML. You’ll make a lot of use of the following (where xml = xml_obj.responseXML):
* xml.childNodes is a collection of the children of the current node. It’s handy to loop on: for(i = 0; i < xml.childNodes.length; i++){}
* xml.nodeName is the string value of the current tag.
* xml.nodeType is a numeric representation of what kind of node the current element is, text (3) or element (1). This is handy for conditionals: if(xml.nodeType == 3){alert(xml.nodeValue);}
* xml.nodeValue is the string value of the current element if it is a text node.
There are more useful properties and methods, but, for now, we’re going to loop through output. It isn’t the most efficient method, but it is more agnostic than, say, xml.getElementsByTagName.
A Basic Ajax Chat
As we see above, we already have a good deal of code written. In fact, most of the tedious stuff is done. We just have to solve a few problems.
Server Side Scripting
Ajax isn’t worth much without server side scripting. PHP is my weapon of choice, but ASP, Perl, Ruby, or any other language will work just fine. However, since I chose PHP, it will affect my data storage solution.
Data Storage
Most people use Ajax to deliver data stored on the server. All the usual methods are available including mySQL, text files, and XML. XML seems like the likely choice, since we are spitting out XML. However, at least with PHP, working with XML is hard. Further, doing queries on XML seems like it’d be severely difficult in PHP. Other languages might like XML better than PHP, though.
So, for the sake of this article, that leaves text files and mySQL. Normally, I’d go with mySQL but this is a simple article. So, we’re just going to use text files. Opening files is easier than writing all the code to get the database running.
The Text Storage File
The text file needs to only hold two variables: the name of the person sending the message, and their message. We’ll use a tab-separated file since it is unlikely that the user will enter a tab (because that typically changes fields) and we’ll remove all carriage returns. So, the XML file mentioned at the beginning before will be stored like this:
Fred Fred here... Just making a post!
Joey Hey, Fred. Thanks for the post.
Convert The Text File To XML
We’ll need to write a function in PHP to convert the text file to XML for display in our chat application. It should be something like this:
function tsv_to_xml($file){
if(file_exists($file))
$output = trim(file_get_contents($file));
else
die("Couldn open the file.");
if($output != "")
$output = explode("
",$output);
else
$output = array();
$return = "<messages>";
for($i=0; $i<count($output); $i ){
$output[$i] = explode(" ",$output[$i],2);
$return .= "<message>";
$return .= "<from>";
$return .= "".htmlentities($output[$i][0])."";
$return .= "</from>";
$return .= "<body>";
$return .= "".htmlentities($output[$i][1])."";
$return .= "</body>";
$return .= "</message>";
}
$return .= "</messages>";
return $return;
}
That should return the XML file specified at the beginning from the tab-separated file.
Adding a New Message
We also need to add to the text file. So, we’ll write a PHP function for that, as well:
function tsv_add($file, $from, $body){
if(file_exists($file))
$output = trim(file_get_contents($file));
else
die("Couldn open the file.");
$from = preg_replace("/(s|
|
|
)/"," ",$from);
$body = preg_replace("/(s|
|
|
)/"," ",$body);
$tsv = $from." ".$body;
$my_file = fopen("$file","w");
fwrite($my_file, trim($tsv)."
".$output);
fclose($my_file);
return tsv_to_xml($file);
}
Basically, we create a tab-separated entry for our file (stripping out protected characters), dump it into a file and return the updated XML file.
Putting the PHP Together
It’d be a bummer to use several different PHP files when one would do. So, we’ll use a script to manage it. We want to accept an action parameter to help our script decide what to do. It will look like this:
$file = "./data/chat.txt";
switch($_POST["action"]){
case "get_xml":
header("Content-type: text/xml");
echo tsv_to_xml($file);
die();
break;
case "add_post":
header("Content-type: text/xml");
echo tsv_add($file, $_POST["from"], $_POST["post"]);
die();
break;
default:
die("There is no action associated with that call.");
break;
}
Once we have all that PHP in one file, it will be our request file. So, we will call it request.php and put it on our development server putting the tsv_add and tsv_to_xml functions at the top. Make sure the data folder is writable! Make sure you put an empty chat.txt file in the data folder!
The HTML
The only thing we don’t have is the HTML file (and a little bit of JavaScript) we’ll use to display the XML from the chat. The code for the HTML should look something like this (except you’ll probably want to put the CSS in a file and use the link tag):
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Ajax Chat</title>
<style type="text/css">
label{display:block; width:100%;}
input{display:block; width:100%;}
input#submit{width:auto;}
</style>
<script type="text/javascript" src="chat.js"></script>
</head>
<body onload="get_xml();">
<form method="post" action="#" name="send_form" id="send_form" onsubmit="send_xml(); return false;">
<p>
<label for="uname" accesskey="n">Name</label>
<input type="text" id="uname" name="uname">
</p>
<p>
<label for="mbody" accesskey="m">Message</label>
<input type="text" id="mbody" name="mbody">
</p>
<p>
<input type="submit" id="submit" value="Send Message" accesskey="s">
</p>
</form>
<div id="chat_area">Loading chat...</div>
</body>
</html>
Original Source:
Related Stuff
-
MooV: Using cutting edge Video phones and Software Video Phones - coupling all that with VoIP and empowering the disabled.
-
Moo Telecom: VoIP communications made easy - Ring anyway with the fun and ease of using a normal phone
-
TagR:Mobile Social Network with Real Time Locations Based services, and Ambience Intelligence, VoiP, IM, Skype, Googletalk, Mapping, Flickr, Events, Calendaring, Scheduling, SecondLife Support
-
ClearSMS : ClearSMS is a Web-based application that lets you send bulk SMS messages to your customers, contacts, or just about anyone.
-
Jajah:jah is a VoIP (Voice over IP) provider, founded by Austrians Roman Scharf and Daniel Mattes in 2005[1]. The Jajah headquarters are located in Mountain View, CA, USA, and Luxembourg. Jajah maintains a development centre in Israel.
-
Skype: It’s free to download and free to call other people on Skype. Skype the number one voice over ip software
- PrivatePhone: a free local phone number with voicemail and messages you can check online or from any phone.