ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/projects/cms/source/util/uk/org/iscream/cms/util/XMLStringParser.java
(Generate patch)

Comparing projects/cms/source/util/uk/org/iscream/cms/util/XMLStringParser.java (file contents):
Revision 1.1 by pjm2, Wed Nov 22 08:40:53 2000 UTC vs.
Revision 1.13 by tdb, Tue May 29 17:02:35 2001 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines