--- projects/cms/source/util/uk/org/iscream/cms/util/XMLPacketMaker.java	2000/11/23 09:36:07	1.2
+++ projects/cms/source/util/uk/org/iscream/cms/util/XMLPacketMaker.java	2001/01/28 05:47:05	1.9
@@ -1,25 +1,51 @@
+//---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;
 
-import uk.ac.ukc.iscream.core.*;
+/**
+ * XMLPacketMaker - Creates an XMLPacket object.
+ *
+ * @author  $Author: tdb $
+ * @version $Id: XMLPacketMaker.java,v 1.9 2001/01/28 05:47:05 tdb Exp $
+ */
+public class XMLPacketMaker extends HandlerBase {
 
-// Paul Mutton, pjm2@ukc.ac.uk
+//---FINAL ATTRIBUTES---
 
-// XMLPacketMaker - Creates an XMLPacket object.
-public class XMLPacketMaker extends HandlerBase {
+    /**
+     * The current CVS revision of this class
+     */
+    public final String REVISION = "$Revision: 1.9 $";
+    
+//---STATIC METHODS---
 
-    // Constructor for accepting XML input.
-    public XMLPacketMaker (String xml, Logger logger) {
-        this.xml = xml;
-        this.logger = logger;
+//---CONSTRUCTORS---
+
+    /**
+     * Constructor for accepting XML input.
+     *
+     * @param xml A String of XML to process.
+     */
+    public XMLPacketMaker (String xml) {
+        _xml = xml;
     }
 
+//---PUBLIC METHODS---
+
+    /**
+     * Method to create an XML packet from the data this
+     * class was constructed with.
+     *
+     * @return an XMLPacket representing the XML String given
+     */
     public XMLPacket createXMLPacket() {
 
         // Create the XMLPacket to store values in.
@@ -30,20 +56,56 @@ public class XMLPacketMaker extends HandlerBase {
         try {
 
             // Parse the input
-            InputSource inputSource = new InputSource(new StringReader(xml));
+            InputSource inputSource = new InputSource(new StringReader(_xml));
             SAXParser saxParser = factory.newSAXParser();
             saxParser.parse(inputSource, new XMLStringParser(packet));
 
         }
         catch (Exception e) {
-            logger.write(this.toString(), Logger.WARNING, "An invalid XML UDP packet has been detected: "+packet.printAll());
-            //t.printStackTrace();
             return null;
         }
         
         return packet;
     }
+
+    /**
+     * 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---
+
+//---ACCESSOR/MUTATOR METHODS---
+
+//---ATTRIBUTES---
+
+    /**
+     * Holds the xml
+     */
+    String _xml;
     
-    String xml;
-    Logger logger;
-}
\ No newline at end of file
+    /**
+     * 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---
+
+}