--- projects/cms/source/util/uk/org/iscream/cms/util/XMLStringParser.java 2000/12/12 20:44:30 1.5 +++ projects/cms/source/util/uk/org/iscream/cms/util/XMLStringParser.java 2003/02/05 14:27:59 1.17 @@ -1,29 +1,48 @@ +/* + * i-scream central monitoring system + * http://www.i-scream.org.uk + * Copyright (C) 2000-2002 i-scream + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + //---PACKAGE DECLARATION--- -package uk.ac.ukc.iscream.util; +package uk.org.iscream.cms.util; //---IMPORTS--- import java.io.*; -import java.util.ArrayList; - +import java.util.LinkedList; +import java.util.Iterator; import org.xml.sax.*; -import javax.xml.parsers.SAXParserFactory; -import javax.xml.parsers.ParserConfigurationException; -import javax.xml.parsers.SAXParser; +import org.xml.sax.helpers.*; +import javax.xml.parsers.*; /** * XMLStringParser - Used to assist in creating XMLPacket objects. * - * @author $Author: ajm $ - * @version $Id: XMLStringParser.java,v 1.5 2000/12/12 20:44:30 ajm Exp $ + * @author $Author: tdb $ + * @version $Id: XMLStringParser.java,v 1.17 2003/02/05 14:27:59 tdb Exp $ */ -public class XMLStringParser extends HandlerBase { +public class XMLStringParser extends DefaultHandler { //---FINAL ATTRIBUTES--- /** * The current CVS revision of this class */ - public final String REVISION = "$Revision: 1.5 $"; + public final String REVISION = "$Revision: 1.17 $"; //---STATIC METHODS--- @@ -33,38 +52,24 @@ public class XMLStringParser extends HandlerBase { * No-args constructor. Generally not used. */ public XMLStringParser () { - this.packet = new XMLPacket(); + _packet = new XMLPacket(); } /** * Constructor for accepting a reference to an XMLPacket */ public XMLStringParser (XMLPacket packet) { - this.packet = packet; + _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. + /** + * 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 is the root node, then: @@ -73,26 +78,24 @@ public class XMLStringParser extends HandlerBase { * "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)); + public void startElement (String uri, String name, String qName, Attributes atts) { + _tagList.addLast(qName); + if (atts != null) { + for (int i = 0; i < atts.getLength (); i++) { + _packet.addParam(getPath()+".attributes."+atts.getQName(i), atts.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--; + public void endElement (String uri, String name, String qName) { + _tagList.removeLast(); } - + /** * Any text falling within a pair of terminal tags must * be added to the XMLPacket. Trim leading and trailing @@ -101,16 +104,14 @@ public class XMLStringParser extends HandlerBase { */ 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); - } + _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 + * This uses the uk.org.iscream.cms.server.util.NameFormat class * to format the toString() * * @return the name of this class and its CVS revision @@ -133,10 +134,12 @@ public class XMLStringParser extends HandlerBase { * 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); + String path = ""; + if (_tagList.size() > 0) { + Iterator i = _tagList.iterator(); + path = (String) i.next(); + while(i.hasNext()) { + path = path + "." + (String) i.next(); } } return path; @@ -144,11 +147,24 @@ public class XMLStringParser extends HandlerBase { //---ACCESSOR/MUTATOR METHODS--- -//---ATTRIBUTES--- + /** + * Accessor to the XMLPacket. + */ + public XMLPacket getXMLPacket() { + return _packet; + } - private int indentLevel = 0; - private ArrayList tagList = new ArrayList(); - private XMLPacket packet; +//---ATTRIBUTES--- + + /** + * A LinkedList of tags + */ + private LinkedList _tagList = new LinkedList(); + + /** + * A reference to the XMLPacket we are making + */ + private XMLPacket _packet; /** * This is the friendly identifier of the