Click here to Skip to main content
15,867,704 members
Articles / Web Development / HTML
Article

Writing XML using JavaScript

Rate me:
Please Sign up or sign in to vote.
4.81/5 (22 votes)
21 Dec 20052 min read 298.3K   8.5K   57   27
This article illustrates a Javascript XMLWriter object.

Introduction

My most recent project makes heavy use of remote scripting (or what some people might call AJAX). As such, I wanted an easy way to write XML from JavaScript so that it could be sent to my server. Now, there might be a very simple way of doing this, but I don’t know it if there is. So I decided to write a JavaScript object to simplify the process of writing XML.

Using the code

The object is called XMLWriter. It automatically replaces invalid characters such as quotation marks or greater than signs with the appropriate XML values. However, it does not throw exceptions on invalid tag names, because the application I’m writing won’t have the possibility of producing invalid tag names. If you want to add tag-name validation to the object, it should not be a difficult task.

The XMLWriter object can be created with the JavaScript new command like so:

JavaScript
var XML = new XMLWriter();

The XMLWriter object has the following public methods:

  • BeginNode (Name)
  • EndNode ()
  • Attrib (Name, Value)
  • WriteString (Value)
  • Node (Name, Value)
  • Close ()
  • ToString ()

BeginNode writes out an opening tag, giving it the name that you pass the method. Below is an example, followed by the XML it would produce:

JavaScript
XML.BeginNode("Foo");
//Produces:  <Foo

EndNode ends the current node (if any are still open). So following from the BeginNode example, if we were to write XML.EndNode(), the writer would write “/>”. The object is smart enough to know if you have written any text or inner nodes out and will write “</Foo>” if necessary.

Attrib writes out an attribute and value on the currently open node. Below is an example, followed by the XML it would produce:

JavaScript
XML.BeginNode("Foo");
XML.Attrib("Bar", "Some Value");
XML.EndNode();
//Produces: <Foo Bar="Some Value" />

WriteString writes out a string value to the XML document as illustrated below:

JavaScript
XML.BeginNode("Foo");
XML.WriteString("Hello World");
XML.EndNode();
//Produces <Foo>Hello World</Foo>

The Node method writes out a named tag and value as illustrated below:

JavaScript
XML.Node("MyNode", "My Value");
//Produces: <MyNode>My Value</MyNode>

The Close method does not necessarily need to be called, but it’s a good idea to do so. What it does is end any nodes that have not been ended.

Finally, the ToString method returns the entire XML document as a single string (duh).

Summary

I’ve provided some sample code. The XMLWriter.js file contains all the code you will need to write XML. It is clean code, but uncommented. I’ve tested this code in IE 6.0 and FireFox 1.5.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer
United States United States
I'm a professional geek.

Comments and Discussions

 
GeneralQuestion about using in JSP page Pin
mastaboywonder27-Apr-08 12:23
mastaboywonder27-Apr-08 12:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.