cms/util/XMLStringParser.java

//---PACKAGE DECLARATION---
package uk.ac.ukc.iscream.util;

//---IMPORTS---
import java.io.*;
import java.util.ArrayList;

import org.xml.sax.*;
import javax.xml.parsers.SAXParserFactory;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;

/**
 * XMLStringParser - Used to assist in creating XMLPacket objects.
 *
 * @author  $Author: ajm4 $
 * @version $Id: XMLStringParser.java,v 1.5 2000/12/12 20:44:30 ajm4 Exp $
 */
public class XMLStringParser extends HandlerBase {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public final String REVISION = "$Revision: 1.5 $";
    
//---STATIC METHODS---

//---CONSTRUCTORS---

    /**
     * No-args constructor.  Generally not used.
     */
    public XMLStringParser () {
        this.packet = new XMLPacket();
    }

    /**
     * Constructor for accepting a reference to an XMLPacket
     */
    public XMLStringParser (XMLPacket packet) {
        this.packet = packet;
    }

//---PUBLIC METHODS---

    /**
     * Accessor to the XMLPacket.
     */ 
    public XMLPacket getXMLPacket() {
        return packet;
    }

    //===========================================================
    // SAX DocumentHandler methods
    //===========================================================

    public void startDocument () throws SAXException {
        //System.out.println("XMLPacketParser - Starting parse process...");
    }

    public void endDocument () throws SAXException {
        //System.out.println("XMLPacketParser - I just finished parsing an XML String.");
    }

    /** Add each tag's attribute to the XMLPacket.
     * Note that all attributes within an opening tag are
     * stored as "someroot.sometag.attributes.attribute_name"
     * E.g. If <packet> is the root node, then:
     *     <packet machine_name="raptor">
     * is stored as:
     *     "packet.attributes.machine_name"
     * within the XMLPacket.
     */
    public void startElement (String name, AttributeList attrs) throws SAXException {
        indentLevel++;
        tagList.add(name);
        if (attrs != null) {
            for (int i = 0; i < attrs.getLength (); i++) {
                packet.addParam(getPath()+".attributes."+attrs.getName(i), attrs.getValue(i));
            }
        }
    }

    /**
     * When an XML element is finished with, we must remove
     * the tag name from the tagList and decrement the indent
     * level.
     */
    public void endElement (String name) throws SAXException {
        tagList.remove(tagList.size()-1);    
        indentLevel--;
    }

    /**
     * Any text falling within a pair of terminal tags must
     * be added to the XMLPacket.  Trim leading and trailing
     * spaces and do not bother to add if there is no data
     * specified within the tags.
     */
    public void characters (char[] buf, int offset, int len) throws SAXException {
        String s = new String(buf, offset, len);
        if (!s.trim().equals("")) {
            packet.addParam(getPath(), s);
        }
    }

    /**
     * Overrides the {@link java.lang.Object#toString() Object.toString()}
     * method to provide clean logging (every class should have this).
     *
     * This uses the uk.ac.ukc.iscream.util.NameFormat class
     * to format the toString()
     *
     * @return the name of this class and its CVS revision
     */
    public String toString() {
        return FormatName.getName(
            _name,
            getClass().getName(),
            REVISION);
    }

//---PRIVATE METHODS---

    //===========================================================
    // Helpers ...
    //===========================================================
    
    /**
     * Return the heirarchical string to be used as a key value
     * in the XMLPacket.
     */
    private String getPath () {
        String path = (String)tagList.get(0);
        if (tagList.size() > 0) {
            for (int i = 1 ; i < tagList.size() ; i++) {
                path = path + "." + (String)tagList.get(i);
            }
        }
        return path;
    }

//---ACCESSOR/MUTATOR METHODS---

//---ATTRIBUTES---

    /**
     * To keep track of our identation level
     */
    private int indentLevel = 0;
    
    /**
     * An ArrayList of tags
     */
    private ArrayList tagList = new ArrayList();
    
    /**
     * A reference to the XMLPacket we are making
     */
    private XMLPacket packet;
    
    /**
     * This is the friendly identifier of the
     * component this class is running in.
     * eg, a Filter may be called "filter1",
     * If this class does not have an owning
     * component,  a name from the configuration
     * can be placed here.  This name could also
     * be changed to null for utility classes.
     */
    private String _name = null;

//---STATIC ATTRIBUTES---

}
Revision:	1.6
Committed:	Sun Jan 28 05:47:05 2001 UTC (23 years, 3 months ago) by tdb
Branch:	MAIN
Changes since 1.5:	+13 -2 lines
Log Message:	Some tidying up.
#	User	Rev	Content
1	ajm	1.5	//---PACKAGE DECLARATION---
2			package uk.ac.ukc.iscream.util;
3
4			//---IMPORTS---
5			import java.io.*;
6			import java.util.ArrayList;
7
8			import org.xml.sax.*;
9			import javax.xml.parsers.SAXParserFactory;
10			import javax.xml.parsers.ParserConfigurationException;
11			import javax.xml.parsers.SAXParser;
12
13			/**
14			* XMLStringParser - Used to assist in creating XMLPacket objects.
15			*
16			* @author $Author: ajm4 $
17	tdb	1.6	* @version $Id: XMLStringParser.java,v 1.5 2000/12/12 20:44:30 ajm4 Exp $
18	ajm	1.5	*/
19			public class XMLStringParser extends HandlerBase {
20
21			//---FINAL ATTRIBUTES---
22
23			/**
24			* The current CVS revision of this class
25			*/
26	tdb	1.6	public final String REVISION = "$Revision: 1.5 $";
27	ajm	1.5
28			//---STATIC METHODS---
29
30			//---CONSTRUCTORS---
31
32			/**
33			* No-args constructor. Generally not used.
34			*/
35			public XMLStringParser () {
36			this.packet = new XMLPacket();
37			}
38
39			/**
40			* Constructor for accepting a reference to an XMLPacket
41			*/
42			public XMLStringParser (XMLPacket packet) {
43			this.packet = packet;
44			}
45
46			//---PUBLIC METHODS---
47
48			/**
49			* Accessor to the XMLPacket.
50			*/
51			public XMLPacket getXMLPacket() {
52			return packet;
53			}
54
55			//===========================================================
56			// SAX DocumentHandler methods
57			//===========================================================
58
59			public void startDocument () throws SAXException {
60			//System.out.println("XMLPacketParser - Starting parse process...");
61			}
62
63			public void endDocument () throws SAXException {
64			//System.out.println("XMLPacketParser - I just finished parsing an XML String.");
65			}
66
67			/** Add each tag's attribute to the XMLPacket.
68			* Note that all attributes within an opening tag are
69			* stored as "someroot.sometag.attributes.attribute_name"
70			* E.g. If <packet> is the root node, then:
71			* <packet machine_name="raptor">
72			* is stored as:
73			* "packet.attributes.machine_name"
74			* within the XMLPacket.
75			*/
76			public void startElement (String name, AttributeList attrs) throws SAXException {
77			indentLevel++;
78			tagList.add(name);
79			if (attrs != null) {
80			for (int i = 0; i < attrs.getLength (); i++) {
81			packet.addParam(getPath()+".attributes."+attrs.getName(i), attrs.getValue(i));
82			}
83			}
84			}
85
86			/**
87			* When an XML element is finished with, we must remove
88			* the tag name from the tagList and decrement the indent
89			* level.
90			*/
91			public void endElement (String name) throws SAXException {
92			tagList.remove(tagList.size()-1);
93			indentLevel--;
94			}
95
96			/**
97			* Any text falling within a pair of terminal tags must
98			* be added to the XMLPacket. Trim leading and trailing
99			* spaces and do not bother to add if there is no data
100			* specified within the tags.
101			*/
102			public void characters (char[] buf, int offset, int len) throws SAXException {
103			String s = new String(buf, offset, len);
104			if (!s.trim().equals("")) {
105			packet.addParam(getPath(), s);
106			}
107			}
108
109			/**
110			* Overrides the {@link java.lang.Object#toString() Object.toString()}
111			* method to provide clean logging (every class should have this).
112			*
113			* This uses the uk.ac.ukc.iscream.util.NameFormat class
114			* to format the toString()
115			*
116			* @return the name of this class and its CVS revision
117			*/
118			public String toString() {
119			return FormatName.getName(
120			_name,
121			getClass().getName(),
122			REVISION);
123			}
124
125			//---PRIVATE METHODS---
126
127			//===========================================================
128			// Helpers ...
129			//===========================================================
130
131			/**
132			* Return the heirarchical string to be used as a key value
133			* in the XMLPacket.
134			*/
135			private String getPath () {
136			String path = (String)tagList.get(0);
137			if (tagList.size() > 0) {
138			for (int i = 1 ; i < tagList.size() ; i++) {
139			path = path + "." + (String)tagList.get(i);
140			}
141			}
142			return path;
143			}
144
145			//---ACCESSOR/MUTATOR METHODS---
146
147			//---ATTRIBUTES---
148
149	tdb	1.6	/**
150			* To keep track of our identation level
151			*/
152	ajm	1.5	private int indentLevel = 0;
153	tdb	1.6
154			/**
155			* An ArrayList of tags
156			*/
157	ajm	1.5	private ArrayList tagList = new ArrayList();
158	tdb	1.6
159			/**
160			* A reference to the XMLPacket we are making
161			*/
162	ajm	1.5	private XMLPacket packet;
163
164			/**
165			* This is the friendly identifier of the
166			* component this class is running in.
167			* eg, a Filter may be called "filter1",
168			* If this class does not have an owning
169			* component, a name from the configuration
170			* can be placed here. This name could also
171			* be changed to null for utility classes.
172			*/
173			private String _name = null;
174
175			//---STATIC ATTRIBUTES---
176
177			}