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

Comparing projects/cms/source/util/uk/org/iscream/cms/util/XMLPacketMaker.java (file contents):
Revision 1.1 by pjm2, Wed Nov 22 08:40:53 2000 UTC vs.
Revision 1.17 by tdb, Sat May 18 18:16:04 2002 UTC

# Line 1 | Line 1
1 < import java.io.*;
2 < import java.util.ArrayList;
1 > /*
2 > * i-scream central monitoring system
3 > * Copyright (C) 2000-2002 i-scream
4 > *
5 > * This program is free software; you can redistribute it and/or
6 > * modify it under the terms of the GNU General Public License
7 > * as published by the Free Software Foundation; either version 2
8 > * of the License, or (at your option) any later version.
9 > *
10 > * This program is distributed in the hope that it will be useful,
11 > * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 > * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 > * GNU General Public License for more details.
14 > *
15 > * You should have received a copy of the GNU General Public License
16 > * along with this program; if not, write to the Free Software
17 > * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
18 > */
19  
20 + //---PACKAGE DECLARATION---
21 + package uk.org.iscream.cms.server.util;
22 +
23 + //---IMPORTS---
24 + import java.io.*;
25   import org.xml.sax.*;
26 + import javax.xml.parsers.*;
27  
28 < import javax.xml.parsers.SAXParserFactory;
29 < import javax.xml.parsers.ParserConfigurationException;
30 < import javax.xml.parsers.SAXParser;
28 > /**
29 > * XMLPacketMaker - Creates an XMLPacket object.
30 > *
31 > * @author  $Author$
32 > * @version $Id$
33 > */
34 > public class XMLPacketMaker {
35  
36 < // Paul Mutton, pjm2@ukc.ac.uk
36 > //---FINAL ATTRIBUTES---
37  
38 < // XMLPacketMaker - Creates an XMLPacket object.
39 < public class XMLPacketMaker extends HandlerBase {
38 >    /**
39 >     * The current CVS revision of this class
40 >     */
41 >    public final String REVISION = "$Revision$";
42  
43 <    // No-args constructor.  Generally not used.
44 <    public XMLPacketMaker () {
45 <        this.xml = "<packet></packet>";
46 <    }
43 >    /**
44 >     * A reference to the system saxParser factory
45 >     */
46 >    private final SAXParserFactory _factory = SAXParserFactory.newInstance();
47 >    
48 > //---STATIC METHODS---
49  
50 <    // Constructor for accepting XML input.
21 <    public XMLPacketMaker (String xml) {
22 <        this.xml = xml;
23 <    }
50 > //---CONSTRUCTORS---
51  
52 <    public XMLPacket createXMLPacket() {
52 > //---PUBLIC METHODS---
53  
54 +    /**
55 +     * Method to create an XML packet from the data this
56 +     * class was constructed with.
57 +     *
58 +     * @param xml the XML String to parse
59 +     * @return an XMLPacket representing the XML String given
60 +     * @throws InvalidXMLException if the XML cannot be parsed
61 +     */
62 +    public XMLPacket createXMLPacket(String xml) throws InvalidXMLException {
63 +
64          // Create the XMLPacket to store values in.
65          XMLPacket packet = new XMLPacket();
66 <
30 <        // Use the default (non-validating) parser
31 <        SAXParserFactory factory = SAXParserFactory.newInstance();
66 >        
67          try {
33
68              // Parse the input
69              InputSource inputSource = new InputSource(new StringReader(xml));
70 <            SAXParser saxParser = factory.newSAXParser();
37 <            saxParser.parse(inputSource, new XMLStringParser(packet));
38 <
70 >            _factory.newSAXParser().parse(inputSource, new XMLStringParser(packet));
71          }
72          catch (Exception e) {
73 <            System.out.println("XMLPacketMaker - I just received an XML packet that did not contain valid XML.");
74 <            //t.printStackTrace();
43 <            return null;
73 >            // couldn't parse the XML for some reason
74 >            throw new InvalidXMLException("Could not parse the XML: "+xml);
75          }
76          
77 +        // parsed successfully, return the packet
78          return packet;
79      }
80 +
81 +    /**
82 +     * Overrides the {@link java.lang.Object#toString() Object.toString()}
83 +     * method to provide clean logging (every class should have this).
84 +     *
85 +     * This uses the uk.org.iscream.cms.server.util.NameFormat class
86 +     * to format the toString()
87 +     *
88 +     * @return the name of this class and its CVS revision
89 +     */
90 +    public String toString() {
91 +        return FormatName.getName(
92 +            _name,
93 +            getClass().getName(),
94 +            REVISION);
95 +    }
96 +
97 + //---PRIVATE METHODS---
98 +
99 + //---ACCESSOR/MUTATOR METHODS---
100 +
101 + //---ATTRIBUTES---
102      
103 <    String xml;
104 < }
103 >    /**
104 >     * This is the friendly identifier of the
105 >     * component this class is running in.
106 >     * eg, a Filter may be called "filter1",
107 >     * If this class does not have an owning
108 >     * component,  a name from the configuration
109 >     * can be placed here.  This name could also
110 >     * be changed to null for utility classes.
111 >     */
112 >    private String _name = null;
113 >
114 > //---STATIC ATTRIBUTES---
115 >
116 > }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines