gov/nasa/worldwind/formats/gpx/ElementParser.java

   1 /*
   2 Copyright (C) 2001, 2006 United States Government
   3 as represented by the Administrator of the
   4 National Aeronautics and Space Administration.
   5 All Rights Reserved.
   6 */
   7 package gov.nasa.worldwind.formats.gpx;
   8
   9 import gov.nasa.worldwind.util.Logging;
  10
  11 /**
  12  * @author tag
  13  * @version $Id: ElementParser.java 2471 2007-07-31 21:50:57Z tgaskins $
  14  */
  15 public class ElementParser
  16 {
  17     protected final String elementName;
  18     protected ElementParser currentElement = null;
  19     protected String currentCharacters = null;
  20
  21     /**
  22      * @param elementName the element's name, may not be null
  23      * @throws IllegalArgumentException if <code>elementName</code> is null
  24      */
  25     protected ElementParser(String elementName)
  26     {
  27         if (elementName == null)
  28         {
  29             String msg = Logging.getMessage("nullValue.ElementNameIsNull");
  30             Logging.logger().severe(msg);
  31             throw new IllegalArgumentException(msg);
  32         }
  33
  34         this.elementName = elementName;
  35     }
  36
  37     public String getElementName()
  38     {
  39         return this.elementName;
  40     }
  41
  42     /**
  43      * Starts an element. No parameters may be null.
  44      *
  45      * @param uri
  46      * @param lname
  47      * @param qname
  48      * @param attributes
  49      * @throws org.xml.sax.SAXException
  50      * @throws IllegalArgumentException if any argument is null
  51      */
  52     public void startElement(String uri, String lname, String qname, org.xml.sax.Attributes attributes)
  53         throws org.xml.sax.SAXException
  54     {
  55         if (uri == null)
  56         {
  57             String msg = Logging.getMessage("nullValue.URIIsNull");
  58             Logging.logger().severe(msg);
  59             throw new IllegalArgumentException(msg);
  60         }
  61         if (lname == null)
  62         {
  63             String msg = Logging.getMessage("nullValue.LNameIsNull");
  64             Logging.logger().severe(msg);
  65             throw new IllegalArgumentException(msg);
  66         }
  67         if (qname == null)
  68         {
  69             String msg = Logging.getMessage("nullValue.QNameIsNull");
  70             Logging.logger().severe(msg);
  71             throw new IllegalArgumentException(msg);
  72         }
  73         if (attributes == null)
  74         {
  75             String msg = Logging.getMessage("nullValue.org.xml.sax.AttributesIsNull");
  76             Logging.logger().severe(msg);
  77             throw new IllegalArgumentException(msg);
  78         }
  79
  80         if (this.currentElement != null)
  81             this.currentElement.startElement(uri, lname, qname, attributes);
  82         else
  83             this.doStartElement(uri, lname, qname, attributes);
  84     }
  85
  86     /**
  87      * Finishes an element. No parameters may be null.
  88      *
  89      * @param uri
  90      * @param lname
  91      * @param qname
  92      * @throws org.xml.sax.SAXException
  93      * @throws IllegalArgumentException if any argument is null
  94      */
  95     public void endElement(String uri, String lname, String qname) throws org.xml.sax.SAXException
  96     {
  97         if (uri == null)
  98         {
  99             String msg = Logging.getMessage("nullValue.URIIsNull");
 100             Logging.logger().severe(msg);
 101             throw new IllegalArgumentException(msg);
 102         }
 103         if (lname == null)
 104         {
 105             String msg = Logging.getMessage("nullValue.LNameIsNull");
 106             Logging.logger().severe(msg);
 107             throw new IllegalArgumentException(msg);
 108         }
 109         if (qname == null)
 110         {
 111             String msg = Logging.getMessage("nullValue.QNameIsNull");
 112             Logging.logger().severe(msg);
 113             throw new IllegalArgumentException(msg);
 114         }
 115         if (this.currentElement != null)
 116         {
 117             this.currentElement.endElement(uri, lname, qname);
 118             if (lname.equalsIgnoreCase(this.currentElement.elementName))
 119                 this.currentElement = null;
 120         }
 121
 122         this.doEndElement(uri, lname, qname);
 123
 124         this.currentCharacters = null;
 125     }
 126
 127     protected void doStartElement(String uri, String lname, String qname, org.xml.sax.Attributes attributes)
 128         throws org.xml.sax.SAXException
 129     {
 130     }
 131
 132     protected void doEndElement(String uri, String lname, String qname) throws org.xml.sax.SAXException
 133     {
 134     }
 135
 136     /**
 137      * @param data
 138      * @param start
 139      * @param length
 140      * @throws IllegalArgumentException if <code>data</code> has length less than 1
 141      */
 142     public void characters(char[] data, int start, int length)
 143     {
 144         if (data == null)
 145         {
 146             String msg = Logging.getMessage("nullValue.ArrayIsNull");
 147             Logging.logger().severe(msg);
 148             throw new IllegalArgumentException(msg);
 149         }
 150         if (data.length < 1)
 151         {
 152             String msg = Logging.getMessage("generic.ArrayInvalidLength", data.length);
 153             Logging.logger().severe(msg);
 154             throw new IllegalArgumentException(msg);
 155         }
 156         if (start < 0)
 157         {
 158             String msg = Logging.getMessage("generic.indexOutOfRange", start);
 159             Logging.logger().severe(msg);
 160             throw new IllegalArgumentException(msg);
 161         }
 162         if (start + length > data.length)
 163         {
 164             String msg = Logging.getMessage("generic.indexOutOfRange", start + length);
 165             Logging.logger().severe(msg);
 166             throw new IllegalArgumentException(msg);
 167         }
 168
 169         if (this.currentElement != null)
 170             this.currentElement.characters(data, start, length);
 171         else if (this.currentCharacters != null)
 172             this.currentCharacters += new String(data, start, length);
 173         else
 174             this.currentCharacters = new String(data, start, length);
 175     }
 176 }