Merge branch 'master' of https://source.jalview.org/git/jalviewjs.git
[jalviewjs.git] / src / javajs / util / XmlUtil.java
index fd3e37a..d2194cd 100644 (file)
-/* $RCSfile$\r
- * $Author$\r
- * $Date$\r
- * $Revision$\r
- *\r
- * Copyright (C) 2006  The Jmol Development Team\r
- *\r
- * Contact: jmol-developers@lists.sf.net\r
- *\r
- *  This library is free software; you can redistribute it and/or\r
- *  modify it under the terms of the GNU Lesser General Public\r
- *  License as published by the Free Software Foundation; either\r
- *  version 2.1 of the License, or (at your option) any later version.\r
- *\r
- *  This library is distributed in the hope that it will be useful,\r
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of\r
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\r
- *  Lesser General Public License for more details.\r
- *\r
- *  You should have received a copy of the GNU Lesser General Public\r
- *  License along with this library; if not, write to the Free Software\r
- *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA\r
- *  02110-1301, USA.\r
- */\r
-\r
-package javajs.util;\r
-\r
-public class XmlUtil {\r
-\r
-  public XmlUtil() {\r
-    // Jmol's PropertyManager class uses reflection \r
-  }\r
-  // / simple Xml parser/generator ///\r
-\r
-  public static void openDocument(SB data) {\r
-    data.append("<?xml version=\"1.0\"?>\n");\r
-  }\r
-\r
-  public static void openTag(SB sb, String name) {\r
-    sb.append("<").append(name).append(">\n");\r
-  }\r
-\r
-  public static void openTagAttr(SB sb, String name, Object[] attributes) {\r
-    appendTagAll(sb, name, attributes, null, false, false);\r
-    sb.append("\n");\r
-  }\r
-\r
-  public static void closeTag(SB sb, String name) {\r
-    sb.append("</").append(name).append(">\n");\r
-  }\r
-\r
-  public static void appendTagAll(SB sb, String name,\r
-                               Object[] attributes, Object data,\r
-                               boolean isCdata, boolean doClose) {\r
-    String closer = ">";\r
-    if (name.endsWith("/")){\r
-      name = name.substring(0, name.length() - 1);\r
-      if (data == null) {\r
-        closer = "/>\n";\r
-        doClose = false;\r
-      }\r
-    }\r
-    sb.append("<").append(name);\r
-    if (attributes != null)\r
-      for (int i = 0; i < attributes.length; i++) {\r
-        Object o = attributes[i];\r
-        if (o == null)\r
-          continue;\r
-        if (o instanceof Object[])\r
-          for (int j = 0; j < ((Object[]) o).length; j+= 2)\r
-          appendAttrib(sb, ((Object[]) o)[j], ((Object[]) o)[j + 1]);\r
-        else\r
-          appendAttrib(sb, o, attributes[++i]);\r
-      }\r
-    sb.append(closer);\r
-    if (data != null) {\r
-      if (isCdata)\r
-        data = wrapCdata(data);\r
-      sb.appendO(data);\r
-    }\r
-    if (doClose)\r
-      closeTag(sb, name);\r
-  }\r
-\r
-  /**\r
-   * wrap the string as character data, with replacements for [ noted \r
-   * as a list starting with * after the CDATA termination\r
-   * \r
-   * @param data\r
-   * @return      wrapped text\r
-   */\r
-  public static String wrapCdata(Object data) {\r
-    String s = "" + data;\r
-    return (s.indexOf("&") < 0 && s.indexOf("<") < 0 ? (s.startsWith("\n") ? "" : "\n") + s \r
-        : "<![CDATA[" + PT.rep(s, "]]>", "]]]]><![CDATA[>") + "]]>");\r
-  }\r
-  \r
-  /**\r
-   * @param s\r
-   * @return   unwrapped text\r
-   */\r
-  public static String unwrapCdata(String s) {\r
-    return (s.startsWith("<![CDATA[") && s.endsWith("]]>") ?\r
-        PT.rep(s.substring(9, s.length()-3),"]]]]><![CDATA[>", "]]>") : s);\r
-  }\r
-  \r
-  /**\r
-   * standard <name attr="..." attr="...">data</name>"\r
-   * \r
-   * @param sb\r
-   * @param name\r
-   * @param attributes\r
-   * @param data\r
-   */\r
-  public static void appendTagObj(SB sb, String name,\r
-                               Object[] attributes, Object data) {\r
-    appendTagAll(sb, name, attributes, data, false, true);\r
-  }\r
-\r
-  /**\r
-   * standard <name>data</name>"\r
-   * standard <name attr="..." attr="..."></name>"\r
-   * \r
-   * @param sb\r
-   * @param name\r
-   * @param data\r
-   */\r
-  public static void appendTag(SB sb, String name, Object data) {\r
-    if (data instanceof Object[])\r
-      appendTagAll(sb, name, (Object[]) data, null, false, true);\r
-    else\r
-      appendTagAll(sb, name, null, data, false, true);\r
-  }\r
-\r
-  /**\r
-   * <name><![CDATA[data]]></name>"\r
-   * \r
-   * will convert ]]> to ]] >\r
-   * \r
-   * @param sb\r
-   * @param name\r
-   * @param attributes \r
-   * @param data\r
-   */\r
-  public static void appendCdata(SB sb, String name, \r
-                                 Object[] attributes, String data) {\r
-    appendTagAll(sb, name, attributes, data, true, true);\r
-  }\r
-\r
-  /**\r
-   * \r
-   * @param sb\r
-   * @param name\r
-   * @param value\r
-   */\r
-  public static void appendAttrib(SB sb, Object name, Object value) {\r
-    if (value == null)\r
-      return;\r
-    \r
-    // note: <&" are disallowed but not checked for here\r
-    \r
-    sb.append(" ").appendO(name).append("=\"").appendO(value).append("\"");\r
-  }\r
-\r
-}\r
+/* $RCSfile$
+ * $Author$
+ * $Date$
+ * $Revision$
+ *
+ * Copyright (C) 2006  The Jmol Development Team
+ *
+ * Contact: jmol-developers@lists.sf.net
+ *
+ *  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; either
+ *  version 2.1 of the License, or (at your option) any later version.
+ *
+ *  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., 51 Franklin Street, Fifth Floor, Boston, MA
+ *  02110-1301, USA.
+ */
+
+package javajs.util;
+
+public class XmlUtil {
+
+  public XmlUtil() {
+    // Jmol's PropertyManager class uses reflection 
+  }
+  // / simple Xml parser/generator ///
+
+  public static void openDocument(SB data) {
+    data.append("<?xml version=\"1.0\"?>\n");
+  }
+
+  public static void openTag(SB sb, String name) {
+    sb.append("<").append(name).append(">\n");
+  }
+
+  public static void openTagAttr(SB sb, String name, Object[] attributes) {
+    appendTagAll(sb, name, attributes, null, false, false);
+    sb.append("\n");
+  }
+
+  public static void closeTag(SB sb, String name) {
+    sb.append("</").append(name).append(">\n");
+  }
+
+  public static void appendTagAll(SB sb, String name,
+                               Object[] attributes, Object data,
+                               boolean isCdata, boolean doClose) {
+    String closer = ">";
+    if (name.endsWith("/")){
+      name = name.substring(0, name.length() - 1);
+      if (data == null) {
+        closer = "/>\n";
+        doClose = false;
+      }
+    }
+    sb.append("<").append(name);
+    if (attributes != null)
+      for (int i = 0; i < attributes.length; i++) {
+        Object o = attributes[i];
+        if (o == null)
+          continue;
+        if (o instanceof Object[])
+          for (int j = 0; j < ((Object[]) o).length; j+= 2)
+          appendAttrib(sb, ((Object[]) o)[j], ((Object[]) o)[j + 1]);
+        else
+          appendAttrib(sb, o, attributes[++i]);
+      }
+    sb.append(closer);
+    if (data != null) {
+      if (isCdata)
+        data = wrapCdata(data);
+      sb.appendO(data);
+    }
+    if (doClose)
+      closeTag(sb, name);
+  }
+
+  /**
+   * wrap the string as character data, with replacements for [ noted 
+   * as a list starting with * after the CDATA termination
+   * 
+   * @param data
+   * @return      wrapped text
+   */
+  public static String wrapCdata(Object data) {
+    String s = "" + data;
+    return (s.indexOf("&") < 0 && s.indexOf("<") < 0 ? (s.startsWith("\n") ? "" : "\n") + s 
+        : "<![CDATA[" + PT.rep(s, "]]>", "]]]]><![CDATA[>") + "]]>");
+  }
+  
+  /**
+   * @param s
+   * @return   unwrapped text
+   */
+  public static String unwrapCdata(String s) {
+    return (s.startsWith("<![CDATA[") && s.endsWith("]]>") ?
+        PT.rep(s.substring(9, s.length()-3),"]]]]><![CDATA[>", "]]>") : s);
+  }
+  
+  /**
+   * standard <name attr="..." attr="...">data</name>"
+   * 
+   * @param sb
+   * @param name
+   * @param attributes
+   * @param data
+   */
+  public static void appendTagObj(SB sb, String name,
+                               Object[] attributes, Object data) {
+    appendTagAll(sb, name, attributes, data, false, true);
+  }
+
+  /**
+   * standard <name>data</name>"
+   * standard <name attr="..." attr="..."></name>"
+   * 
+   * @param sb
+   * @param name
+   * @param data
+   */
+  public static void appendTag(SB sb, String name, Object data) {
+    if (data instanceof Object[])
+      appendTagAll(sb, name, (Object[]) data, null, false, true);
+    else
+      appendTagAll(sb, name, null, data, false, true);
+  }
+
+  /**
+   * <name><![CDATA[data]]></name>"
+   * 
+   * will convert ]]> to ]] >
+   * 
+   * @param sb
+   * @param name
+   * @param attributes 
+   * @param data
+   */
+  public static void appendCdata(SB sb, String name, 
+                                 Object[] attributes, String data) {
+    appendTagAll(sb, name, attributes, data, true, true);
+  }
+
+  /**
+   * 
+   * @param sb
+   * @param name
+   * @param value
+   */
+  public static void appendAttrib(SB sb, Object name, Object value) {
+    if (value == null)
+      return;
+    
+    // note: <&" are disallowed but not checked for here
+    
+    sb.append(" ").appendO(name).append("=\"").appendO(value).append("\"");
+  }
+
+}