The XmlWriter class

The om.XmlWriter class implements methods to create a om.SaxDocumentHandler object, to be used to write XML to a stream.

Steps to use a XML writer:

Declare a variable with the om.SaxDocumentHandler type.
Create the writer object with one of the class methods of om.XmlWriter and assign the reference to the variable.
- om.XmlWriter.createFileWriter(filename) creates an object writing to a file.
- om.XmlWriter.createPipeWriter(command) creates an object writing to a pipe opened by a sub-process.
- om.XmlWriter.createSocketWriter(hostname,portnum) creates an object writing to the TCP socket.
Output XML data with the methods of the om.SaxDocumentHandler object:
1. Use the method startDocument() to start writing to the output.
2. From this point, the order of method calls defines the structure of the XML document. To write an element, fill an om.SaxAttributes object with attributes.
3. Then, initiate the element output with the method startElement().
4. Write element data with thecharacters() method.
5. Entity nodes are created with theom.SaxDocumentHandler.skippedEntityskippedEntity() method.
6. Finish element output with a call to the endElement() method.
7. Repeat these steps as many times as you have elements to write.
8. Instead of using the startElement() method, you can generate processing instruction elements with processingInstruction().
9. Finally, you must finish the document output with a endDocument() call.