propane 2.7.2-java → 2.8.0.pre-java

data/src/main/java/processing/data/XML.java

@@ -0,0 +1,1149 @@
+/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */
+
+/*
+  Part of the Processing project - http://processing.org
+
+  Copyright (c) 2012 The Processing Foundation
+  Copyright (c) 2009-12 Ben Fry and Casey Reas
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation, version 2.
+
+  This library 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 Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General
+  Public License along with this library; if not, write to the
+  Free Software Foundation, Inc., 59 Temple Place, Suite 330,
+  Boston, MA  02111-1307  USA
+*/
+
+package processing.data;
+
+import java.io.*;
+
+import javax.xml.parsers.*;
+
+import org.w3c.dom.*;
+import org.xml.sax.*;
+
+import javax.xml.transform.*;
+import javax.xml.transform.dom.*;
+import javax.xml.transform.stream.*;
+import javax.xml.xpath.XPathConstants;
+import javax.xml.xpath.XPathExpression;
+import javax.xml.xpath.XPathFactory;
+
+import processing.core.PApplet;
+
+
+/**
+ * This is the base class used for the Processing XML library,
+ * representing a single node of an XML tree.
+ *
+ * @webref data:composite
+ * @see PApplet#loadXML(String)
+ * @see PApplet#parseXML(String)
+ * @see PApplet#saveXML(XML, String)
+ */
+public class XML implements Serializable {
+
+  /** The internal representation, a DOM node. */
+  protected Node node;
+
+//  /** Cached locally because it's used often. */
+//  protected String name;
+
+  /** The parent element. */
+  protected XML parent;
+
+  /** Child elements, once loaded. */
+  protected XML[] children;
+
+  /**
+   * @nowebref
+   */
+  protected XML() { }
+
+
+//  /**
+//   * Begin parsing XML data passed in from a PApplet. This code
+//   * wraps exception handling, for more advanced exception handling,
+//   * use the constructor that takes a Reader or InputStream.
+//   *
+//   * @throws SAXException
+//   * @throws ParserConfigurationException
+//   * @throws IOException
+//   */
+//  public XML(PApplet parent, String filename) throws IOException, ParserConfigurationException, SAXException {
+//    this(parent.createReader(filename));
+//  }
+
+
+  /**
+   * Advanced users only; use loadXML() in PApplet. This is not a supported
+   * function and is subject to change. It is available simply for users that
+   * would like to handle the exceptions in a particular way.
+   *
+   * @nowebref
+   */
+  public XML(File file) throws IOException, ParserConfigurationException, SAXException {
+    this(file, null);
+  }
+
+
+  /**
+   * Advanced users only; use loadXML() in PApplet.
+   *
+   * @nowebref
+   */
+  public XML(File file, String options) throws IOException, ParserConfigurationException, SAXException {
+    this(PApplet.createReader(file), options);
+  }
+
+  /**
+   * @nowebref
+   */
+  public XML(InputStream input) throws IOException, ParserConfigurationException, SAXException {
+    this(input, null);
+  }
+
+
+  /**
+   * Unlike the loadXML() method in PApplet, this version works with files
+   * that are not in UTF-8 format.
+   *
+   * @nowebref
+   */
+  public XML(InputStream input, String options) throws IOException, ParserConfigurationException, SAXException {
+    //this(PApplet.createReader(input), options);  // won't handle non-UTF8
+    DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+
+    try {
+      // Prevent 503 errors from www.w3.org
+      factory.setAttribute("http://apache.org/xml/features/nonvalidating/load-external-dtd", false);
+    } catch (IllegalArgumentException e) {
+      // ignore this; Android doesn't like it
+    }
+
+    factory.setExpandEntityReferences(false);
+    DocumentBuilder builder = factory.newDocumentBuilder();
+    Document document = builder.parse(new InputSource(input));
+    node = document.getDocumentElement();
+  }
+
+
+  /**
+   * Advanced users only; use loadXML() in PApplet.
+   *
+   * @nowebref
+   */
+  public XML(Reader reader) throws IOException, ParserConfigurationException, SAXException {
+    this(reader, null);
+  }
+
+
+  /**
+   * Advanced users only; use loadXML() in PApplet.
+   *
+   * Added extra code to handle \u2028 (Unicode NLF), which is sometimes
+   * inserted by web browsers (Safari?) and not distinguishable from a "real"
+   * LF (or CRLF) in some text editors (i.e. TextEdit on OS X). Only doing
+   * this for XML (and not all Reader objects) because LFs are essential.
+   * https://github.com/processing/processing/issues/2100
+   *
+   * @nowebref
+   */
+  public XML(final Reader reader, String options) throws IOException, ParserConfigurationException, SAXException {
+    DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+
+    // Prevent 503 errors from www.w3.org
+    try {
+      factory.setAttribute("http://apache.org/xml/features/nonvalidating/load-external-dtd", false);
+    } catch (IllegalArgumentException e) {
+      // ignore this; Android doesn't like it
+    }
+
+    // without a validating DTD, this doesn't do anything since it doesn't know what is ignorable
+//      factory.setIgnoringElementContentWhitespace(true);
+
+    factory.setExpandEntityReferences(false);
+//      factory.setExpandEntityReferences(true);
+
+//      factory.setCoalescing(true);
+//      builderFactory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
+    DocumentBuilder builder = factory.newDocumentBuilder();
+//      builder.setEntityResolver()
+
+//      SAXParserFactory spf = SAXParserFactory.newInstance();
+//      spf.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
+//      SAXParser p = spf.newSAXParser();
+
+    //    builder = DocumentBuilderFactory.newDocumentBuilder();
+    //    builder = new SAXBuilder();
+    //    builder.setValidation(validating);
+
+    Document document = builder.parse(new InputSource(new Reader() {
+      @Override
+      public int read(char[] cbuf, int off, int len) throws IOException {
+        int count = reader.read(cbuf, off, len);
+        for (int i = 0; i < count; i++) {
+          if (cbuf[off+i] == '\u2028') {
+            cbuf[off+i] = '\n';
+          }
+        }
+        return count;
+      }
+
+      @Override
+      public void close() throws IOException {
+        reader.close();
+      }
+    }));
+    node = document.getDocumentElement();
+  }
+
+
+  /**
+   * @param name creates a node with this name
+   *
+   */
+  public XML(String name) {
+    try {
+      // TODO is there a more efficient way of doing this? wow.
+      DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+      DocumentBuilder builder = factory.newDocumentBuilder();
+      Document document = builder.newDocument();
+      node = document.createElement(name);
+      this.parent = null;
+
+    } catch (ParserConfigurationException pce) {
+      throw new RuntimeException(pce);
+    }
+  }
+
+  /**
+   * @nowebref
+   */
+  protected XML(XML parent, Node node) {
+    this.node = node;
+    this.parent = parent;
+
+    for (String attr : parent.listAttributes()) {
+      if (attr.startsWith("xmlns")) {
+        // Copy namespace attributes to the kids, otherwise this XML
+        // can no longer be printed (or manipulated in most ways).
+        // Only do this when it's an Element, otherwise it's trying to set
+        // attributes on text notes (interstitial content).
+        if (node instanceof Element) {
+          setString(attr, parent.getString(attr));
+        }
+      }
+    }
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Converts String content to an XML object
+   * @param data the content to be parsed as XML
+   * @return an XML object, or null
+   * @throws SAXException
+   * @throws ParserConfigurationException
+   * @throws IOException
+   * @nowebref
+   */
+  static public XML parse(String data) throws IOException, ParserConfigurationException, SAXException {
+    return XML.parse(data, null);
+  }
+
+  /**
+   * @nowebref
+   */
+  static public XML parse(String data, String options) throws IOException, ParserConfigurationException, SAXException {
+    return new XML(new StringReader(data), null);
+  }
+
+
+//  protected boolean save(OutputStream output) {
+//    return write(PApplet.createWriter(output));
+//  }
+
+
+  public boolean save(File file) {
+    return save(file, null);
+  }
+
+
+  public boolean save(File file, String options) {
+    PrintWriter writer = PApplet.createWriter(file);
+    boolean result = write(writer);
+    writer.flush();
+    writer.close();
+    return result;
+  }
+
+
+  // Sends this object and its kids to a Writer with an indent of 2 spaces,
+  // including the declaration at the top so that the output will be valid XML.
+  public boolean write(PrintWriter output) {
+    output.print(format(2));
+    output.flush();
+    return true;
+  }
+
+
+  /**
+   * Returns the parent element. This method returns null for the root
+   * element.
+   *
+   * @webref xml:method
+   * @brief Gets a copy of the element's parent
+   */
+  public XML getParent() {
+    return this.parent;
+  }
+
+  /**
+   * Internal function; not included in reference.
+   */
+  protected Object getNative() {
+    return node;
+  }
+
+
+  /**
+   * Returns the full name (i.e. the name including an eventual namespace
+   * prefix) of the element.
+   *
+   * @webref xml:method
+   * @brief Gets the element's full name
+   * @return the name, or null if the element only contains #PCDATA.
+   */
+  public String getName() {
+//    return name;
+    return node.getNodeName();
+  }
+
+  /**
+   * @webref xml:method
+   * @brief Sets the element's name
+   */
+  public void setName(String newName) {
+    Document document = node.getOwnerDocument();
+    node = document.renameNode(node, null, newName);
+//    name = node.getNodeName();
+  }
+
+
+  /**
+   * Returns the name of the element (without namespace prefix).
+   *
+   * Internal function; not included in reference.
+   */
+  public String getLocalName() {
+    return node.getLocalName();
+  }
+
+
+  /**
+   * Honey, can you just check on the kids? Thanks.
+   *
+   * Internal function; not included in reference.
+   */
+  protected void checkChildren() {
+    if (children == null) {
+      NodeList kids = node.getChildNodes();
+      int childCount = kids.getLength();
+      children = new XML[childCount];
+      for (int i = 0; i < childCount; i++) {
+        children[i] = new XML(this, kids.item(i));
+      }
+    }
+  }
+
+
+  /**
+   * Returns the number of children.
+   *
+   * @webref xml:method
+   * @brief Returns the element's number of children
+   * @return the count.
+   */
+  public int getChildCount() {
+    checkChildren();
+    return children.length;
+  }
+
+
+  /**
+   * Returns a boolean of whether or not there are children.
+   *
+   * @webref xml:method
+   * @brief Checks whether or not an element has any children
+   */
+  public boolean hasChildren() {
+    checkChildren();
+    return children.length > 0;
+  }
+
+
+  /**
+   * Put the names of all children into an array. Same as looping through
+   * each child and calling getName() on each XMLElement.
+   *
+   * @webref xml:method
+   * @brief Returns the names of all children as an array
+   */
+  public String[] listChildren() {
+//    NodeList children = node.getChildNodes();
+//    int childCount = children.getLength();
+//    String[] outgoing = new String[childCount];
+//    for (int i = 0; i < childCount; i++) {
+//      Node kid = children.item(i);
+//      if (kid.getNodeType() == Node.ELEMENT_NODE) {
+//        outgoing[i] = kid.getNodeName();
+//      } // otherwise just leave him null
+//    }
+    checkChildren();
+    String[] outgoing = new String[children.length];
+    for (int i = 0; i < children.length; i++) {
+      outgoing[i] = children[i].getName();
+    }
+    return outgoing;
+  }
+
+
+  /**
+   * Returns an array containing all the child elements.
+   *
+   * @webref xml:method
+   * @brief Returns an array containing all child elements
+   */
+  public XML[] getChildren() {
+//    NodeList children = node.getChildNodes();
+//    int childCount = children.getLength();
+//    XMLElement[] kids = new XMLElement[childCount];
+//    for (int i = 0; i < childCount; i++) {
+//      Node kid = children.item(i);
+//      kids[i] = new XMLElement(this, kid);
+//    }
+//    return kids;
+    checkChildren();
+    return children;
+  }
+
+
+  /**
+   * Quick accessor for an element at a particular index.
+   *
+   * @webref xml:method
+   * @brief Returns the child element with the specified index value or path
+   */
+  public XML getChild(int index) {
+    checkChildren();
+    return children[index];
+  }
+
+
+  /**
+   * Get a child by its name or path.
+   *
+   * @param name element name or path/to/element
+   * @return the first matching element or null if no match
+   */
+  public XML getChild(String name) {
+    if (name.length() > 0 && name.charAt(0) == '/') {
+      throw new IllegalArgumentException("getChild() should not begin with a slash");
+    }
+    if (name.indexOf('/') != -1) {
+      return getChildRecursive(PApplet.split(name, '/'), 0);
+    }
+    int childCount = getChildCount();
+    for (int i = 0; i < childCount; i++) {
+      XML kid = getChild(i);
+      String kidName = kid.getName();
+      if (kidName != null && kidName.equals(name)) {
+        return kid;
+      }
+    }
+    return null;
+  }
+
+
+  /**
+   * Internal helper function for getChild(String).
+   *
+   * @param items result of splitting the query on slashes
+   * @param offset where in the items[] array we're currently looking
+   * @return matching element or null if no match
+   * @author processing.org
+   */
+  protected XML getChildRecursive(String[] items, int offset) {
+    // if it's a number, do an index instead
+    if (Character.isDigit(items[offset].charAt(0))) {
+      XML kid = getChild(Integer.parseInt(items[offset]));
+      if (offset == items.length-1) {
+        return kid;
+      } else {
+        return kid.getChildRecursive(items, offset+1);
+      }
+    }
+    int childCount = getChildCount();
+    for (int i = 0; i < childCount; i++) {
+      XML kid = getChild(i);
+      String kidName = kid.getName();
+      if (kidName != null && kidName.equals(items[offset])) {
+        if (offset == items.length-1) {
+          return kid;
+        } else {
+          return kid.getChildRecursive(items, offset+1);
+        }
+      }
+    }
+    return null;
+  }
+
+
+  /**
+   * Get any children that match this name or path. Similar to getChild(),
+   * but will grab multiple matches rather than only the first.
+   *
+   * @param name element name or path/to/element
+   * @return array of child elements that match
+   * @author processing.org
+   */
+  public XML[] getChildren(String name) {
+    if (name.length() > 0 && name.charAt(0) == '/') {
+      throw new IllegalArgumentException("getChildren() should not begin with a slash");
+    }
+    if (name.indexOf('/') != -1) {
+      return getChildrenRecursive(PApplet.split(name, '/'), 0);
+    }
+    // if it's a number, do an index instead
+    // (returns a single element array, since this will be a single match
+    if (Character.isDigit(name.charAt(0))) {
+      return new XML[] { getChild(Integer.parseInt(name)) };
+    }
+    int childCount = getChildCount();
+    XML[] matches = new XML[childCount];
+    int matchCount = 0;
+    for (int i = 0; i < childCount; i++) {
+      XML kid = getChild(i);
+      String kidName = kid.getName();
+      if (kidName != null && kidName.equals(name)) {
+        matches[matchCount++] = kid;
+      }
+    }
+    return (XML[]) PApplet.subset(matches, 0, matchCount);
+  }
+
+
+  protected XML[] getChildrenRecursive(String[] items, int offset) {
+    if (offset == items.length-1) {
+      return getChildren(items[offset]);
+    }
+    XML[] matches = getChildren(items[offset]);
+    XML[] outgoing = new XML[0];
+    for (int i = 0; i < matches.length; i++) {
+      XML[] kidMatches = matches[i].getChildrenRecursive(items, offset+1);
+      outgoing = (XML[]) PApplet.concat(outgoing, kidMatches);
+    }
+    return outgoing;
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Appends a new child to the element
+   */
+  public XML addChild(String tag) {
+    Document document = node.getOwnerDocument();
+    Node newChild = document.createElement(tag);
+    return appendChild(newChild);
+  }
+
+
+  public XML addChild(XML child) {
+    Document document = node.getOwnerDocument();
+    Node newChild = document.importNode((Node) child.getNative(), true);
+    return appendChild(newChild);
+  }
+
+
+  /** Internal handler to add the node structure. */
+  protected XML appendChild(Node newNode) {
+    node.appendChild(newNode);
+    XML newbie = new XML(this, newNode);
+    if (children != null) {
+      children = (XML[]) PApplet.concat(children, new XML[] { newbie });
+    }
+    return newbie;
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Removes the specified child
+   */
+  public void removeChild(XML kid) {
+    node.removeChild(kid.node);
+    children = null;  // TODO not efficient
+  }
+
+
+  public void trim() {
+    try {
+      XPathFactory xpathFactory = XPathFactory.newInstance();
+      XPathExpression xpathExp =
+        xpathFactory.newXPath().compile("//text()[normalize-space(.) = '']");
+      NodeList emptyTextNodes = (NodeList)
+        xpathExp.evaluate(node, XPathConstants.NODESET);
+
+      // Remove each empty text node from document.
+      for (int i = 0; i < emptyTextNodes.getLength(); i++) {
+        Node emptyTextNode = emptyTextNodes.item(i);
+        emptyTextNode.getParentNode().removeChild(emptyTextNode);
+      }
+    } catch (Exception e) {
+      throw new RuntimeException(e);
+    }
+  }
+
+
+//  /** Remove whitespace nodes. */
+//  public void trim() {
+//////    public static boolean isWhitespace(XML xml) {
+//////      if (xml.node.getNodeType() != Node.TEXT_NODE)
+//////        return false;
+//////      Matcher m = whitespace.matcher(xml.node.getNodeValue());
+//////      return m.matches();
+//////    }
+////    trim(this);
+////  }
+//
+//    checkChildren();
+//    int index = 0;
+//    for (int i = 0; i < children.length; i++) {
+//      if (i != index) {
+//        children[index] = children[i];
+//      }
+//      Node childNode = (Node) children[i].getNative();
+//      if (childNode.getNodeType() != Node.TEXT_NODE ||
+//          children[i].getContent().trim().length() > 0) {
+//        children[i].trim();
+//        index++;
+//      }
+//    }
+//    if (index != children.length) {
+//      children = (XML[]) PApplet.subset(children, 0, index);
+//    }
+//
+//    // possibility, but would have to re-parse the object
+//// helpdesk.objects.com.au/java/how-do-i-remove-whitespace-from-an-xml-document
+////    TransformerFactory factory = TransformerFactory.newInstance();
+////    Transformer transformer = factory.newTransformer(new StreamSource("strip-space.xsl"));
+////    DOMSource source = new DOMSource(document);
+////    StreamResult result = new StreamResult(System.out);
+////    transformer.transform(source, result);
+//
+////    <xsl:stylesheet version="1.0"
+////      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+////   <xsl:output method="xml" omit-xml-declaration="yes"/>
+////     <xsl:strip-space elements="*"/>
+////     <xsl:template match="@*|node()">
+////      <xsl:copy>
+////       <xsl:apply-templates select="@*|node()"/>
+////      </xsl:copy>
+////     </xsl:template>
+////   </xsl:stylesheet>
+//  }
+
+
+  /**
+   * Returns the number of attributes.
+   *
+   * @webref xml:method
+   * @brief Counts the specified element's number of attributes
+   */
+  public int getAttributeCount() {
+    return node.getAttributes().getLength();
+  }
+
+
+  /**
+   * Get a list of the names for all of the attributes for this node.
+   *
+   * @webref xml:method
+   * @brief Returns a list of names of all attributes as an array
+   */
+  public String[] listAttributes() {
+    NamedNodeMap nnm = node.getAttributes();
+    String[] outgoing = new String[nnm.getLength()];
+    for (int i = 0; i < outgoing.length; i++) {
+      outgoing[i] = nnm.item(i).getNodeName();
+    }
+    return outgoing;
+  }
+
+  /**
+   * Returns whether an attribute exists.
+   *
+   * @webref xml:method
+   * @brief Checks whether or not an element has the specified attribute
+   */
+  public boolean hasAttribute(String name) {
+    return (node.getAttributes().getNamedItem(name) != null);
+  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null name of the attribute.
+   * @return the value, or null if the attribute does not exist.
+   */
+//  public String getAttribute(String name) {
+//    return this.getAttribute(name, null);
+//  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null full name of the attribute.
+   * @param defaultValue the default value of the attribute.
+   * @return the value, or defaultValue if the attribute does not exist.
+   */
+//  public String getAttribute(String name, String defaultValue) {
+//    Node attr = node.getAttributes().getNamedItem(name);
+//    return (attr == null) ? defaultValue : attr.getNodeValue();
+//  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Gets the content of an attribute as a String
+   */
+  public String getString(String name) {
+    return getString(name, null);
+  }
+
+
+  public String getString(String name, String defaultValue) {
+    NamedNodeMap attrs = node.getAttributes();
+    if (attrs != null) {
+      Node attr = attrs.getNamedItem(name);
+      if (attr != null) {
+        return attr.getNodeValue();
+      }
+    }
+    return defaultValue;
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Sets the content of an attribute as a String
+   */
+  public void setString(String name, String value) {
+    ((Element) node).setAttribute(name, value);
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Gets the content of an attribute as an int
+   */
+  public int getInt(String name) {
+    return getInt(name, 0);
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Sets the content of an attribute as an int
+   */
+  public void setInt(String name, int value) {
+    setString(name, String.valueOf(value));
+  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null full name of the attribute
+   * @param defaultValue the default value of the attribute
+   * @return the value, or defaultValue if the attribute does not exist
+   */
+  public int getInt(String name, int defaultValue) {
+    String value = getString(name);
+    return (value == null) ? defaultValue : Integer.parseInt(value);
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Sets the content of an element as an int
+   */
+  public void setLong(String name, long value) {
+    setString(name, String.valueOf(value));
+  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null full name of the attribute.
+   * @param defaultValue the default value of the attribute.
+   * @return the value, or defaultValue if the attribute does not exist.
+   */
+  public long getLong(String name, long defaultValue) {
+    String value = getString(name);
+    return (value == null) ? defaultValue : Long.parseLong(value);
+  }
+
+
+  /**
+   * Returns the value of an attribute, or zero if not present.
+   *
+   * @webref xml:method
+   * @brief Gets the content of an attribute as a float
+   */
+  public float getFloat(String name) {
+    return getFloat(name, 0);
+  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null full name of the attribute.
+   * @param defaultValue the default value of the attribute.
+   * @return the value, or defaultValue if the attribute does not exist.
+   */
+  public float getFloat(String name, float defaultValue) {
+    String value = getString(name);
+    return (value == null) ? defaultValue : Float.parseFloat(value);
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Sets the content of an attribute as a float
+   */
+  public void setFloat(String name, float value) {
+    setString(name, String.valueOf(value));
+  }
+
+
+  public double getDouble(String name) {
+    return getDouble(name, 0);
+  }
+
+
+  /**
+   * Returns the value of an attribute.
+   *
+   * @param name the non-null full name of the attribute
+   * @param defaultValue the default value of the attribute
+   * @return the value, or defaultValue if the attribute does not exist
+   */
+  public double getDouble(String name, double defaultValue) {
+    String value = getString(name);
+    return (value == null) ? defaultValue : Double.parseDouble(value);
+  }
+
+
+  public void setDouble(String name, double value) {
+    setString(name, String.valueOf(value));
+  }
+
+
+  /**
+   * Return the #PCDATA content of the element. If the element has a
+   * combination of #PCDATA content and child elements, the #PCDATA
+   * sections can be retrieved as unnamed child objects. In this case,
+   * this method returns null.
+   *
+   * @webref xml:method
+   * @brief Gets the content of an element
+   * @return the content.
+   * @see XML#getIntContent()
+   * @see XML#getFloatContent()
+   */
+  public String getContent() {
+    return node.getTextContent();
+  }
+
+
+  public String getContent(String defaultValue) {
+    String s = node.getTextContent();
+    return (s != null) ? s : defaultValue;
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Gets the content of an element as an int
+   * @return the content.
+   * @see XML#getContent()
+   * @see XML#getFloatContent()
+   */
+  public int getIntContent() {
+    return getIntContent(0);
+  }
+
+
+  /**
+   * @param defaultValue the default value of the attribute
+   */
+  public int getIntContent(int defaultValue) {
+    return PApplet.parseInt(node.getTextContent(), defaultValue);
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Gets the content of an element as a float
+   * @return the content.
+   * @see XML#getContent()
+   * @see XML#getIntContent()
+   */
+  public float getFloatContent() {
+    return getFloatContent(0);
+  }
+
+
+  /**
+   * @param defaultValue the default value of the attribute
+   */
+  public float getFloatContent(float defaultValue) {
+    return PApplet.parseFloat(node.getTextContent(), defaultValue);
+  }
+
+
+  public long getLongContent() {
+    return getLongContent(0);
+  }
+
+
+  public long getLongContent(long defaultValue) {
+    String c = node.getTextContent();
+    if (c != null) {
+      try {
+        return Long.parseLong(c);
+      } catch (NumberFormatException nfe) { }
+    }
+    return defaultValue;
+  }
+
+
+  public double getDoubleContent() {
+    return getDoubleContent(0);
+  }
+
+
+  public double getDoubleContent(double defaultValue) {
+    String c = node.getTextContent();
+    if (c != null) {
+      try {
+        return Double.parseDouble(c);
+      } catch (NumberFormatException nfe) { }
+    }
+    return defaultValue;
+  }
+
+
+  /**
+   * @webref xml:method
+   * @brief Sets the content of an element
+   */
+  public void setContent(String text) {
+    node.setTextContent(text);
+  }
+
+
+  public void setIntContent(int value) {
+    setContent(String.valueOf(value));
+  }
+
+
+  public void setFloatContent(float value) {
+    setContent(String.valueOf(value));
+  }
+
+
+  public void setLongContent(long value) {
+    setContent(String.valueOf(value));
+  }
+
+
+  public void setDoubleContent(double value) {
+    setContent(String.valueOf(value));
+  }
+
+
+  /**
+   * Format this XML data as a String.
+   *
+   * @webref xml:method
+   * @brief Formats XML data as a String
+   * @param indent -1 for a single line (and no declaration), >= 0 for indents and newlines
+   * @return the content
+   * @see XML#toString()
+   */
+  public String format(int indent) {
+    try {
+      // entities = doctype.getEntities()
+      boolean useIndentAmount = false;
+      TransformerFactory factory = TransformerFactory.newInstance();
+      if (indent != -1) {
+        try {
+          factory.setAttribute("indent-number", indent);
+        } catch (IllegalArgumentException e) {
+          useIndentAmount = true;
+        }
+      }
+      Transformer transformer = factory.newTransformer();
+
+      // Add the XML declaration at the top if this node is the root and we're
+      // not writing to a single line (indent = -1 means single line).
+      if (indent == -1 || parent == null) {
+        transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes");
+      } else {
+        transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "no");
+      }
+
+//      transformer.setOutputProperty(OutputKeys.DOCTYPE_SYSTEM, "sample.dtd");
+
+      transformer.setOutputProperty(OutputKeys.METHOD, "xml");
+
+//      transformer.setOutputProperty(OutputKeys.CDATA_SECTION_ELEMENTS, "yes");  // huh?
+
+//      transformer.setOutputProperty(OutputKeys.DOCTYPE_PUBLIC,
+//          "-//W3C//DTD XHTML 1.0 Transitional//EN");
+//      transformer.setOutputProperty(OutputKeys.DOCTYPE_SYSTEM,
+//          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd");
+
+      // For Android, because (at least 2.3.3) doesn't like indent-number
+      if (useIndentAmount) {
+        transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", String.valueOf(indent));
+      }
+
+//      transformer.setOutputProperty(OutputKeys.ENCODING,"ISO-8859-1");
+//      transformer.setOutputProperty(OutputKeys.ENCODING,"UTF8");
+      transformer.setOutputProperty(OutputKeys.ENCODING,"UTF-8");
+//      transformer.setOutputProperty(OutputKeys.CDATA_SECTION_ELEMENTS
+
+      // Always indent, otherwise the XML declaration will just be jammed
+      // onto the first line with the XML code as well.
+      transformer.setOutputProperty(OutputKeys.INDENT, "yes");
+
+//      Properties p = transformer.getOutputProperties();
+//      for (Object key : p.keySet()) {
+//        System.out.println(key + " -> " + p.get(key));
+//      }
+
+      // If you smell something, that's because this code stinks. No matter
+      // the settings of the Transformer object, if the XML document already
+      // has whitespace elements, it won't bother re-indenting/re-formatting.
+      // So instead, transform the data once into a single line string.
+      // If indent is -1, then we're done. Otherwise re-run and the settings
+      // of the factory will kick in. If you know a better way to do this,
+      // please contribute. I've wasted too much of my Sunday on it. But at
+      // least the Giants are getting blown out by the Falcons.
+
+      final String decl = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>";
+      final String sep = System.getProperty("line.separator");
+
+      StringWriter tempWriter = new StringWriter();
+      StreamResult tempResult = new StreamResult(tempWriter);
+      transformer.transform(new DOMSource(node), tempResult);
+      String[] tempLines = PApplet.split(tempWriter.toString(), sep);
+//      PApplet.println(tempLines);
+      if (tempLines[0].startsWith("<?xml")) {
+        // Remove XML declaration from the top before slamming into one line
+        int declEnd = tempLines[0].indexOf("?>") + 2;
+        //if (tempLines[0].length() == decl.length()) {
+        if (tempLines[0].length() == declEnd) {
+          // If it's all the XML declaration, remove it
+//          PApplet.println("removing first line");
+          tempLines = PApplet.subset(tempLines, 1);
+        } else {
+//          PApplet.println("removing part of first line");
+          // If the first node has been moved to this line, be more careful
+          //tempLines[0] = tempLines[0].substring(decl.length());
+          tempLines[0] = tempLines[0].substring(declEnd);
+        }
+      }
+      String singleLine = PApplet.join(PApplet.trim(tempLines), "");
+      if (indent == -1) {
+        return singleLine;
+      }
+
+      // Might just be whitespace, which won't be valid XML for parsing below.
+      // https://github.com/processing/processing/issues/1796
+      // Since indent is not -1, that means they want valid XML,
+      // so we'll give them the single line plus the decl... Lame? sure.
+      if (singleLine.trim().length() == 0) {
+        // You want whitespace? I've got your whitespace right here.
+        return decl + sep + singleLine;
+      }
+
+      // Since the indent is not -1, bring back the XML declaration
+      //transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "no");
+
+      StringWriter stringWriter = new StringWriter();
+      StreamResult xmlOutput = new StreamResult(stringWriter);
+//      DOMSource source = new DOMSource(node);
+      Source source = new StreamSource(new StringReader(singleLine));
+      transformer.transform(source, xmlOutput);
+      String outgoing = stringWriter.toString();
+
+      // Add the XML declaration to the top if it's not there already
+      if (outgoing.startsWith(decl)) {
+        int declen = decl.length();
+        int seplen = sep.length();
+        if (outgoing.length() > declen + seplen &&
+            !outgoing.substring(declen, declen + seplen).equals(sep)) {
+          // make sure there's a line break between the XML decl and the code
+          return outgoing.substring(0, decl.length()) +
+            sep + outgoing.substring(decl.length());
+        }
+        return outgoing;
+      } else {
+        return decl + sep + outgoing;
+      }
+
+    } catch (Exception e) {
+      e.printStackTrace();
+    }
+    return null;
+  }
+
+
+  public void print() {
+    PApplet.println(format(2));
+  }
+
+
+  /**
+   * Return the XML document formatted with two spaces for indents.
+   * Chosen to do this since it's the most common case (e.g. with println()).
+   * Same as format(2). Use the format() function for more options.
+   *
+   * @webref xml:method
+   * @brief Gets XML data as a String using default formatting
+   * @return the content
+   * @see XML#format(int)
+   */
+  @Override
+  public String toString() {
+    //return format(2);
+    return format(-1);
+  }
+}