From 4949e6a995f4b0de2ef060abdd20b10d427eccbc Mon Sep 17 00:00:00 2001 From: henrikjust Date: Wed, 6 Oct 2010 08:58:31 +0000 Subject: [PATCH] Zotero support git-svn-id: svn://svn.code.sf.net/p/writer2latex/code/trunk@72 f0f2a975-2e09-46c8-9428-3b39399b9f3c --- build.xml | 6 +- source/distro/Readme.txt | 6 +- source/distro/changelog.txt | 5 + source/distro/doc/user-manual.odt | Bin 48426 -> 48543 bytes source/java/org/json/CDL.java | 279 +++ source/java/org/json/Cookie.java | 169 ++ source/java/org/json/CookieList.java | 90 + source/java/org/json/HTTP.java | 163 ++ source/java/org/json/HTTPTokener.java | 77 + source/java/org/json/JSONArray.java | 918 ++++++++++ source/java/org/json/JSONException.java | 31 + source/java/org/json/JSONML.java | 455 +++++ source/java/org/json/JSONObject.java | 1584 +++++++++++++++++ source/java/org/json/JSONString.java | 18 + source/java/org/json/JSONStringer.java | 78 + source/java/org/json/JSONTokener.java | 435 +++++ source/java/org/json/JSONWriter.java | 323 ++++ source/java/org/json/Test.java | 678 +++++++ source/java/org/json/XML.java | 441 +++++ source/java/org/json/XMLTokener.java | 365 ++++ .../writer2latex/api/ConverterFactory.java | 6 +- .../writer2latex/latex/FieldConverter.java | 226 ++- .../writer2latex/latex/InlineConverter.java | 13 +- .../java/writer2latex/latex/LaTeXConfig.java | 71 +- .../writer2latex/latex/SectionConverter.java | 72 +- .../java/writer2latex/latex/util/Context.java | 13 +- .../java/writer2latex/office/XMLString.java | 3 +- source/oxt/writer2latex/description.xml | 2 +- source/oxt/writer2xhtml/description.xml | 2 +- source/oxt/writer4latex/description.xml | 2 +- .../oxt/xhtml-config-sample/description.xml | 2 +- source/readme-source.txt | 27 +- 32 files changed, 6492 insertions(+), 68 deletions(-) create mode 100644 source/java/org/json/CDL.java create mode 100644 source/java/org/json/Cookie.java create mode 100644 source/java/org/json/CookieList.java create mode 100644 source/java/org/json/HTTP.java create mode 100644 source/java/org/json/HTTPTokener.java create mode 100644 source/java/org/json/JSONArray.java create mode 100644 source/java/org/json/JSONException.java create mode 100644 source/java/org/json/JSONML.java create mode 100644 source/java/org/json/JSONObject.java create mode 100644 source/java/org/json/JSONString.java create mode 100644 source/java/org/json/JSONStringer.java create mode 100644 source/java/org/json/JSONTokener.java create mode 100644 source/java/org/json/JSONWriter.java create mode 100644 source/java/org/json/Test.java create mode 100644 source/java/org/json/XML.java create mode 100644 source/java/org/json/XMLTokener.java diff --git a/build.xml b/build.xml index 2571655..abb93e4 100644 --- a/build.xml +++ b/build.xml @@ -2,7 +2,7 @@ ############################################################################ # This is the Ant build file for writer2latex # Original: Sep 2004 (mgn) - # version 1.2 (2010-06-19) + # version 1.2 (2010-10-01) ############################################################################ --> @@ -35,7 +35,7 @@ - + @@ -93,7 +93,7 @@ - + diff --git a/source/distro/Readme.txt b/source/distro/Readme.txt index 7d0c762..90d89b3 100644 --- a/source/distro/Readme.txt +++ b/source/distro/Readme.txt @@ -1,7 +1,7 @@ -Writer2LaTeX version 1.1.4 (development release) +Writer2LaTeX version 1.1.5 (development release) ================================================ -This is the distribution of Writer2LaTeX version 1.1.4 +This is the distribution of Writer2LaTeX version 1.1.5 Latest version can be found at the web site http://writer2latex.sourceforge.net @@ -14,5 +14,5 @@ Bugs and feature requests should be reported to henrikjust (at) openoffice.org -May 2010 +October 2010 Henrik Just diff --git a/source/distro/changelog.txt b/source/distro/changelog.txt index 28a4fc5..a843b32 100644 --- a/source/distro/changelog.txt +++ b/source/distro/changelog.txt @@ -1,5 +1,10 @@ Changelog for Writer2LaTeX version 1.0 -> 1.2 +---------- version 1.1.5 ---------- + +[w2l] Added support for Zotero reference marks (with contributions from Kevin Brubeck Unhammer). + A new option zotero_bibtex_files has been added to give the names of the BibTeX files from Zotero + ---------- version 1.1.4 ---------- [w2x] EPUB bugfix: Fixed problem with URL encoding of fragment identifier in links to document parts diff --git a/source/distro/doc/user-manual.odt b/source/distro/doc/user-manual.odt index 0dac2eb99965faa8de94e75f7f797fe403472a26..2c82d9c2e3ff15690cd6aab83c148ab872e2a2dd 100644 GIT binary patch delta 46014 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�$`$*T@%Bw5-BQuOHGw7x~u8i_nJ4C@qjASVsW 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 Jxb>f#{|_i+omBt; delta 45899 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 + * Each row of text represents a row in a table or a data record. Each row + * ends with a NEWLINE character. Each row contains one or more values. + * Values are separated by commas. A value can contain any character except + * for comma, unless is is wrapped in single quotes or double quotes. + *

+ * The first row usually contains the names of the columns. + *

+ * A comma delimited list can be converted into a JSONArray of JSONObjects. + * The names for the elements in the JSONObjects can be taken from the names + * in the first row. + * @author JSON.org + * @version 2009-09-11 + */ +public class CDL { + + /** + * Get the next value. The value can be wrapped in quotes. The value can + * be empty. + * @param x A JSONTokener of the source text. + * @return The value string, or null if empty. + * @throws JSONException if the quoted string is badly formed. + */ + private static String getValue(JSONTokener x) throws JSONException { + char c; + char q; + StringBuffer sb; + do { + c = x.next(); + } while (c == ' ' || c == '\t'); + switch (c) { + case 0: + return null; + case '"': + case '\'': + q = c; + sb = new StringBuffer(); + for (;;) { + c = x.next(); + if (c == q) { + break; + } + if (c == 0 || c == '\n' || c == '\r') { + throw x.syntaxError("Missing close quote '" + q + "'."); + } + sb.append(c); + } + return sb.toString(); + case ',': + x.back(); + return ""; + default: + x.back(); + return x.nextTo(','); + } + } + + /** + * Produce a JSONArray of strings from a row of comma delimited values. + * @param x A JSONTokener of the source text. + * @return A JSONArray of strings. + * @throws JSONException + */ + public static JSONArray rowToJSONArray(JSONTokener x) throws JSONException { + JSONArray ja = new JSONArray(); + for (;;) { + String value = getValue(x); + char c = x.next(); + if (value == null || + (ja.length() == 0 && value.length() == 0 && c != ',')) { + return null; + } + ja.put(value); + for (;;) { + if (c == ',') { + break; + } + if (c != ' ') { + if (c == '\n' || c == '\r' || c == 0) { + return ja; + } + throw x.syntaxError("Bad character '" + c + "' (" + + (int)c + ")."); + } + c = x.next(); + } + } + } + + /** + * Produce a JSONObject from a row of comma delimited text, using a + * parallel JSONArray of strings to provides the names of the elements. + * @param names A JSONArray of names. This is commonly obtained from the + * first row of a comma delimited text file using the rowToJSONArray + * method. + * @param x A JSONTokener of the source text. + * @return A JSONObject combining the names and values. + * @throws JSONException + */ + public static JSONObject rowToJSONObject(JSONArray names, JSONTokener x) + throws JSONException { + JSONArray ja = rowToJSONArray(x); + return ja != null ? ja.toJSONObject(names) : null; + } + + /** + * Produce a JSONArray of JSONObjects from a comma delimited text string, + * using the first row as a source of names. + * @param string The comma delimited text. + * @return A JSONArray of JSONObjects. + * @throws JSONException + */ + public static JSONArray toJSONArray(String string) throws JSONException { + return toJSONArray(new JSONTokener(string)); + } + + /** + * Produce a JSONArray of JSONObjects from a comma delimited text string, + * using the first row as a source of names. + * @param x The JSONTokener containing the comma delimited text. + * @return A JSONArray of JSONObjects. + * @throws JSONException + */ + public static JSONArray toJSONArray(JSONTokener x) throws JSONException { + return toJSONArray(rowToJSONArray(x), x); + } + + /** + * Produce a JSONArray of JSONObjects from a comma delimited text string + * using a supplied JSONArray as the source of element names. + * @param names A JSONArray of strings. + * @param string The comma delimited text. + * @return A JSONArray of JSONObjects. + * @throws JSONException + */ + public static JSONArray toJSONArray(JSONArray names, String string) + throws JSONException { + return toJSONArray(names, new JSONTokener(string)); + } + + /** + * Produce a JSONArray of JSONObjects from a comma delimited text string + * using a supplied JSONArray as the source of element names. + * @param names A JSONArray of strings. + * @param x A JSONTokener of the source text. + * @return A JSONArray of JSONObjects. + * @throws JSONException + */ + public static JSONArray toJSONArray(JSONArray names, JSONTokener x) + throws JSONException { + if (names == null || names.length() == 0) { + return null; + } + JSONArray ja = new JSONArray(); + for (;;) { + JSONObject jo = rowToJSONObject(names, x); + if (jo == null) { + break; + } + ja.put(jo); + } + if (ja.length() == 0) { + return null; + } + return ja; + } + + + /** + * Produce a comma delimited text row from a JSONArray. Values containing + * the comma character will be quoted. Troublesome characters may be + * removed. + * @param ja A JSONArray of strings. + * @return A string ending in NEWLINE. + */ + public static String rowToString(JSONArray ja) { + StringBuffer sb = new StringBuffer(); + for (int i = 0; i < ja.length(); i += 1) { + if (i > 0) { + sb.append(','); + } + Object o = ja.opt(i); + if (o != null) { + String s = o.toString(); + if (s.length() > 0 && (s.indexOf(',') >= 0 || s.indexOf('\n') >= 0 || + s.indexOf('\r') >= 0 || s.indexOf(0) >= 0 || + s.charAt(0) == '"')) { + sb.append('"'); + int length = s.length(); + for (int j = 0; j < length; j += 1) { + char c = s.charAt(j); + if (c >= ' ' && c != '"') { + sb.append(c); + } + } + sb.append('"'); + } else { + sb.append(s); + } + } + } + sb.append('\n'); + return sb.toString(); + } + + /** + * Produce a comma delimited text from a JSONArray of JSONObjects. The + * first row will be a list of names obtained by inspecting the first + * JSONObject. + * @param ja A JSONArray of JSONObjects. + * @return A comma delimited text. + * @throws JSONException + */ + public static String toString(JSONArray ja) throws JSONException { + JSONObject jo = ja.optJSONObject(0); + if (jo != null) { + JSONArray names = jo.names(); + if (names != null) { + return rowToString(names) + toString(names, ja); + } + } + return null; + } + + /** + * Produce a comma delimited text from a JSONArray of JSONObjects using + * a provided list of names. The list of names is not included in the + * output. + * @param names A JSONArray of strings. + * @param ja A JSONArray of JSONObjects. + * @return A comma delimited text. + * @throws JSONException + */ + public static String toString(JSONArray names, JSONArray ja) + throws JSONException { + if (names == null || names.length() == 0) { + return null; + } + StringBuffer sb = new StringBuffer(); + for (int i = 0; i < ja.length(); i += 1) { + JSONObject jo = ja.optJSONObject(i); + if (jo != null) { + sb.append(rowToString(jo.toJSONArray(names))); + } + } + return sb.toString(); + } +} diff --git a/source/java/org/json/Cookie.java b/source/java/org/json/Cookie.java new file mode 100644 index 0000000..85b992e --- /dev/null +++ b/source/java/org/json/Cookie.java @@ -0,0 +1,169 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +/** + * Convert a web browser cookie specification to a JSONObject and back. + * JSON and Cookies are both notations for name/value pairs. + * @author JSON.org + * @version 2008-09-18 + */ +public class Cookie { + + /** + * Produce a copy of a string in which the characters '+', '%', '=', ';' + * and control characters are replaced with "%hh". This is a gentle form + * of URL encoding, attempting to cause as little distortion to the + * string as possible. The characters '=' and ';' are meta characters in + * cookies. By convention, they are escaped using the URL-encoding. This is + * only a convention, not a standard. Often, cookies are expected to have + * encoded values. We encode '=' and ';' because we must. We encode '%' and + * '+' because they are meta characters in URL encoding. + * @param string The source string. + * @return The escaped result. + */ + public static String escape(String string) { + char c; + String s = string.trim(); + StringBuffer sb = new StringBuffer(); + int len = s.length(); + for (int i = 0; i < len; i += 1) { + c = s.charAt(i); + if (c < ' ' || c == '+' || c == '%' || c == '=' || c == ';') { + sb.append('%'); + sb.append(Character.forDigit((char)((c >>> 4) & 0x0f), 16)); + sb.append(Character.forDigit((char)(c & 0x0f), 16)); + } else { + sb.append(c); + } + } + return sb.toString(); + } + + + /** + * Convert a cookie specification string into a JSONObject. The string + * will contain a name value pair separated by '='. The name and the value + * will be unescaped, possibly converting '+' and '%' sequences. The + * cookie properties may follow, separated by ';', also represented as + * name=value (except the secure property, which does not have a value). + * The name will be stored under the key "name", and the value will be + * stored under the key "value". This method does not do checking or + * validation of the parameters. It only converts the cookie string into + * a JSONObject. + * @param string The cookie specification string. + * @return A JSONObject containing "name", "value", and possibly other + * members. + * @throws JSONException + */ + public static JSONObject toJSONObject(String string) throws JSONException { + String n; + JSONObject o = new JSONObject(); + Object v; + JSONTokener x = new JSONTokener(string); + o.put("name", x.nextTo('=')); + x.next('='); + o.put("value", x.nextTo(';')); + x.next(); + while (x.more()) { + n = unescape(x.nextTo("=;")); + if (x.next() != '=') { + if (n.equals("secure")) { + v = Boolean.TRUE; + } else { + throw x.syntaxError("Missing '=' in cookie parameter."); + } + } else { + v = unescape(x.nextTo(';')); + x.next(); + } + o.put(n, v); + } + return o; + } + + + /** + * Convert a JSONObject into a cookie specification string. The JSONObject + * must contain "name" and "value" members. + * If the JSONObject contains "expires", "domain", "path", or "secure" + * members, they will be appended to the cookie specification string. + * All other members are ignored. + * @param o A JSONObject + * @return A cookie specification string + * @throws JSONException + */ + public static String toString(JSONObject o) throws JSONException { + StringBuffer sb = new StringBuffer(); + + sb.append(escape(o.getString("name"))); + sb.append("="); + sb.append(escape(o.getString("value"))); + if (o.has("expires")) { + sb.append(";expires="); + sb.append(o.getString("expires")); + } + if (o.has("domain")) { + sb.append(";domain="); + sb.append(escape(o.getString("domain"))); + } + if (o.has("path")) { + sb.append(";path="); + sb.append(escape(o.getString("path"))); + } + if (o.optBoolean("secure")) { + sb.append(";secure"); + } + return sb.toString(); + } + + /** + * Convert %hh sequences to single characters, and + * convert plus to space. + * @param s A string that may contain + * + (plus) and + * %hh sequences. + * @return The unescaped string. + */ + public static String unescape(String s) { + int len = s.length(); + StringBuffer b = new StringBuffer(); + for (int i = 0; i < len; ++i) { + char c = s.charAt(i); + if (c == '+') { + c = ' '; + } else if (c == '%' && i + 2 < len) { + int d = JSONTokener.dehexchar(s.charAt(i + 1)); + int e = JSONTokener.dehexchar(s.charAt(i + 2)); + if (d >= 0 && e >= 0) { + c = (char)(d * 16 + e); + i += 2; + } + } + b.append(c); + } + return b.toString(); + } +} diff --git a/source/java/org/json/CookieList.java b/source/java/org/json/CookieList.java new file mode 100644 index 0000000..8f651f5 --- /dev/null +++ b/source/java/org/json/CookieList.java @@ -0,0 +1,90 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.util.Iterator; + +/** + * Convert a web browser cookie list string to a JSONObject and back. + * @author JSON.org + * @version 2008-09-18 + */ +public class CookieList { + + /** + * Convert a cookie list into a JSONObject. A cookie list is a sequence + * of name/value pairs. The names are separated from the values by '='. + * The pairs are separated by ';'. The names and the values + * will be unescaped, possibly converting '+' and '%' sequences. + * + * To add a cookie to a cooklist, + * cookielistJSONObject.put(cookieJSONObject.getString("name"), + * cookieJSONObject.getString("value")); + * @param string A cookie list string + * @return A JSONObject + * @throws JSONException + */ + public static JSONObject toJSONObject(String string) throws JSONException { + JSONObject o = new JSONObject(); + JSONTokener x = new JSONTokener(string); + while (x.more()) { + String name = Cookie.unescape(x.nextTo('=')); + x.next('='); + o.put(name, Cookie.unescape(x.nextTo(';'))); + x.next(); + } + return o; + } + + + /** + * Convert a JSONObject into a cookie list. A cookie list is a sequence + * of name/value pairs. The names are separated from the values by '='. + * The pairs are separated by ';'. The characters '%', '+', '=', and ';' + * in the names and values are replaced by "%hh". + * @param o A JSONObject + * @return A cookie list string + * @throws JSONException + */ + public static String toString(JSONObject o) throws JSONException { + boolean b = false; + Iterator keys = o.keys(); + String s; + StringBuffer sb = new StringBuffer(); + while (keys.hasNext()) { + s = keys.next().toString(); + if (!o.isNull(s)) { + if (b) { + sb.append(';'); + } + sb.append(Cookie.escape(s)); + sb.append("="); + sb.append(Cookie.escape(o.getString(s))); + b = true; + } + } + return sb.toString(); + } +} diff --git a/source/java/org/json/HTTP.java b/source/java/org/json/HTTP.java new file mode 100644 index 0000000..6624708 --- /dev/null +++ b/source/java/org/json/HTTP.java @@ -0,0 +1,163 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.util.Iterator; + +/** + * Convert an HTTP header to a JSONObject and back. + * @author JSON.org + * @version 2008-09-18 + */ +public class HTTP { + + /** Carriage return/line feed. */ + public static final String CRLF = "\r\n"; + + /** + * Convert an HTTP header string into a JSONObject. It can be a request + * header or a response header. A request header will contain + * 

{
+     *    Method: "POST" (for example),
+     *    "Request-URI": "/" (for example),
+     *    "HTTP-Version": "HTTP/1.1" (for example)
+     * }
+ * A response header will contain + * 
{
+     *    "HTTP-Version": "HTTP/1.1" (for example),
+     *    "Status-Code": "200" (for example),
+     *    "Reason-Phrase": "OK" (for example)
+     * }
+ * In addition, the other parameters in the header will be captured, using + * the HTTP field names as JSON names, so that 
+     *    Date: Sun, 26 May 2002 18:06:04 GMT
+     *    Cookie: Q=q2=PPEAsg--; B=677gi6ouf29bn&b=2&f=s
+     *    Cache-Control: no-cache
+ * become + * 
{...
+     *    Date: "Sun, 26 May 2002 18:06:04 GMT",
+     *    Cookie: "Q=q2=PPEAsg--; B=677gi6ouf29bn&b=2&f=s",
+     *    "Cache-Control": "no-cache",
+     * ...}
+ * It does no further checking or conversion. It does not parse dates. + * It does not do '%' transforms on URLs. + * @param string An HTTP header string. + * @return A JSONObject containing the elements and attributes + * of the XML string. + * @throws JSONException + */ + public static JSONObject toJSONObject(String string) throws JSONException { + JSONObject o = new JSONObject(); + HTTPTokener x = new HTTPTokener(string); + String t; + + t = x.nextToken(); + if (t.toUpperCase().startsWith("HTTP")) { + +// Response + + o.put("HTTP-Version", t); + o.put("Status-Code", x.nextToken()); + o.put("Reason-Phrase", x.nextTo('\0')); + x.next(); + + } else { + +// Request + + o.put("Method", t); + o.put("Request-URI", x.nextToken()); + o.put("HTTP-Version", x.nextToken()); + } + +// Fields + + while (x.more()) { + String name = x.nextTo(':'); + x.next(':'); + o.put(name, x.nextTo('\0')); + x.next(); + } + return o; + } + + + /** + * Convert a JSONObject into an HTTP header. A request header must contain + * 
{
+     *    Method: "POST" (for example),
+     *    "Request-URI": "/" (for example),
+     *    "HTTP-Version": "HTTP/1.1" (for example)
+     * }
+ * A response header must contain + * 
{
+     *    "HTTP-Version": "HTTP/1.1" (for example),
+     *    "Status-Code": "200" (for example),
+     *    "Reason-Phrase": "OK" (for example)
+     * }
+ * Any other members of the JSONObject will be output as HTTP fields. + * The result will end with two CRLF pairs. + * @param o A JSONObject + * @return An HTTP header string. + * @throws JSONException if the object does not contain enough + * information. + */ + public static String toString(JSONObject o) throws JSONException { + Iterator keys = o.keys(); + String s; + StringBuffer sb = new StringBuffer(); + if (o.has("Status-Code") && o.has("Reason-Phrase")) { + sb.append(o.getString("HTTP-Version")); + sb.append(' '); + sb.append(o.getString("Status-Code")); + sb.append(' '); + sb.append(o.getString("Reason-Phrase")); + } else if (o.has("Method") && o.has("Request-URI")) { + sb.append(o.getString("Method")); + sb.append(' '); + sb.append('"'); + sb.append(o.getString("Request-URI")); + sb.append('"'); + sb.append(' '); + sb.append(o.getString("HTTP-Version")); + } else { + throw new JSONException("Not enough material for an HTTP header."); + } + sb.append(CRLF); + while (keys.hasNext()) { + s = keys.next().toString(); + if (!s.equals("HTTP-Version") && !s.equals("Status-Code") && + !s.equals("Reason-Phrase") && !s.equals("Method") && + !s.equals("Request-URI") && !o.isNull(s)) { + sb.append(s); + sb.append(": "); + sb.append(o.getString(s)); + sb.append(CRLF); + } + } + sb.append(CRLF); + return sb.toString(); + } +} diff --git a/source/java/org/json/HTTPTokener.java b/source/java/org/json/HTTPTokener.java new file mode 100644 index 0000000..410a77c --- /dev/null +++ b/source/java/org/json/HTTPTokener.java @@ -0,0 +1,77 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +/** + * The HTTPTokener extends the JSONTokener to provide additional methods + * for the parsing of HTTP headers. + * @author JSON.org + * @version 2008-09-18 + */ +public class HTTPTokener extends JSONTokener { + + /** + * Construct an HTTPTokener from a string. + * @param s A source string. + */ + public HTTPTokener(String s) { + super(s); + } + + + /** + * Get the next token or string. This is used in parsing HTTP headers. + * @throws JSONException + * @return A String. + */ + public String nextToken() throws JSONException { + char c; + char q; + StringBuffer sb = new StringBuffer(); + do { + c = next(); + } while (Character.isWhitespace(c)); + if (c == '"' || c == '\'') { + q = c; + for (;;) { + c = next(); + if (c < ' ') { + throw syntaxError("Unterminated string."); + } + if (c == q) { + return sb.toString(); + } + sb.append(c); + } + } + for (;;) { + if (c == 0 || Character.isWhitespace(c)) { + return sb.toString(); + } + sb.append(c); + c = next(); + } + } +} diff --git a/source/java/org/json/JSONArray.java b/source/java/org/json/JSONArray.java new file mode 100644 index 0000000..5cc6f71 --- /dev/null +++ b/source/java/org/json/JSONArray.java @@ -0,0 +1,918 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.io.IOException; +import java.io.Writer; +import java.lang.reflect.Array; +import java.util.ArrayList; +import java.util.Collection; +import java.util.Iterator; +import java.util.Map; + +/** + * A JSONArray is an ordered sequence of values. Its external text form is a + * string wrapped in square brackets with commas separating the values. The + * internal form is an object having get and opt + * methods for accessing the values by index, and put methods for + * adding or replacing values. The values can be any of these types: + * Boolean, JSONArray, JSONObject, + * Number, String, or the + * JSONObject.NULL object. + *

+ * The constructor can convert a JSON text into a Java object. The + * toString method converts to JSON text. + *

+ * A get method returns a value if one can be found, and throws an + * exception if one cannot be found. An opt method returns a + * default value instead of throwing an exception, and so is useful for + * obtaining optional values. + *

+ * The generic get() and opt() methods return an + * object which you can cast or query for type. There are also typed + * get and opt methods that do type checking and type + * coercion for you. + *

+ * The texts produced by the toString methods strictly conform to + * JSON syntax rules. The constructors are more forgiving in the texts they will + * accept: + *

    + *
  • An extra , (comma) may appear just + * before the closing bracket.
    • + *
  • The null value will be inserted when there + * is , (comma) elision.
    • + *
  • Strings may be quoted with ' (single + * quote).
    • + *
  • Strings do not need to be quoted at all if they do not begin with a quote + * or single quote, and if they do not contain leading or trailing spaces, + * and if they do not contain any of these characters: + * { } [ ] / \ : , = ; # and if they do not look like numbers + * and if they are not the reserved words true, + * false, or null.
    • + *
  • Values can be separated by ; (semicolon) as + * well as by , (comma).
    • + *
  • Numbers may have the + * 0x- (hex) prefix.
    • + *
+ + * @author JSON.org + * @version 2009-04-14 + */ +public class JSONArray { + + + /** + * The arrayList where the JSONArray's properties are kept. + */ + private ArrayList myArrayList; + + + /** + * Construct an empty JSONArray. + */ + public JSONArray() { + this.myArrayList = new ArrayList(); + } + + /** + * Construct a JSONArray from a JSONTokener. + * @param x A JSONTokener + * @throws JSONException If there is a syntax error. + */ + public JSONArray(JSONTokener x) throws JSONException { + this(); + char c = x.nextClean(); + char q; + if (c == '[') { + q = ']'; + } else if (c == '(') { + q = ')'; + } else { + throw x.syntaxError("A JSONArray text must start with '['"); + } + if (x.nextClean() == ']') { + return; + } + x.back(); + for (;;) { + if (x.nextClean() == ',') { + x.back(); + this.myArrayList.add(null); + } else { + x.back(); + this.myArrayList.add(x.nextValue()); + } + c = x.nextClean(); + switch (c) { + case ';': + case ',': + if (x.nextClean() == ']') { + return; + } + x.back(); + break; + case ']': + case ')': + if (q != c) { + throw x.syntaxError("Expected a '" + new Character(q) + "'"); + } + return; + default: + throw x.syntaxError("Expected a ',' or ']'"); + } + } + } + + + /** + * Construct a JSONArray from a source JSON text. + * @param source A string that begins with + * [ (left bracket) + * and ends with ] (right bracket). + * @throws JSONException If there is a syntax error. + */ + public JSONArray(String source) throws JSONException { + this(new JSONTokener(source)); + } + + + /** + * Construct a JSONArray from a Collection. + * @param collection A Collection. + */ + public JSONArray(Collection collection) { + this.myArrayList = new ArrayList(); + if (collection != null) { + Iterator iter = collection.iterator(); + while (iter.hasNext()) { + Object o = iter.next(); + this.myArrayList.add(JSONObject.wrap(o)); + } + } + } + + + /** + * Construct a JSONArray from an array + * @throws JSONException If not an array. + */ + public JSONArray(Object array) throws JSONException { + this(); + if (array.getClass().isArray()) { + int length = Array.getLength(array); + for (int i = 0; i < length; i += 1) { + this.put(JSONObject.wrap(Array.get(array, i))); + } + } else { + throw new JSONException( +"JSONArray initial value should be a string or collection or array."); + } + } + + + /** + * Get the object value associated with an index. + * @param index + * The index must be between 0 and length() - 1. + * @return An object value. + * @throws JSONException If there is no value for the index. + */ + public Object get(int index) throws JSONException { + Object o = opt(index); + if (o == null) { + throw new JSONException("JSONArray[" + index + "] not found."); + } + return o; + } + + + /** + * Get the boolean value associated with an index. + * The string values "true" and "false" are converted to boolean. + * + * @param index The index must be between 0 and length() - 1. + * @return The truth. + * @throws JSONException If there is no value for the index or if the + * value is not convertable to boolean. + */ + public boolean getBoolean(int index) throws JSONException { + Object o = get(index); + if (o.equals(Boolean.FALSE) || + (o instanceof String && + ((String)o).equalsIgnoreCase("false"))) { + return false; + } else if (o.equals(Boolean.TRUE) || + (o instanceof String && + ((String)o).equalsIgnoreCase("true"))) { + return true; + } + throw new JSONException("JSONArray[" + index + "] is not a Boolean."); + } + + + /** + * Get the double value associated with an index. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + * @throws JSONException If the key is not found or if the value cannot + * be converted to a number. + */ + public double getDouble(int index) throws JSONException { + Object o = get(index); + try { + return o instanceof Number ? + ((Number)o).doubleValue() : + Double.valueOf((String)o).doubleValue(); + } catch (Exception e) { + throw new JSONException("JSONArray[" + index + + "] is not a number."); + } + } + + + /** + * Get the int value associated with an index. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + * @throws JSONException If the key is not found or if the value cannot + * be converted to a number. + * if the value cannot be converted to a number. + */ + public int getInt(int index) throws JSONException { + Object o = get(index); + return o instanceof Number ? + ((Number)o).intValue() : (int)getDouble(index); + } + + + /** + * Get the JSONArray associated with an index. + * @param index The index must be between 0 and length() - 1. + * @return A JSONArray value. + * @throws JSONException If there is no value for the index. or if the + * value is not a JSONArray + */ + public JSONArray getJSONArray(int index) throws JSONException { + Object o = get(index); + if (o instanceof JSONArray) { + return (JSONArray)o; + } + throw new JSONException("JSONArray[" + index + + "] is not a JSONArray."); + } + + + /** + * Get the JSONObject associated with an index. + * @param index subscript + * @return A JSONObject value. + * @throws JSONException If there is no value for the index or if the + * value is not a JSONObject + */ + public JSONObject getJSONObject(int index) throws JSONException { + Object o = get(index); + if (o instanceof JSONObject) { + return (JSONObject)o; + } + throw new JSONException("JSONArray[" + index + + "] is not a JSONObject."); + } + + + /** + * Get the long value associated with an index. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + * @throws JSONException If the key is not found or if the value cannot + * be converted to a number. + */ + public long getLong(int index) throws JSONException { + Object o = get(index); + return o instanceof Number ? + ((Number)o).longValue() : (long)getDouble(index); + } + + + /** + * Get the string associated with an index. + * @param index The index must be between 0 and length() - 1. + * @return A string value. + * @throws JSONException If there is no value for the index. + */ + public String getString(int index) throws JSONException { + return get(index).toString(); + } + + + /** + * Determine if the value is null. + * @param index The index must be between 0 and length() - 1. + * @return true if the value at the index is null, or if there is no value. + */ + public boolean isNull(int index) { + return JSONObject.NULL.equals(opt(index)); + } + + + /** + * Make a string from the contents of this JSONArray. The + * separator string is inserted between each element. + * Warning: This method assumes that the data structure is acyclical. + * @param separator A string that will be inserted between the elements. + * @return a string. + * @throws JSONException If the array contains an invalid number. + */ + public String join(String separator) throws JSONException { + int len = length(); + StringBuffer sb = new StringBuffer(); + + for (int i = 0; i < len; i += 1) { + if (i > 0) { + sb.append(separator); + } + sb.append(JSONObject.valueToString(this.myArrayList.get(i))); + } + return sb.toString(); + } + + + /** + * Get the number of elements in the JSONArray, included nulls. + * + * @return The length (or size). + */ + public int length() { + return this.myArrayList.size(); + } + + + /** + * Get the optional object value associated with an index. + * @param index The index must be between 0 and length() - 1. + * @return An object value, or null if there is no + * object at that index. + */ + public Object opt(int index) { + return (index < 0 || index >= length()) ? + null : this.myArrayList.get(index); + } + + + /** + * Get the optional boolean value associated with an index. + * It returns false if there is no value at that index, + * or if the value is not Boolean.TRUE or the String "true". + * + * @param index The index must be between 0 and length() - 1. + * @return The truth. + */ + public boolean optBoolean(int index) { + return optBoolean(index, false); + } + + + /** + * Get the optional boolean value associated with an index. + * It returns the defaultValue if there is no value at that index or if + * it is not a Boolean or the String "true" or "false" (case insensitive). + * + * @param index The index must be between 0 and length() - 1. + * @param defaultValue A boolean default. + * @return The truth. + */ + public boolean optBoolean(int index, boolean defaultValue) { + try { + return getBoolean(index); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get the optional double value associated with an index. + * NaN is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + */ + public double optDouble(int index) { + return optDouble(index, Double.NaN); + } + + + /** + * Get the optional double value associated with an index. + * The defaultValue is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * + * @param index subscript + * @param defaultValue The default value. + * @return The value. + */ + public double optDouble(int index, double defaultValue) { + try { + return getDouble(index); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get the optional int value associated with an index. + * Zero is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + */ + public int optInt(int index) { + return optInt(index, 0); + } + + + /** + * Get the optional int value associated with an index. + * The defaultValue is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * @param index The index must be between 0 and length() - 1. + * @param defaultValue The default value. + * @return The value. + */ + public int optInt(int index, int defaultValue) { + try { + return getInt(index); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get the optional JSONArray associated with an index. + * @param index subscript + * @return A JSONArray value, or null if the index has no value, + * or if the value is not a JSONArray. + */ + public JSONArray optJSONArray(int index) { + Object o = opt(index); + return o instanceof JSONArray ? (JSONArray)o : null; + } + + + /** + * Get the optional JSONObject associated with an index. + * Null is returned if the key is not found, or null if the index has + * no value, or if the value is not a JSONObject. + * + * @param index The index must be between 0 and length() - 1. + * @return A JSONObject value. + */ + public JSONObject optJSONObject(int index) { + Object o = opt(index); + return o instanceof JSONObject ? (JSONObject)o : null; + } + + + /** + * Get the optional long value associated with an index. + * Zero is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * + * @param index The index must be between 0 and length() - 1. + * @return The value. + */ + public long optLong(int index) { + return optLong(index, 0); + } + + + /** + * Get the optional long value associated with an index. + * The defaultValue is returned if there is no value for the index, + * or if the value is not a number and cannot be converted to a number. + * @param index The index must be between 0 and length() - 1. + * @param defaultValue The default value. + * @return The value. + */ + public long optLong(int index, long defaultValue) { + try { + return getLong(index); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get the optional string value associated with an index. It returns an + * empty string if there is no value at that index. If the value + * is not a string and is not null, then it is coverted to a string. + * + * @param index The index must be between 0 and length() - 1. + * @return A String value. + */ + public String optString(int index) { + return optString(index, ""); + } + + + /** + * Get the optional string associated with an index. + * The defaultValue is returned if the key is not found. + * + * @param index The index must be between 0 and length() - 1. + * @param defaultValue The default value. + * @return A String value. + */ + public String optString(int index, String defaultValue) { + Object o = opt(index); + return o != null ? o.toString() : defaultValue; + } + + + /** + * Append a boolean value. This increases the array's length by one. + * + * @param value A boolean value. + * @return this. + */ + public JSONArray put(boolean value) { + put(value ? Boolean.TRUE : Boolean.FALSE); + return this; + } + + + /** + * Put a value in the JSONArray, where the value will be a + * JSONArray which is produced from a Collection. + * @param value A Collection value. + * @return this. + */ + public JSONArray put(Collection value) { + put(new JSONArray(value)); + return this; + } + + + /** + * Append a double value. This increases the array's length by one. + * + * @param value A double value. + * @throws JSONException if the value is not finite. + * @return this. + */ + public JSONArray put(double value) throws JSONException { + Double d = new Double(value); + JSONObject.testValidity(d); + put(d); + return this; + } + + + /** + * Append an int value. This increases the array's length by one. + * + * @param value An int value. + * @return this. + */ + public JSONArray put(int value) { + put(new Integer(value)); + return this; + } + + + /** + * Append an long value. This increases the array's length by one. + * + * @param value A long value. + * @return this. + */ + public JSONArray put(long value) { + put(new Long(value)); + return this; + } + + + /** + * Put a value in the JSONArray, where the value will be a + * JSONObject which is produced from a Map. + * @param value A Map value. + * @return this. + */ + public JSONArray put(Map value) { + put(new JSONObject(value)); + return this; + } + + + /** + * Append an object value. This increases the array's length by one. + * @param value An object value. The value should be a + * Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the + * JSONObject.NULL object. + * @return this. + */ + public JSONArray put(Object value) { + this.myArrayList.add(value); + return this; + } + + + /** + * Put or replace a boolean value in the JSONArray. If the index is greater + * than the length of the JSONArray, then null elements will be added as + * necessary to pad it out. + * @param index The subscript. + * @param value A boolean value. + * @return this. + * @throws JSONException If the index is negative. + */ + public JSONArray put(int index, boolean value) throws JSONException { + put(index, value ? Boolean.TRUE : Boolean.FALSE); + return this; + } + + + /** + * Put a value in the JSONArray, where the value will be a + * JSONArray which is produced from a Collection. + * @param index The subscript. + * @param value A Collection value. + * @return this. + * @throws JSONException If the index is negative or if the value is + * not finite. + */ + public JSONArray put(int index, Collection value) throws JSONException { + put(index, new JSONArray(value)); + return this; + } + + + /** + * Put or replace a double value. If the index is greater than the length of + * the JSONArray, then null elements will be added as necessary to pad + * it out. + * @param index The subscript. + * @param value A double value. + * @return this. + * @throws JSONException If the index is negative or if the value is + * not finite. + */ + public JSONArray put(int index, double value) throws JSONException { + put(index, new Double(value)); + return this; + } + + + /** + * Put or replace an int value. If the index is greater than the length of + * the JSONArray, then null elements will be added as necessary to pad + * it out. + * @param index The subscript. + * @param value An int value. + * @return this. + * @throws JSONException If the index is negative. + */ + public JSONArray put(int index, int value) throws JSONException { + put(index, new Integer(value)); + return this; + } + + + /** + * Put or replace a long value. If the index is greater than the length of + * the JSONArray, then null elements will be added as necessary to pad + * it out. + * @param index The subscript. + * @param value A long value. + * @return this. + * @throws JSONException If the index is negative. + */ + public JSONArray put(int index, long value) throws JSONException { + put(index, new Long(value)); + return this; + } + + + /** + * Put a value in the JSONArray, where the value will be a + * JSONObject which is produced from a Map. + * @param index The subscript. + * @param value The Map value. + * @return this. + * @throws JSONException If the index is negative or if the the value is + * an invalid number. + */ + public JSONArray put(int index, Map value) throws JSONException { + put(index, new JSONObject(value)); + return this; + } + + + /** + * Put or replace an object value in the JSONArray. If the index is greater + * than the length of the JSONArray, then null elements will be added as + * necessary to pad it out. + * @param index The subscript. + * @param value The value to put into the array. The value should be a + * Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the + * JSONObject.NULL object. + * @return this. + * @throws JSONException If the index is negative or if the the value is + * an invalid number. + */ + public JSONArray put(int index, Object value) throws JSONException { + JSONObject.testValidity(value); + if (index < 0) { + throw new JSONException("JSONArray[" + index + "] not found."); + } + if (index < length()) { + this.myArrayList.set(index, value); + } else { + while (index != length()) { + put(JSONObject.NULL); + } + put(value); + } + return this; + } + + + /** + * Remove an index and close the hole. + * @param index The index of the element to be removed. + * @return The value that was associated with the index, + * or null if there was no value. + */ + public Object remove(int index) { + Object o = opt(index); + this.myArrayList.remove(index); + return o; + } + + + /** + * Produce a JSONObject by combining a JSONArray of names with the values + * of this JSONArray. + * @param names A JSONArray containing a list of key strings. These will be + * paired with the values. + * @return A JSONObject, or null if there are no names or if this JSONArray + * has no values. + * @throws JSONException If any of the names are null. + */ + public JSONObject toJSONObject(JSONArray names) throws JSONException { + if (names == null || names.length() == 0 || length() == 0) { + return null; + } + JSONObject jo = new JSONObject(); + for (int i = 0; i < names.length(); i += 1) { + jo.put(names.getString(i), this.opt(i)); + } + return jo; + } + + + /** + * Make a JSON text of this JSONArray. For compactness, no + * unnecessary whitespace is added. If it is not possible to produce a + * syntactically correct JSON text then null will be returned instead. This + * could occur if the array contains an invalid number. + *

+ * Warning: This method assumes that the data structure is acyclical. + * + * @return a printable, displayable, transmittable + * representation of the array. + */ + public String toString() { + try { + return '[' + join(",") + ']'; + } catch (Exception e) { + return null; + } + } + + + /** + * Make a prettyprinted JSON text of this JSONArray. + * Warning: This method assumes that the data structure is acyclical. + * @param indentFactor The number of spaces to add to each level of + * indentation. + * @return a printable, displayable, transmittable + * representation of the object, beginning + * with [ (left bracket) and ending + * with ] (right bracket). + * @throws JSONException + */ + public String toString(int indentFactor) throws JSONException { + return toString(indentFactor, 0); + } + + + /** + * Make a prettyprinted JSON text of this JSONArray. + * Warning: This method assumes that the data structure is acyclical. + * @param indentFactor The number of spaces to add to each level of + * indentation. + * @param indent The indention of the top level. + * @return a printable, displayable, transmittable + * representation of the array. + * @throws JSONException + */ + String toString(int indentFactor, int indent) throws JSONException { + int len = length(); + if (len == 0) { + return "[]"; + } + int i; + StringBuffer sb = new StringBuffer("["); + if (len == 1) { + sb.append(JSONObject.valueToString(this.myArrayList.get(0), + indentFactor, indent)); + } else { + int newindent = indent + indentFactor; + sb.append('\n'); + for (i = 0; i < len; i += 1) { + if (i > 0) { + sb.append(",\n"); + } + for (int j = 0; j < newindent; j += 1) { + sb.append(' '); + } + sb.append(JSONObject.valueToString(this.myArrayList.get(i), + indentFactor, newindent)); + } + sb.append('\n'); + for (i = 0; i < indent; i += 1) { + sb.append(' '); + } + } + sb.append(']'); + return sb.toString(); + } + + + /** + * Write the contents of the JSONArray as JSON text to a writer. + * For compactness, no whitespace is added. + *

+ * Warning: This method assumes that the data structure is acyclical. + * + * @return The writer. + * @throws JSONException + */ + public Writer write(Writer writer) throws JSONException { + try { + boolean b = false; + int len = length(); + + writer.write('['); + + for (int i = 0; i < len; i += 1) { + if (b) { + writer.write(','); + } + Object v = this.myArrayList.get(i); + if (v instanceof JSONObject) { + ((JSONObject)v).write(writer); + } else if (v instanceof JSONArray) { + ((JSONArray)v).write(writer); + } else { + writer.write(JSONObject.valueToString(v)); + } + b = true; + } + writer.write(']'); + return writer; + } catch (IOException e) { + throw new JSONException(e); + } + } +} \ No newline at end of file diff --git a/source/java/org/json/JSONException.java b/source/java/org/json/JSONException.java new file mode 100644 index 0000000..45e3b8d --- /dev/null +++ b/source/java/org/json/JSONException.java @@ -0,0 +1,31 @@ +package org.json; + +/** + * The JSONException is thrown by the JSON.org classes when things are amiss. + * @author JSON.org + * @version 2008-09-18 + */ +public class JSONException extends Exception { + /** + * + */ + private static final long serialVersionUID = 0; + private Throwable cause; + + /** + * Constructs a JSONException with an explanatory message. + * @param message Detail about the reason for the exception. + */ + public JSONException(String message) { + super(message); + } + + public JSONException(Throwable t) { + super(t.getMessage()); + this.cause = t; + } + + public Throwable getCause() { + return this.cause; + } +} diff --git a/source/java/org/json/JSONML.java b/source/java/org/json/JSONML.java new file mode 100644 index 0000000..1337182 --- /dev/null +++ b/source/java/org/json/JSONML.java @@ -0,0 +1,455 @@ +package org.json; + +/* +Copyright (c) 2008 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.util.Iterator; + + +/** + * This provides static methods to convert an XML text into a JSONArray or + * JSONObject, and to covert a JSONArray or JSONObject into an XML text using + * the JsonML transform. + * @author JSON.org + * @version 2010-02-12 + */ +public class JSONML { + + /** + * Parse XML values and store them in a JSONArray. + * @param x The XMLTokener containing the source string. + * @param arrayForm true if array form, false if object form. + * @param ja The JSONArray that is containing the current tag or null + * if we are at the outermost level. + * @return A JSONArray if the value is the outermost tag, otherwise null. + * @throws JSONException + */ + private static Object parse(XMLTokener x, boolean arrayForm, + JSONArray ja) throws JSONException { + String attribute; + char c; + String closeTag = null; + int i; + JSONArray newja = null; + JSONObject newjo = null; + Object token; + String tagName = null; + +// Test for and skip past these forms: +// +// +// +// + + while (true) { + token = x.nextContent(); + if (token == XML.LT) { + token = x.nextToken(); + if (token instanceof Character) { + if (token == XML.SLASH) { + +// Close tag "); + } + x.back(); + } else if (c == '[') { + token = x.nextToken(); + if (token.equals("CDATA") && x.next() == '[') { + if (ja != null) { + ja.put(x.nextCDATA()); + } + } else { + throw x.syntaxError("Expected 'CDATA['"); + } + } else { + i = 1; + do { + token = x.nextMeta(); + if (token == null) { + throw x.syntaxError("Missing '>' after ' 0); + } + } else if (token == XML.QUEST) { + +// "); + } else { + throw x.syntaxError("Misshaped tag"); + } + +// Open tag < + + } else { + if (!(token instanceof String)) { + throw x.syntaxError("Bad tagName '" + token + "'."); + } + tagName = (String)token; + newja = new JSONArray(); + newjo = new JSONObject(); + if (arrayForm) { + newja.put(tagName); + if (ja != null) { + ja.put(newja); + } + } else { + newjo.put("tagName", tagName); + if (ja != null) { + ja.put(newjo); + } + } + token = null; + for (;;) { + if (token == null) { + token = x.nextToken(); + } + if (token == null) { + throw x.syntaxError("Misshaped tag"); + } + if (!(token instanceof String)) { + break; + } + +// attribute = value + + attribute = (String)token; + if (!arrayForm && (attribute == "tagName" || attribute == "childNode")) { + throw x.syntaxError("Reserved attribute."); + } + token = x.nextToken(); + if (token == XML.EQ) { + token = x.nextToken(); + if (!(token instanceof String)) { + throw x.syntaxError("Missing value"); + } + newjo.accumulate(attribute, JSONObject.stringToValue((String)token)); + token = null; + } else { + newjo.accumulate(attribute, ""); + } + } + if (arrayForm && newjo.length() > 0) { + newja.put(newjo); + } + +// Empty tag <.../> + + if (token == XML.SLASH) { + if (x.nextToken() != XML.GT) { + throw x.syntaxError("Misshaped tag"); + } + if (ja == null) { + if (arrayForm) { + return newja; + } else { + return newjo; + } + } + +// Content, between <...> and + + } else { + if (token != XML.GT) { + throw x.syntaxError("Misshaped tag"); + } + closeTag = (String)parse(x, arrayForm, newja); + if (closeTag != null) { + if (!closeTag.equals(tagName)) { + throw x.syntaxError("Mismatched '" + tagName + + "' and '" + closeTag + "'"); + } + tagName = null; + if (!arrayForm && newja.length() > 0) { + newjo.put("childNodes", newja); + } + if (ja == null) { + if (arrayForm) { + return newja; + } else { + return newjo; + } + } + } + } + } + } else { + if (ja != null) { + ja.put(token instanceof String ? + JSONObject.stringToValue((String)token) : token); + } + } + } + } + + + /** + * Convert a well-formed (but not necessarily valid) XML string into a + * JSONArray using the JsonML transform. Each XML tag is represented as + * a JSONArray in which the first element is the tag name. If the tag has + * attributes, then the second element will be JSONObject containing the + * name/value pairs. If the tag contains children, then strings and + * JSONArrays will represent the child tags. + * Comments, prologs, DTDs, and <[ [ ]]> are ignored. + * @param string The source string. + * @return A JSONArray containing the structured data from the XML string. + * @throws JSONException + */ + public static JSONArray toJSONArray(String string) throws JSONException { + return toJSONArray(new XMLTokener(string)); + } + + + /** + * Convert a well-formed (but not necessarily valid) XML string into a + * JSONArray using the JsonML transform. Each XML tag is represented as + * a JSONArray in which the first element is the tag name. If the tag has + * attributes, then the second element will be JSONObject containing the + * name/value pairs. If the tag contains children, then strings and + * JSONArrays will represent the child content and tags. + * Comments, prologs, DTDs, and <[ [ ]]> are ignored. + * @param x An XMLTokener. + * @return A JSONArray containing the structured data from the XML string. + * @throws JSONException + */ + public static JSONArray toJSONArray(XMLTokener x) throws JSONException { + return (JSONArray)parse(x, true, null); + } + + + + /** + * Convert a well-formed (but not necessarily valid) XML string into a + * JSONObject using the JsonML transform. Each XML tag is represented as + * a JSONObject with a "tagName" property. If the tag has attributes, then + * the attributes will be in the JSONObject as properties. If the tag + * contains children, the object will have a "childNodes" property which + * will be an array of strings and JsonML JSONObjects. + + * Comments, prologs, DTDs, and <[ [ ]]> are ignored. + * @param x An XMLTokener of the XML source text. + * @return A JSONObject containing the structured data from the XML string. + * @throws JSONException + */ + public static JSONObject toJSONObject(XMLTokener x) throws JSONException { + return (JSONObject)parse(x, false, null); + } + /** + * Convert a well-formed (but not necessarily valid) XML string into a + * JSONObject using the JsonML transform. Each XML tag is represented as + * a JSONObject with a "tagName" property. If the tag has attributes, then + * the attributes will be in the JSONObject as properties. If the tag + * contains children, the object will have a "childNodes" property which + * will be an array of strings and JsonML JSONObjects. + + * Comments, prologs, DTDs, and <[ [ ]]> are ignored. + * @param string The XML source text. + * @return A JSONObject containing the structured data from the XML string. + * @throws JSONException + */ + public static JSONObject toJSONObject(String string) throws JSONException { + return toJSONObject(new XMLTokener(string)); + } + + + /** + * Reverse the JSONML transformation, making an XML text from a JSONArray. + * @param ja A JSONArray. + * @return An XML string. + * @throws JSONException + */ + public static String toString(JSONArray ja) throws JSONException { + Object e; + int i; + JSONObject jo; + String k; + Iterator keys; + int length; + StringBuffer sb = new StringBuffer(); + String tagName; + String v; + +// Emit = length) { + sb.append('/'); + sb.append('>'); + } else { + sb.append('>'); + do { + e = ja.get(i); + i += 1; + if (e != null) { + if (e instanceof String) { + sb.append(XML.escape(e.toString())); + } else if (e instanceof JSONObject) { + sb.append(toString((JSONObject)e)); + } else if (e instanceof JSONArray) { + sb.append(toString((JSONArray)e)); + } + } + } while (i < length); + sb.append('<'); + sb.append('/'); + sb.append(tagName); + sb.append('>'); + } + return sb.toString(); + } + + /** + * Reverse the JSONML transformation, making an XML text from a JSONObject. + * The JSONObject must contain a "tagName" property. If it has children, + * then it must have a "childNodes" property containing an array of objects. + * The other properties are attributes with string values. + * @param jo A JSONObject. + * @return An XML string. + * @throws JSONException + */ + public static String toString(JSONObject jo) throws JSONException { + StringBuffer sb = new StringBuffer(); + Object e; + int i; + JSONArray ja; + String k; + Iterator keys; + int len; + String tagName; + String v; + +//Emit '); + } else { + sb.append('>'); + len = ja.length(); + for (i = 0; i < len; i += 1) { + e = ja.get(i); + if (e != null) { + if (e instanceof String) { + sb.append(XML.escape(e.toString())); + } else if (e instanceof JSONObject) { + sb.append(toString((JSONObject)e)); + } else if (e instanceof JSONArray) { + sb.append(toString((JSONArray)e)); + } + } + } + sb.append('<'); + sb.append('/'); + sb.append(tagName); + sb.append('>'); + } + return sb.toString(); + } +} \ No newline at end of file diff --git a/source/java/org/json/JSONObject.java b/source/java/org/json/JSONObject.java new file mode 100644 index 0000000..e34a752 --- /dev/null +++ b/source/java/org/json/JSONObject.java @@ -0,0 +1,1584 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.io.IOException; +import java.io.Writer; +import java.lang.reflect.Field; +import java.lang.reflect.Modifier; +import java.lang.reflect.Method; +import java.util.Collection; +import java.util.HashMap; +import java.util.Iterator; +import java.util.Map; +import java.util.TreeSet; + +/** + * A JSONObject is an unordered collection of name/value pairs. Its + * external form is a string wrapped in curly braces with colons between the + * names and values, and commas between the values and names. The internal form + * is an object having get and opt methods for + * accessing the values by name, and put methods for adding or + * replacing values by name. The values can be any of these types: + * Boolean, JSONArray, JSONObject, + * Number, String, or the JSONObject.NULL + * object. A JSONObject constructor can be used to convert an external form + * JSON text into an internal form whose values can be retrieved with the + * get and opt methods, or to convert values into a + * JSON text using the put and toString methods. + * A get method returns a value if one can be found, and throws an + * exception if one cannot be found. An opt method returns a + * default value instead of throwing an exception, and so is useful for + * obtaining optional values. + *

+ * The generic get() and opt() methods return an + * object, which you can cast or query for type. There are also typed + * get and opt methods that do type checking and type + * coercion for you. + *

+ * The put methods adds values to an object. For example, 

+ *     myString = new JSONObject().put("JSON", "Hello, World!").toString();
+ * produces the string {"JSON": "Hello, World"}. + *

+ * The texts produced by the toString methods strictly conform to + * the JSON syntax rules. + * The constructors are more forgiving in the texts they will accept: + *

    + *
  • An extra , (comma) may appear just + * before the closing brace.
    • + *
  • Strings may be quoted with ' (single + * quote).
    • + *
  • Strings do not need to be quoted at all if they do not begin with a quote + * or single quote, and if they do not contain leading or trailing spaces, + * and if they do not contain any of these characters: + * { } [ ] / \ : , = ; # and if they do not look like numbers + * and if they are not the reserved words true, + * false, or null.
    • + *
  • Keys can be followed by = or => as well as + * by :.
    • + *
  • Values can be followed by ; (semicolon) as + * well as by , (comma).
    • + *
  • Numbers may have the 0x- (hex) prefix.
    • + *
+ * @author JSON.org + * @version 2010-05-17 + */ +public class JSONObject { + + /** + * JSONObject.NULL is equivalent to the value that JavaScript calls null, + * whilst Java's null is equivalent to the value that JavaScript calls + * undefined. + */ + private static final class Null { + + /** + * There is only intended to be a single instance of the NULL object, + * so the clone method returns itself. + * @return NULL. + */ + protected final Object clone() { + return this; + } + + + /** + * A Null object is equal to the null value and to itself. + * @param object An object to test for nullness. + * @return true if the object parameter is the JSONObject.NULL object + * or null. + */ + public boolean equals(Object object) { + return object == null || object == this; + } + + + /** + * Get the "null" string value. + * @return The string "null". + */ + public String toString() { + return "null"; + } + } + + + /** + * The map where the JSONObject's properties are kept. + */ + private Map map; + + + /** + * It is sometimes more convenient and less ambiguous to have a + * NULL object than to use Java's null value. + * JSONObject.NULL.equals(null) returns true. + * JSONObject.NULL.toString() returns "null". + */ + public static final Object NULL = new Null(); + + + /** + * Construct an empty JSONObject. + */ + public JSONObject() { + this.map = new HashMap(); + } + + + /** + * Construct a JSONObject from a subset of another JSONObject. + * An array of strings is used to identify the keys that should be copied. + * Missing keys are ignored. + * @param jo A JSONObject. + * @param names An array of strings. + * @throws JSONException + * @exception JSONException If a value is a non-finite number or if a name is duplicated. + */ + public JSONObject(JSONObject jo, String[] names) { + this(); + for (int i = 0; i < names.length; i += 1) { + try { + putOnce(names[i], jo.opt(names[i])); + } catch (Exception ignore) { + } + } + } + + + /** + * Construct a JSONObject from a JSONTokener. + * @param x A JSONTokener object containing the source string. + * @throws JSONException If there is a syntax error in the source string + * or a duplicated key. + */ + public JSONObject(JSONTokener x) throws JSONException { + this(); + char c; + String key; + + if (x.nextClean() != '{') { + throw x.syntaxError("A JSONObject text must begin with '{'"); + } + for (;;) { + c = x.nextClean(); + switch (c) { + case 0: + throw x.syntaxError("A JSONObject text must end with '}'"); + case '}': + return; + default: + x.back(); + key = x.nextValue().toString(); + } + + /* + * The key is followed by ':'. We will also tolerate '=' or '=>'. + */ + + c = x.nextClean(); + if (c == '=') { + if (x.next() != '>') { + x.back(); + } + } else if (c != ':') { + throw x.syntaxError("Expected a ':' after a key"); + } + putOnce(key, x.nextValue()); + + /* + * Pairs are separated by ','. We will also tolerate ';'. + */ + + switch (x.nextClean()) { + case ';': + case ',': + if (x.nextClean() == '}') { + return; + } + x.back(); + break; + case '}': + return; + default: + throw x.syntaxError("Expected a ',' or '}'"); + } + } + } + + + /** + * Construct a JSONObject from a Map. + * + * @param map A map object that can be used to initialize the contents of + * the JSONObject. + * @throws JSONException + */ + public JSONObject(Map map) { + this.map = new HashMap(); + if (map != null) { + Iterator i = map.entrySet().iterator(); + while (i.hasNext()) { + Map.Entry e = (Map.Entry)i.next(); + this.map.put(e.getKey(), wrap(e.getValue())); + } + } + } + + + /** + * Construct a JSONObject from an Object using bean getters. + * It reflects on all of the public methods of the object. + * For each of the methods with no parameters and a name starting + * with "get" or "is" followed by an uppercase letter, + * the method is invoked, and a key and the value returned from the getter method + * are put into the new JSONObject. + * + * The key is formed by removing the "get" or "is" prefix. + * If the second remaining character is not upper case, then the first + * character is converted to lower case. + * + * For example, if an object has a method named "getName", and + * if the result of calling object.getName() is "Larry Fine", + * then the JSONObject will contain "name": "Larry Fine". + * + * @param bean An object that has getter methods that should be used + * to make a JSONObject. + */ + public JSONObject(Object bean) { + this(); + populateMap(bean); + } + + + /** + * Construct a JSONObject from an Object, using reflection to find the + * public members. The resulting JSONObject's keys will be the strings + * from the names array, and the values will be the field values associated + * with those keys in the object. If a key is not found or not visible, + * then it will not be copied into the new JSONObject. + * @param object An object that has fields that should be used to make a + * JSONObject. + * @param names An array of strings, the names of the fields to be obtained + * from the object. + */ + public JSONObject(Object object, String names[]) { + this(); + Class c = object.getClass(); + for (int i = 0; i < names.length; i += 1) { + String name = names[i]; + try { + putOpt(name, c.getField(name).get(object)); + } catch (Exception ignore) { + } + } + } + + + /** + * Construct a JSONObject from a source JSON text string. + * This is the most commonly used JSONObject constructor. + * @param source A string beginning + * with { (left brace) and ending + * with } (right brace). + * @exception JSONException If there is a syntax error in the source + * string or a duplicated key. + */ + public JSONObject(String source) throws JSONException { + this(new JSONTokener(source)); + } + + + /** + * Accumulate values under a key. It is similar to the put method except + * that if there is already an object stored under the key then a + * JSONArray is stored under the key to hold all of the accumulated values. + * If there is already a JSONArray, then the new value is appended to it. + * In contrast, the put method replaces the previous value. + * @param key A key string. + * @param value An object to be accumulated under the key. + * @return this. + * @throws JSONException If the value is an invalid number + * or if the key is null. + */ + public JSONObject accumulate(String key, Object value) + throws JSONException { + testValidity(value); + Object o = opt(key); + if (o == null) { + put(key, value instanceof JSONArray ? + new JSONArray().put(value) : + value); + } else if (o instanceof JSONArray) { + ((JSONArray)o).put(value); + } else { + put(key, new JSONArray().put(o).put(value)); + } + return this; + } + + + /** + * Append values to the array under a key. If the key does not exist in the + * JSONObject, then the key is put in the JSONObject with its value being a + * JSONArray containing the value parameter. If the key was already + * associated with a JSONArray, then the value parameter is appended to it. + * @param key A key string. + * @param value An object to be accumulated under the key. + * @return this. + * @throws JSONException If the key is null or if the current value + * associated with the key is not a JSONArray. + */ + public JSONObject append(String key, Object value) throws JSONException { + testValidity(value); + Object o = opt(key); + if (o == null) { + put(key, new JSONArray().put(value)); + } else if (o instanceof JSONArray) { + put(key, ((JSONArray)o).put(value)); + } else { + throw new JSONException("JSONObject[" + key + + "] is not a JSONArray."); + } + return this; + } + + + /** + * Produce a string from a double. The string "null" will be returned if + * the number is not finite. + * @param d A double. + * @return A String. + */ + static public String doubleToString(double d) { + if (Double.isInfinite(d) || Double.isNaN(d)) { + return "null"; + } + +// Shave off trailing zeros and decimal point, if possible. + + String s = Double.toString(d); + if (s.indexOf('.') > 0 && s.indexOf('e') < 0 && s.indexOf('E') < 0) { + while (s.endsWith("0")) { + s = s.substring(0, s.length() - 1); + } + if (s.endsWith(".")) { + s = s.substring(0, s.length() - 1); + } + } + return s; + } + + + /** + * Get the value object associated with a key. + * + * @param key A key string. + * @return The object associated with the key. + * @throws JSONException if the key is not found. + */ + public Object get(String key) throws JSONException { + Object o = opt(key); + if (o == null) { + throw new JSONException("JSONObject[" + quote(key) + + "] not found."); + } + return o; + } + + + /** + * Get the boolean value associated with a key. + * + * @param key A key string. + * @return The truth. + * @throws JSONException + * if the value is not a Boolean or the String "true" or "false". + */ + public boolean getBoolean(String key) throws JSONException { + Object o = get(key); + if (o.equals(Boolean.FALSE) || + (o instanceof String && + ((String)o).equalsIgnoreCase("false"))) { + return false; + } else if (o.equals(Boolean.TRUE) || + (o instanceof String && + ((String)o).equalsIgnoreCase("true"))) { + return true; + } + throw new JSONException("JSONObject[" + quote(key) + + "] is not a Boolean."); + } + + + /** + * Get the double value associated with a key. + * @param key A key string. + * @return The numeric value. + * @throws JSONException if the key is not found or + * if the value is not a Number object and cannot be converted to a number. + */ + public double getDouble(String key) throws JSONException { + Object o = get(key); + try { + return o instanceof Number ? + ((Number)o).doubleValue() : + Double.valueOf((String)o).doubleValue(); + } catch (Exception e) { + throw new JSONException("JSONObject[" + quote(key) + + "] is not a number."); + } + } + + + /** + * Get the int value associated with a key. + * + * @param key A key string. + * @return The integer value. + * @throws JSONException if the key is not found or if the value cannot + * be converted to an integer. + */ + public int getInt(String key) throws JSONException { + Object o = get(key); + try { + return o instanceof Number ? + ((Number)o).intValue() : + Integer.parseInt((String)o); + } catch (Exception e) { + throw new JSONException("JSONObject[" + quote(key) + + "] is not an int."); + } + } + + + /** + * Get the JSONArray value associated with a key. + * + * @param key A key string. + * @return A JSONArray which is the value. + * @throws JSONException if the key is not found or + * if the value is not a JSONArray. + */ + public JSONArray getJSONArray(String key) throws JSONException { + Object o = get(key); + if (o instanceof JSONArray) { + return (JSONArray)o; + } + throw new JSONException("JSONObject[" + quote(key) + + "] is not a JSONArray."); + } + + + /** + * Get the JSONObject value associated with a key. + * + * @param key A key string. + * @return A JSONObject which is the value. + * @throws JSONException if the key is not found or + * if the value is not a JSONObject. + */ + public JSONObject getJSONObject(String key) throws JSONException { + Object o = get(key); + if (o instanceof JSONObject) { + return (JSONObject)o; + } + throw new JSONException("JSONObject[" + quote(key) + + "] is not a JSONObject."); + } + + + /** + * Get the long value associated with a key. + * + * @param key A key string. + * @return The long value. + * @throws JSONException if the key is not found or if the value cannot + * be converted to a long. + */ + public long getLong(String key) throws JSONException { + Object o = get(key); + try { + return o instanceof Number ? + ((Number)o).longValue() : + Long.parseLong((String)o); + } catch (Exception e) { + throw new JSONException("JSONObject[" + quote(key) + + "] is not a long."); + } + } + + + /** + * Get an array of field names from a JSONObject. + * + * @return An array of field names, or null if there are no names. + */ + public static String[] getNames(JSONObject jo) { + int length = jo.length(); + if (length == 0) { + return null; + } + Iterator i = jo.keys(); + String[] names = new String[length]; + int j = 0; + while (i.hasNext()) { + names[j] = (String)i.next(); + j += 1; + } + return names; + } + + + /** + * Get an array of field names from an Object. + * + * @return An array of field names, or null if there are no names. + */ + public static String[] getNames(Object object) { + if (object == null) { + return null; + } + Class klass = object.getClass(); + Field[] fields = klass.getFields(); + int length = fields.length; + if (length == 0) { + return null; + } + String[] names = new String[length]; + for (int i = 0; i < length; i += 1) { + names[i] = fields[i].getName(); + } + return names; + } + + + /** + * Get the string associated with a key. + * + * @param key A key string. + * @return A string which is the value. + * @throws JSONException if the key is not found. + */ + public String getString(String key) throws JSONException { + return get(key).toString(); + } + + + /** + * Determine if the JSONObject contains a specific key. + * @param key A key string. + * @return true if the key exists in the JSONObject. + */ + public boolean has(String key) { + return this.map.containsKey(key); + } + + + /** + * Increment a property of a JSONObject. If there is no such property, + * create one with a value of 1. If there is such a property, and if + * it is an Integer, Long, Double, or Float, then add one to it. + * @param key A key string. + * @return this. + * @throws JSONException If there is already a property with this name + * that is not an Integer, Long, Double, or Float. + */ + public JSONObject increment(String key) throws JSONException { + Object value = opt(key); + if (value == null) { + put(key, 1); + } else { + if (value instanceof Integer) { + put(key, ((Integer)value).intValue() + 1); + } else if (value instanceof Long) { + put(key, ((Long)value).longValue() + 1); + } else if (value instanceof Double) { + put(key, ((Double)value).doubleValue() + 1); + } else if (value instanceof Float) { + put(key, ((Float)value).floatValue() + 1); + } else { + throw new JSONException("Unable to increment [" + key + "]."); + } + } + return this; + } + + + /** + * Determine if the value associated with the key is null or if there is + * no value. + * @param key A key string. + * @return true if there is no value associated with the key or if + * the value is the JSONObject.NULL object. + */ + public boolean isNull(String key) { + return JSONObject.NULL.equals(opt(key)); + } + + + /** + * Get an enumeration of the keys of the JSONObject. + * + * @return An iterator of the keys. + */ + public Iterator keys() { + return this.map.keySet().iterator(); + } + + + /** + * Get the number of keys stored in the JSONObject. + * + * @return The number of keys in the JSONObject. + */ + public int length() { + return this.map.size(); + } + + + /** + * Produce a JSONArray containing the names of the elements of this + * JSONObject. + * @return A JSONArray containing the key strings, or null if the JSONObject + * is empty. + */ + public JSONArray names() { + JSONArray ja = new JSONArray(); + Iterator keys = keys(); + while (keys.hasNext()) { + ja.put(keys.next()); + } + return ja.length() == 0 ? null : ja; + } + + /** + * Produce a string from a Number. + * @param n A Number + * @return A String. + * @throws JSONException If n is a non-finite number. + */ + static public String numberToString(Number n) + throws JSONException { + if (n == null) { + throw new JSONException("Null pointer"); + } + testValidity(n); + +// Shave off trailing zeros and decimal point, if possible. + + String s = n.toString(); + if (s.indexOf('.') > 0 && s.indexOf('e') < 0 && s.indexOf('E') < 0) { + while (s.endsWith("0")) { + s = s.substring(0, s.length() - 1); + } + if (s.endsWith(".")) { + s = s.substring(0, s.length() - 1); + } + } + return s; + } + + + /** + * Get an optional value associated with a key. + * @param key A key string. + * @return An object which is the value, or null if there is no value. + */ + public Object opt(String key) { + return key == null ? null : this.map.get(key); + } + + + /** + * Get an optional boolean associated with a key. + * It returns false if there is no such key, or if the value is not + * Boolean.TRUE or the String "true". + * + * @param key A key string. + * @return The truth. + */ + public boolean optBoolean(String key) { + return optBoolean(key, false); + } + + + /** + * Get an optional boolean associated with a key. + * It returns the defaultValue if there is no such key, or if it is not + * a Boolean or the String "true" or "false" (case insensitive). + * + * @param key A key string. + * @param defaultValue The default. + * @return The truth. + */ + public boolean optBoolean(String key, boolean defaultValue) { + try { + return getBoolean(key); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get an optional double associated with a key, + * or NaN if there is no such key or if its value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A string which is the key. + * @return An object which is the value. + */ + public double optDouble(String key) { + return optDouble(key, Double.NaN); + } + + + /** + * Get an optional double associated with a key, or the + * defaultValue if there is no such key or if its value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A key string. + * @param defaultValue The default. + * @return An object which is the value. + */ + public double optDouble(String key, double defaultValue) { + try { + Object o = opt(key); + return o instanceof Number ? ((Number)o).doubleValue() : + new Double((String)o).doubleValue(); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get an optional int value associated with a key, + * or zero if there is no such key or if the value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A key string. + * @return An object which is the value. + */ + public int optInt(String key) { + return optInt(key, 0); + } + + + /** + * Get an optional int value associated with a key, + * or the default if there is no such key or if the value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A key string. + * @param defaultValue The default. + * @return An object which is the value. + */ + public int optInt(String key, int defaultValue) { + try { + return getInt(key); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get an optional JSONArray associated with a key. + * It returns null if there is no such key, or if its value is not a + * JSONArray. + * + * @param key A key string. + * @return A JSONArray which is the value. + */ + public JSONArray optJSONArray(String key) { + Object o = opt(key); + return o instanceof JSONArray ? (JSONArray)o : null; + } + + + /** + * Get an optional JSONObject associated with a key. + * It returns null if there is no such key, or if its value is not a + * JSONObject. + * + * @param key A key string. + * @return A JSONObject which is the value. + */ + public JSONObject optJSONObject(String key) { + Object o = opt(key); + return o instanceof JSONObject ? (JSONObject)o : null; + } + + + /** + * Get an optional long value associated with a key, + * or zero if there is no such key or if the value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A key string. + * @return An object which is the value. + */ + public long optLong(String key) { + return optLong(key, 0); + } + + + /** + * Get an optional long value associated with a key, + * or the default if there is no such key or if the value is not a number. + * If the value is a string, an attempt will be made to evaluate it as + * a number. + * + * @param key A key string. + * @param defaultValue The default. + * @return An object which is the value. + */ + public long optLong(String key, long defaultValue) { + try { + return getLong(key); + } catch (Exception e) { + return defaultValue; + } + } + + + /** + * Get an optional string associated with a key. + * It returns an empty string if there is no such key. If the value is not + * a string and is not null, then it is coverted to a string. + * + * @param key A key string. + * @return A string which is the value. + */ + public String optString(String key) { + return optString(key, ""); + } + + + /** + * Get an optional string associated with a key. + * It returns the defaultValue if there is no such key. + * + * @param key A key string. + * @param defaultValue The default. + * @return A string which is the value. + */ + public String optString(String key, String defaultValue) { + Object o = opt(key); + return o != null ? o.toString() : defaultValue; + } + + + private void populateMap(Object bean) { + Class klass = bean.getClass(); + +// If klass is a System class then set includeSuperClass to false. + + boolean includeSuperClass = klass.getClassLoader() != null; + + Method[] methods = (includeSuperClass) ? + klass.getMethods() : klass.getDeclaredMethods(); + for (int i = 0; i < methods.length; i += 1) { + try { + Method method = methods[i]; + if (Modifier.isPublic(method.getModifiers())) { + String name = method.getName(); + String key = ""; + if (name.startsWith("get")) { + if (name.equals("getClass") || + name.equals("getDeclaringClass")) { + key = ""; + } else { + key = name.substring(3); + } + } else if (name.startsWith("is")) { + key = name.substring(2); + } + if (key.length() > 0 && + Character.isUpperCase(key.charAt(0)) && + method.getParameterTypes().length == 0) { + if (key.length() == 1) { + key = key.toLowerCase(); + } else if (!Character.isUpperCase(key.charAt(1))) { + key = key.substring(0, 1).toLowerCase() + + key.substring(1); + } + + Object result = method.invoke(bean, (Object[])null); + + map.put(key, wrap(result)); + } + } + } catch (Exception ignore) { + } + } + } + + + /** + * Put a key/boolean pair in the JSONObject. + * + * @param key A key string. + * @param value A boolean which is the value. + * @return this. + * @throws JSONException If the key is null. + */ + public JSONObject put(String key, boolean value) throws JSONException { + put(key, value ? Boolean.TRUE : Boolean.FALSE); + return this; + } + + + /** + * Put a key/value pair in the JSONObject, where the value will be a + * JSONArray which is produced from a Collection. + * @param key A key string. + * @param value A Collection value. + * @return this. + * @throws JSONException + */ + public JSONObject put(String key, Collection value) throws JSONException { + put(key, new JSONArray(value)); + return this; + } + + + /** + * Put a key/double pair in the JSONObject. + * + * @param key A key string. + * @param value A double which is the value. + * @return this. + * @throws JSONException If the key is null or if the number is invalid. + */ + public JSONObject put(String key, double value) throws JSONException { + put(key, new Double(value)); + return this; + } + + + /** + * Put a key/int pair in the JSONObject. + * + * @param key A key string. + * @param value An int which is the value. + * @return this. + * @throws JSONException If the key is null. + */ + public JSONObject put(String key, int value) throws JSONException { + put(key, new Integer(value)); + return this; + } + + + /** + * Put a key/long pair in the JSONObject. + * + * @param key A key string. + * @param value A long which is the value. + * @return this. + * @throws JSONException If the key is null. + */ + public JSONObject put(String key, long value) throws JSONException { + put(key, new Long(value)); + return this; + } + + + /** + * Put a key/value pair in the JSONObject, where the value will be a + * JSONObject which is produced from a Map. + * @param key A key string. + * @param value A Map value. + * @return this. + * @throws JSONException + */ + public JSONObject put(String key, Map value) throws JSONException { + put(key, new JSONObject(value)); + return this; + } + + + /** + * Put a key/value pair in the JSONObject. If the value is null, + * then the key will be removed from the JSONObject if it is present. + * @param key A key string. + * @param value An object which is the value. It should be of one of these + * types: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, + * or the JSONObject.NULL object. + * @return this. + * @throws JSONException If the value is non-finite number + * or if the key is null. + */ + public JSONObject put(String key, Object value) throws JSONException { + if (key == null) { + throw new JSONException("Null key."); + } + if (value != null) { + testValidity(value); + this.map.put(key, value); + } else { + remove(key); + } + return this; + } + + + /** + * Put a key/value pair in the JSONObject, but only if the key and the + * value are both non-null, and only if there is not already a member + * with that name. + * @param key + * @param value + * @return his. + * @throws JSONException if the key is a duplicate + */ + public JSONObject putOnce(String key, Object value) throws JSONException { + if (key != null && value != null) { + if (opt(key) != null) { + throw new JSONException("Duplicate key \"" + key + "\""); + } + put(key, value); + } + return this; + } + + + /** + * Put a key/value pair in the JSONObject, but only if the + * key and the value are both non-null. + * @param key A key string. + * @param value An object which is the value. It should be of one of these + * types: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, + * or the JSONObject.NULL object. + * @return this. + * @throws JSONException If the value is a non-finite number. + */ + public JSONObject putOpt(String key, Object value) throws JSONException { + if (key != null && value != null) { + put(key, value); + } + return this; + } + + + /** + * Produce a string in double quotes with backslash sequences in all the + * right places. A backslash will be inserted within = '\u0080' && c < '\u00a0') || + (c >= '\u2000' && c < '\u2100')) { + t = "000" + Integer.toHexString(c); + sb.append("\\u" + t.substring(t.length() - 4)); + } else { + sb.append(c); + } + } + } + sb.append('"'); + return sb.toString(); + } + + /** + * Remove a name and its value, if present. + * @param key The name to be removed. + * @return The value that was associated with the name, + * or null if there was no value. + */ + public Object remove(String key) { + return this.map.remove(key); + } + + /** + * Get an enumeration of the keys of the JSONObject. + * The keys will be sorted alphabetically. + * + * @return An iterator of the keys. + */ + public Iterator sortedKeys() { + return new TreeSet(this.map.keySet()).iterator(); + } + + /** + * Try to convert a string into a number, boolean, or null. If the string + * can't be converted, return the string. + * @param s A String. + * @return A simple JSON value. + */ + static public Object stringToValue(String s) { + if (s.equals("")) { + return s; + } + if (s.equalsIgnoreCase("true")) { + return Boolean.TRUE; + } + if (s.equalsIgnoreCase("false")) { + return Boolean.FALSE; + } + if (s.equalsIgnoreCase("null")) { + return JSONObject.NULL; + } + + /* + * If it might be a number, try converting it. + * We support the non-standard 0x- convention. + * If a number cannot be produced, then the value will just + * be a string. Note that the 0x-, plus, and implied string + * conventions are non-standard. A JSON parser may accept + * non-JSON forms as long as it accepts all correct JSON forms. + */ + + char b = s.charAt(0); + if ((b >= '0' && b <= '9') || b == '.' || b == '-' || b == '+') { + if (b == '0' && s.length() > 2 && + (s.charAt(1) == 'x' || s.charAt(1) == 'X')) { + try { + return new Integer(Integer.parseInt(s.substring(2), 16)); + } catch (Exception ignore) { + } + } + try { + if (s.indexOf('.') > -1 || + s.indexOf('e') > -1 || s.indexOf('E') > -1) { + return Double.valueOf(s); + } else { + Long myLong = new Long(s); + if (myLong.longValue() == myLong.intValue()) { + return new Integer(myLong.intValue()); + } else { + return myLong; + } + } + } catch (Exception ignore) { + } + } + return s; + } + + + /** + * Throw an exception if the object is an NaN or infinite number. + * @param o The object to test. + * @throws JSONException If o is a non-finite number. + */ + static void testValidity(Object o) throws JSONException { + if (o != null) { + if (o instanceof Double) { + if (((Double)o).isInfinite() || ((Double)o).isNaN()) { + throw new JSONException( + "JSON does not allow non-finite numbers."); + } + } else if (o instanceof Float) { + if (((Float)o).isInfinite() || ((Float)o).isNaN()) { + throw new JSONException( + "JSON does not allow non-finite numbers."); + } + } + } + } + + + /** + * Produce a JSONArray containing the values of the members of this + * JSONObject. + * @param names A JSONArray containing a list of key strings. This + * determines the sequence of the values in the result. + * @return A JSONArray of values. + * @throws JSONException If any of the values are non-finite numbers. + */ + public JSONArray toJSONArray(JSONArray names) throws JSONException { + if (names == null || names.length() == 0) { + return null; + } + JSONArray ja = new JSONArray(); + for (int i = 0; i < names.length(); i += 1) { + ja.put(this.opt(names.getString(i))); + } + return ja; + } + + /** + * Make a JSON text of this JSONObject. For compactness, no whitespace + * is added. If this would not result in a syntactically correct JSON text, + * then null will be returned instead. + *

+ * Warning: This method assumes that the data structure is acyclical. + * + * @return a printable, displayable, portable, transmittable + * representation of the object, beginning + * with { (left brace) and ending + * with } (right brace). + */ + public String toString() { + try { + Iterator keys = keys(); + StringBuffer sb = new StringBuffer("{"); + + while (keys.hasNext()) { + if (sb.length() > 1) { + sb.append(','); + } + Object o = keys.next(); + sb.append(quote(o.toString())); + sb.append(':'); + sb.append(valueToString(this.map.get(o))); + } + sb.append('}'); + return sb.toString(); + } catch (Exception e) { + return null; + } + } + + + /** + * Make a prettyprinted JSON text of this JSONObject. + *

+ * Warning: This method assumes that the data structure is acyclical. + * @param indentFactor The number of spaces to add to each level of + * indentation. + * @return a printable, displayable, portable, transmittable + * representation of the object, beginning + * with { (left brace) and ending + * with } (right brace). + * @throws JSONException If the object contains an invalid number. + */ + public String toString(int indentFactor) throws JSONException { + return toString(indentFactor, 0); + } + + + /** + * Make a prettyprinted JSON text of this JSONObject. + *

+ * Warning: This method assumes that the data structure is acyclical. + * @param indentFactor The number of spaces to add to each level of + * indentation. + * @param indent The indentation of the top level. + * @return a printable, displayable, transmittable + * representation of the object, beginning + * with { (left brace) and ending + * with } (right brace). + * @throws JSONException If the object contains an invalid number. + */ + String toString(int indentFactor, int indent) throws JSONException { + int j; + int n = length(); + if (n == 0) { + return "{}"; + } + Iterator keys = sortedKeys(); + StringBuffer sb = new StringBuffer("{"); + int newindent = indent + indentFactor; + Object o; + if (n == 1) { + o = keys.next(); + sb.append(quote(o.toString())); + sb.append(": "); + sb.append(valueToString(this.map.get(o), indentFactor, + indent)); + } else { + while (keys.hasNext()) { + o = keys.next(); + if (sb.length() > 1) { + sb.append(",\n"); + } else { + sb.append('\n'); + } + for (j = 0; j < newindent; j += 1) { + sb.append(' '); + } + sb.append(quote(o.toString())); + sb.append(": "); + sb.append(valueToString(this.map.get(o), indentFactor, + newindent)); + } + if (sb.length() > 1) { + sb.append('\n'); + for (j = 0; j < indent; j += 1) { + sb.append(' '); + } + } + } + sb.append('}'); + return sb.toString(); + } + + + /** + * Make a JSON text of an Object value. If the object has an + * value.toJSONString() method, then that method will be used to produce + * the JSON text. The method is required to produce a strictly + * conforming text. If the object does not contain a toJSONString + * method (which is the most common case), then a text will be + * produced by other means. If the value is an array or Collection, + * then a JSONArray will be made from it and its toJSONString method + * will be called. If the value is a MAP, then a JSONObject will be made + * from it and its toJSONString method will be called. Otherwise, the + * value's toString method will be called, and the result will be quoted. + * + *

+ * Warning: This method assumes that the data structure is acyclical. + * @param value The value to be serialized. + * @return a printable, displayable, transmittable + * representation of the object, beginning + * with { (left brace) and ending + * with } (right brace). + * @throws JSONException If the value is or contains an invalid number. + */ + static String valueToString(Object value) throws JSONException { + if (value == null || value.equals(null)) { + return "null"; + } + if (value instanceof JSONString) { + Object o; + try { + o = ((JSONString)value).toJSONString(); + } catch (Exception e) { + throw new JSONException(e); + } + if (o instanceof String) { + return (String)o; + } + throw new JSONException("Bad value from toJSONString: " + o); + } + if (value instanceof Number) { + return numberToString((Number) value); + } + if (value instanceof Boolean || value instanceof JSONObject || + value instanceof JSONArray) { + return value.toString(); + } + if (value instanceof Map) { + return new JSONObject((Map)value).toString(); + } + if (value instanceof Collection) { + return new JSONArray((Collection)value).toString(); + } + if (value.getClass().isArray()) { + return new JSONArray(value).toString(); + } + return quote(value.toString()); + } + + + /** + * Make a prettyprinted JSON text of an object value. + *

+ * Warning: This method assumes that the data structure is acyclical. + * @param value The value to be serialized. + * @param indentFactor The number of spaces to add to each level of + * indentation. + * @param indent The indentation of the top level. + * @return a printable, displayable, transmittable + * representation of the object, beginning + * with { (left brace) and ending + * with } (right brace). + * @throws JSONException If the object contains an invalid number. + */ + static String valueToString(Object value, int indentFactor, int indent) + throws JSONException { + if (value == null || value.equals(null)) { + return "null"; + } + try { + if (value instanceof JSONString) { + Object o = ((JSONString)value).toJSONString(); + if (o instanceof String) { + return (String)o; + } + } + } catch (Exception ignore) { + } + if (value instanceof Number) { + return numberToString((Number) value); + } + if (value instanceof Boolean) { + return value.toString(); + } + if (value instanceof JSONObject) { + return ((JSONObject)value).toString(indentFactor, indent); + } + if (value instanceof JSONArray) { + return ((JSONArray)value).toString(indentFactor, indent); + } + if (value instanceof Map) { + return new JSONObject((Map)value).toString(indentFactor, indent); + } + if (value instanceof Collection) { + return new JSONArray((Collection)value).toString(indentFactor, indent); + } + if (value.getClass().isArray()) { + return new JSONArray(value).toString(indentFactor, indent); + } + return quote(value.toString()); + } + + + /** + * Wrap an object, if necessary. If the object is null, return the NULL + * object. If it is an array or collection, wrap it in a JSONArray. If + * it is a map, wrap it in a JSONObject. If it is a standard property + * (Double, String, et al) then it is already wrapped. Otherwise, if it + * comes from one of the java packages, turn it into a string. And if + * it doesn't, try to wrap it in a JSONObject. If the wrapping fails, + * then null is returned. + * + * @param object The object to wrap + * @return The wrapped value + */ + static Object wrap(Object object) { + try { + if (object == null) { + return NULL; + } + if (object instanceof JSONObject || object instanceof JSONArray || + NULL.equals(object) || object instanceof JSONString || + object instanceof Byte || object instanceof Character || + object instanceof Short || object instanceof Integer || + object instanceof Long || object instanceof Boolean || + object instanceof Float || object instanceof Double || + object instanceof String) { + return object; + } + + if (object instanceof Collection) { + return new JSONArray((Collection)object); + } + if (object.getClass().isArray()) { + return new JSONArray(object); + } + if (object instanceof Map) { + return new JSONObject((Map)object); + } + Package objectPackage = object.getClass().getPackage(); + String objectPackageName = ( objectPackage != null ? objectPackage.getName() : "" ); + if (objectPackageName.startsWith("java.") || + objectPackageName.startsWith("javax.") || + object.getClass().getClassLoader() == null) { + return object.toString(); + } + return new JSONObject(object); + } catch(Exception exception) { + return null; + } + } + + + /** + * Write the contents of the JSONObject as JSON text to a writer. + * For compactness, no whitespace is added. + *

+ * Warning: This method assumes that the data structure is acyclical. + * + * @return The writer. + * @throws JSONException + */ + public Writer write(Writer writer) throws JSONException { + try { + boolean b = false; + Iterator keys = keys(); + writer.write('{'); + + while (keys.hasNext()) { + if (b) { + writer.write(','); + } + Object k = keys.next(); + writer.write(quote(k.toString())); + writer.write(':'); + Object v = this.map.get(k); + if (v instanceof JSONObject) { + ((JSONObject)v).write(writer); + } else if (v instanceof JSONArray) { + ((JSONArray)v).write(writer); + } else { + writer.write(valueToString(v)); + } + b = true; + } + writer.write('}'); + return writer; + } catch (IOException exception) { + throw new JSONException(exception); + } + } +} \ No newline at end of file diff --git a/source/java/org/json/JSONString.java b/source/java/org/json/JSONString.java new file mode 100644 index 0000000..17f4384 --- /dev/null +++ b/source/java/org/json/JSONString.java @@ -0,0 +1,18 @@ +package org.json; +/** + * The JSONString interface allows a toJSONString() + * method so that a class can change the behavior of + * JSONObject.toString(), JSONArray.toString(), + * and JSONWriter.value(Object). The + * toJSONString method will be used instead of the default behavior + * of using the Object's toString() method and quoting the result. + */ +public interface JSONString { + /** + * The toJSONString method allows a class to produce its own JSON + * serialization. + * + * @return A strictly syntactically correct JSON text. + */ + public String toJSONString(); +} diff --git a/source/java/org/json/JSONStringer.java b/source/java/org/json/JSONStringer.java new file mode 100644 index 0000000..25c2e5d --- /dev/null +++ b/source/java/org/json/JSONStringer.java @@ -0,0 +1,78 @@ +package org.json; + +/* +Copyright (c) 2006 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +import java.io.StringWriter; + +/** + * JSONStringer provides a quick and convenient way of producing JSON text. + * The texts produced strictly conform to JSON syntax rules. No whitespace is + * added, so the results are ready for transmission or storage. Each instance of + * JSONStringer can produce one JSON text. + *

+ * A JSONStringer instance provides a value method for appending + * values to the + * text, and a key + * method for adding keys before values in objects. There are array + * and endArray methods that make and bound array values, and + * object and endObject methods which make and bound + * object values. All of these methods return the JSONWriter instance, + * permitting cascade style. For example, 

+ * myString = new JSONStringer()
+ *     .object()
+ *         .key("JSON")
+ *         .value("Hello, World!")
+ *     .endObject()
+ *     .toString();
which produces the string 
+ * {"JSON":"Hello, World!"}
+ *

+ * The first method called must be array or object. + * There are no methods for adding commas or colons. JSONStringer adds them for + * you. Objects and arrays can be nested up to 20 levels deep. + *

+ * This can sometimes be easier than using a JSONObject to build a string. + * @author JSON.org + * @version 2008-09-18 + */ +public class JSONStringer extends JSONWriter { + /** + * Make a fresh JSONStringer. It can be used to build one JSON text. + */ + public JSONStringer() { + super(new StringWriter()); + } + + /** + * Return the JSON text. This method is used to obtain the product of the + * JSONStringer instance. It will return null if there was a + * problem in the construction of the JSON text (such as the calls to + * array were not properly balanced with calls to + * endArray). + * @return The JSON text. + */ + public String toString() { + return this.mode == 'd' ? this.writer.toString() : null; + } +} diff --git a/source/java/org/json/JSONTokener.java b/source/java/org/json/JSONTokener.java new file mode 100644 index 0000000..fe52f31 --- /dev/null +++ b/source/java/org/json/JSONTokener.java @@ -0,0 +1,435 @@ +package org.json; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.Reader; +import java.io.StringReader; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +/** + * A JSONTokener takes a source string and extracts characters and tokens from + * it. It is used by the JSONObject and JSONArray constructors to parse + * JSON source strings. + * @author JSON.org + * @version 2010-02-02 + */ +public class JSONTokener { + + private int character; + private boolean eof; + private int index; + private int line; + private char previous; + private Reader reader; + private boolean usePrevious; + + + /** + * Construct a JSONTokener from a reader. + * + * @param reader A reader. + */ + public JSONTokener(Reader reader) { + this.reader = reader.markSupported() ? + reader : new BufferedReader(reader); + this.eof = false; + this.usePrevious = false; + this.previous = 0; + this.index = 0; + this.character = 1; + this.line = 1; + } + + + /** + * Construct a JSONTokener from a string. + * + * @param s A source string. + */ + public JSONTokener(String s) { + this(new StringReader(s)); + } + + + /** + * Back up one character. This provides a sort of lookahead capability, + * so that you can test for a digit or letter before attempting to parse + * the next number or identifier. + */ + public void back() throws JSONException { + if (usePrevious || index <= 0) { + throw new JSONException("Stepping back two steps is not supported"); + } + this.index -= 1; + this.character -= 1; + this.usePrevious = true; + this.eof = false; + } + + + /** + * Get the hex value of a character (base16). + * @param c A character between '0' and '9' or between 'A' and 'F' or + * between 'a' and 'f'. + * @return An int between 0 and 15, or -1 if c was not a hex digit. + */ + public static int dehexchar(char c) { + if (c >= '0' && c <= '9') { + return c - '0'; + } + if (c >= 'A' && c <= 'F') { + return c - ('A' - 10); + } + if (c >= 'a' && c <= 'f') { + return c - ('a' - 10); + } + return -1; + } + + public boolean end() { + return eof && !usePrevious; + } + + + /** + * Determine if the source string still contains characters that next() + * can consume. + * @return true if not yet at the end of the source. + */ + public boolean more() throws JSONException { + next(); + if (end()) { + return false; + } + back(); + return true; + } + + + /** + * Get the next character in the source string. + * + * @return The next character, or 0 if past the end of the source string. + */ + public char next() throws JSONException { + int c; + if (this.usePrevious) { + this.usePrevious = false; + c = this.previous; + } else { + try { + c = this.reader.read(); + } catch (IOException exception) { + throw new JSONException(exception); + } + + if (c <= 0) { // End of stream + this.eof = true; + c = 0; + } + } + this.index += 1; + if (this.previous == '\r') { + this.line += 1; + this.character = c == '\n' ? 0 : 1; + } else if (c == '\n') { + this.line += 1; + this.character = 0; + } else { + this.character += 1; + } + this.previous = (char) c; + return this.previous; + } + + + /** + * Consume the next character, and check that it matches a specified + * character. + * @param c The character to match. + * @return The character. + * @throws JSONException if the character does not match. + */ + public char next(char c) throws JSONException { + char n = next(); + if (n != c) { + throw syntaxError("Expected '" + c + "' and instead saw '" + + n + "'"); + } + return n; + } + + + /** + * Get the next n characters. + * + * @param n The number of characters to take. + * @return A string of n characters. + * @throws JSONException + * Substring bounds error if there are not + * n characters remaining in the source string. + */ + public String next(int n) throws JSONException { + if (n == 0) { + return ""; + } + + char[] buffer = new char[n]; + int pos = 0; + + while (pos < n) { + buffer[pos] = next(); + if (end()) { + throw syntaxError("Substring bounds error"); + } + pos += 1; + } + return new String(buffer); + } + + + /** + * Get the next char in the string, skipping whitespace. + * @throws JSONException + * @return A character, or 0 if there are no more characters. + */ + public char nextClean() throws JSONException { + for (;;) { + char c = next(); + if (c == 0 || c > ' ') { + return c; + } + } + } + + + /** + * Return the characters up to the next close quote character. + * Backslash processing is done. The formal JSON format does not + * allow strings in single quotes, but an implementation is allowed to + * accept them. + * @param quote The quoting character, either + * " (double quote) or + * ' (single quote). + * @return A String. + * @throws JSONException Unterminated string. + */ + public String nextString(char quote) throws JSONException { + char c; + StringBuffer sb = new StringBuffer(); + for (;;) { + c = next(); + switch (c) { + case 0: + case '\n': + case '\r': + throw syntaxError("Unterminated string"); + case '\\': + c = next(); + switch (c) { + case 'b': + sb.append('\b'); + break; + case 't': + sb.append('\t'); + break; + case 'n': + sb.append('\n'); + break; + case 'f': + sb.append('\f'); + break; + case 'r': + sb.append('\r'); + break; + case 'u': + sb.append((char)Integer.parseInt(next(4), 16)); + break; + case '"': + case '\'': + case '\\': + case '/': + sb.append(c); + break; + default: + throw syntaxError("Illegal escape."); + } + break; + default: + if (c == quote) { + return sb.toString(); + } + sb.append(c); + } + } + } + + + /** + * Get the text up but not including the specified character or the + * end of line, whichever comes first. + * @param d A delimiter character. + * @return A string. + */ + public String nextTo(char d) throws JSONException { + StringBuffer sb = new StringBuffer(); + for (;;) { + char c = next(); + if (c == d || c == 0 || c == '\n' || c == '\r') { + if (c != 0) { + back(); + } + return sb.toString().trim(); + } + sb.append(c); + } + } + + + /** + * Get the text up but not including one of the specified delimiter + * characters or the end of line, whichever comes first. + * @param delimiters A set of delimiter characters. + * @return A string, trimmed. + */ + public String nextTo(String delimiters) throws JSONException { + char c; + StringBuffer sb = new StringBuffer(); + for (;;) { + c = next(); + if (delimiters.indexOf(c) >= 0 || c == 0 || + c == '\n' || c == '\r') { + if (c != 0) { + back(); + } + return sb.toString().trim(); + } + sb.append(c); + } + } + + + /** + * Get the next value. The value can be a Boolean, Double, Integer, + * JSONArray, JSONObject, Long, or String, or the JSONObject.NULL object. + * @throws JSONException If syntax error. + * + * @return An object. + */ + public Object nextValue() throws JSONException { + char c = nextClean(); + String s; + + switch (c) { + case '"': + case '\'': + return nextString(c); + case '{': + back(); + return new JSONObject(this); + case '[': + case '(': + back(); + return new JSONArray(this); + } + + /* + * Handle unquoted text. This could be the values true, false, or + * null, or it can be a number. An implementation (such as this one) + * is allowed to also accept non-standard forms. + * + * Accumulate characters until we reach the end of the text or a + * formatting character. + */ + + StringBuffer sb = new StringBuffer(); + while (c >= ' ' && ",:]}/\\\"[{;=#".indexOf(c) < 0) { + sb.append(c); + c = next(); + } + back(); + + s = sb.toString().trim(); + if (s.equals("")) { + throw syntaxError("Missing value"); + } + return JSONObject.stringToValue(s); + } + + + /** + * Skip characters until the next character is the requested character. + * If the requested character is not found, no characters are skipped. + * @param to A character to skip to. + * @return The requested character, or zero if the requested character + * is not found. + */ + public char skipTo(char to) throws JSONException { + char c; + try { + int startIndex = this.index; + int startCharacter = this.character; + int startLine = this.line; + reader.mark(Integer.MAX_VALUE); + do { + c = next(); + if (c == 0) { + reader.reset(); + this.index = startIndex; + this.character = startCharacter; + this.line = startLine; + return c; + } + } while (c != to); + } catch (IOException exc) { + throw new JSONException(exc); + } + + back(); + return c; + } + + + /** + * Make a JSONException to signal a syntax error. + * + * @param message The error message. + * @return A JSONException object, suitable for throwing + */ + public JSONException syntaxError(String message) { + return new JSONException(message + toString()); + } + + + /** + * Make a printable string of this JSONTokener. + * + * @return " at {index} [character {character} line {line}]" + */ + public String toString() { + return " at " + index + " [character " + this.character + " line " + this.line + "]"; + } +} \ No newline at end of file diff --git a/source/java/org/json/JSONWriter.java b/source/java/org/json/JSONWriter.java new file mode 100644 index 0000000..3622a5b --- /dev/null +++ b/source/java/org/json/JSONWriter.java @@ -0,0 +1,323 @@ +package org.json; + +import java.io.IOException; +import java.io.Writer; + +/* +Copyright (c) 2006 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +/** + * JSONWriter provides a quick and convenient way of producing JSON text. + * The texts produced strictly conform to JSON syntax rules. No whitespace is + * added, so the results are ready for transmission or storage. Each instance of + * JSONWriter can produce one JSON text. + *

+ * A JSONWriter instance provides a value method for appending + * values to the + * text, and a key + * method for adding keys before values in objects. There are array + * and endArray methods that make and bound array values, and + * object and endObject methods which make and bound + * object values. All of these methods return the JSONWriter instance, + * permitting a cascade style. For example, 

+ * new JSONWriter(myWriter)
+ *     .object()
+ *         .key("JSON")
+ *         .value("Hello, World!")
+ *     .endObject();
which writes 
+ * {"JSON":"Hello, World!"}
+ *

+ * The first method called must be array or object. + * There are no methods for adding commas or colons. JSONWriter adds them for + * you. Objects and arrays can be nested up to 20 levels deep. + *

+ * This can sometimes be easier than using a JSONObject to build a string. + * @author JSON.org + * @version 2010-03-11 + */ +public class JSONWriter { + private static final int maxdepth = 20; + + /** + * The comma flag determines if a comma should be output before the next + * value. + */ + private boolean comma; + + /** + * The current mode. Values: + * 'a' (array), + * 'd' (done), + * 'i' (initial), + * 'k' (key), + * 'o' (object). + */ + protected char mode; + + /** + * The object/array stack. + */ + private JSONObject stack[]; + + /** + * The stack top index. A value of 0 indicates that the stack is empty. + */ + private int top; + + /** + * The writer that will receive the output. + */ + protected Writer writer; + + /** + * Make a fresh JSONWriter. It can be used to build one JSON text. + */ + public JSONWriter(Writer w) { + this.comma = false; + this.mode = 'i'; + this.stack = new JSONObject[maxdepth]; + this.top = 0; + this.writer = w; + } + + /** + * Append a value. + * @param s A string value. + * @return this + * @throws JSONException If the value is out of sequence. + */ + private JSONWriter append(String s) throws JSONException { + if (s == null) { + throw new JSONException("Null pointer"); + } + if (this.mode == 'o' || this.mode == 'a') { + try { + if (this.comma && this.mode == 'a') { + this.writer.write(','); + } + this.writer.write(s); + } catch (IOException e) { + throw new JSONException(e); + } + if (this.mode == 'o') { + this.mode = 'k'; + } + this.comma = true; + return this; + } + throw new JSONException("Value out of sequence."); + } + + /** + * Begin appending a new array. All values until the balancing + * endArray will be appended to this array. The + * endArray method must be called to mark the array's end. + * @return this + * @throws JSONException If the nesting is too deep, or if the object is + * started in the wrong place (for example as a key or after the end of the + * outermost array or object). + */ + public JSONWriter array() throws JSONException { + if (this.mode == 'i' || this.mode == 'o' || this.mode == 'a') { + this.push(null); + this.append("["); + this.comma = false; + return this; + } + throw new JSONException("Misplaced array."); + } + + /** + * End something. + * @param m Mode + * @param c Closing character + * @return this + * @throws JSONException If unbalanced. + */ + private JSONWriter end(char m, char c) throws JSONException { + if (this.mode != m) { + throw new JSONException(m == 'a' ? "Misplaced endArray." : + "Misplaced endObject."); + } + this.pop(m); + try { + this.writer.write(c); + } catch (IOException e) { + throw new JSONException(e); + } + this.comma = true; + return this; + } + + /** + * End an array. This method most be called to balance calls to + * array. + * @return this + * @throws JSONException If incorrectly nested. + */ + public JSONWriter endArray() throws JSONException { + return this.end('a', ']'); + } + + /** + * End an object. This method most be called to balance calls to + * object. + * @return this + * @throws JSONException If incorrectly nested. + */ + public JSONWriter endObject() throws JSONException { + return this.end('k', '}'); + } + + /** + * Append a key. The key will be associated with the next value. In an + * object, every value must be preceded by a key. + * @param s A key string. + * @return this + * @throws JSONException If the key is out of place. For example, keys + * do not belong in arrays or if the key is null. + */ + public JSONWriter key(String s) throws JSONException { + if (s == null) { + throw new JSONException("Null key."); + } + if (this.mode == 'k') { + try { + stack[top - 1].putOnce(s, Boolean.TRUE); + if (this.comma) { + this.writer.write(','); + } + this.writer.write(JSONObject.quote(s)); + this.writer.write(':'); + this.comma = false; + this.mode = 'o'; + return this; + } catch (IOException e) { + throw new JSONException(e); + } + } + throw new JSONException("Misplaced key."); + } + + + /** + * Begin appending a new object. All keys and values until the balancing + * endObject will be appended to this object. The + * endObject method must be called to mark the object's end. + * @return this + * @throws JSONException If the nesting is too deep, or if the object is + * started in the wrong place (for example as a key or after the end of the + * outermost array or object). + */ + public JSONWriter object() throws JSONException { + if (this.mode == 'i') { + this.mode = 'o'; + } + if (this.mode == 'o' || this.mode == 'a') { + this.append("{"); + this.push(new JSONObject()); + this.comma = false; + return this; + } + throw new JSONException("Misplaced object."); + + } + + + /** + * Pop an array or object scope. + * @param c The scope to close. + * @throws JSONException If nesting is wrong. + */ + private void pop(char c) throws JSONException { + if (this.top <= 0) { + throw new JSONException("Nesting error."); + } + char m = this.stack[this.top - 1] == null ? 'a' : 'k'; + if (m != c) { + throw new JSONException("Nesting error."); + } + this.top -= 1; + this.mode = this.top == 0 ? 'd' : this.stack[this.top - 1] == null ? 'a' : 'k'; + } + + /** + * Push an array or object scope. + * @param c The scope to open. + * @throws JSONException If nesting is too deep. + */ + private void push(JSONObject jo) throws JSONException { + if (this.top >= maxdepth) { + throw new JSONException("Nesting too deep."); + } + this.stack[this.top] = jo; + this.mode = jo == null ? 'a' : 'k'; + this.top += 1; + } + + + /** + * Append either the value true or the value + * false. + * @param b A boolean. + * @return this + * @throws JSONException + */ + public JSONWriter value(boolean b) throws JSONException { + return this.append(b ? "true" : "false"); + } + + /** + * Append a double value. + * @param d A double. + * @return this + * @throws JSONException If the number is not finite. + */ + public JSONWriter value(double d) throws JSONException { + return this.value(new Double(d)); + } + + /** + * Append a long value. + * @param l A long. + * @return this + * @throws JSONException + */ + public JSONWriter value(long l) throws JSONException { + return this.append(Long.toString(l)); + } + + + /** + * Append an object value. + * @param o The object to append. It can be null, or a Boolean, Number, + * String, JSONObject, or JSONArray, or an object with a toJSONString() + * method. + * @return this + * @throws JSONException If the value is out of sequence. + */ + public JSONWriter value(Object o) throws JSONException { + return this.append(JSONObject.valueToString(o)); + } +} diff --git a/source/java/org/json/Test.java b/source/java/org/json/Test.java new file mode 100644 index 0000000..8cbb22a --- /dev/null +++ b/source/java/org/json/Test.java @@ -0,0 +1,678 @@ +package org.json; + +import java.util.Collection; +import java.util.Iterator; +import java.util.Map; +import java.io.StringWriter; + +/** + * Test class. This file is not formally a member of the org.json library. + * It is just a casual test tool. + */ +public class Test { + + /** + * Entry point. + * @param args + */ + public static void main(String args[]) { + Iterator it; + JSONArray a; + JSONObject j; + JSONStringer jj; + Object o; + String s; + +/** + * Obj is a typical class that implements JSONString. It also + * provides some beanie methods that can be used to + * construct a JSONObject. It also demonstrates constructing + * a JSONObject with an array of names. + */ + class Obj implements JSONString { + public String aString; + public double aNumber; + public boolean aBoolean; + + public Obj(String string, double n, boolean b) { + this.aString = string; + this.aNumber = n; + this.aBoolean = b; + } + + public double getNumber() { + return this.aNumber; + } + + public String getString() { + return this.aString; + } + + public boolean isBoolean() { + return this.aBoolean; + } + + public String getBENT() { + return "All uppercase key"; + } + + public String getX() { + return "x"; + } + + public String toJSONString() { + return "{" + JSONObject.quote(this.aString) + ":" + + JSONObject.doubleToString(this.aNumber) + "}"; + } + public String toString() { + return this.getString() + " " + this.getNumber() + " " + + this.isBoolean() + "." + this.getBENT() + " " + this.getX(); + } + } + + + Obj obj = new Obj("A beany object", 42, true); + + try { + s = "[0.1]"; + a = new JSONArray(s); + System.out.println(a.toString()); + System.out.println(""); + + j = XML.toJSONObject(" Ignore the stuff past the end. "); + System.out.println(j.toString()); + System.out.println(""); + + j = new JSONObject(); + o = null; + j.put("booga", o); + j.put("wooga", JSONObject.NULL); + System.out.println(j.toString()); + System.out.println(""); + + j = new JSONObject(); + j.increment("two"); + j.increment("two"); + System.out.println(j.toString()); + System.out.println(""); + + + s = ""; + j = XML.toJSONObject(s); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + s = "{ \"list of lists\" : [ [1, 2, 3], [4, 5, 6], ] }"; + j = new JSONObject(s); + System.out.println(j.toString(4)); + System.out.println(XML.toString(j)); + + s = " Basic bread Flour Yeast Water Salt Mix all ingredients together. Knead thoroughly. Cover with a cloth, and leave for one hour in warm room. Knead again. Place in a bread baking tin. Cover with a cloth, and leave for one hour in warm room. Bake in the oven at 180(degrees)C for 30 minutes. "; + j = XML.toJSONObject(s); + System.out.println(j.toString(4)); + System.out.println(); + + j = JSONML.toJSONObject(s); + System.out.println(j.toString()); + System.out.println(JSONML.toString(j)); + System.out.println(); + + a = JSONML.toJSONArray(s); + System.out.println(a.toString(4)); + System.out.println(JSONML.toString(a)); + System.out.println(); + + s = "

JSONML is a transformation between JSON and XML that preserves ordering of document features.

JSONML can work with JSON arrays or JSON objects.

Three
little
words

"; + j = JSONML.toJSONObject(s); + System.out.println(j.toString(4)); + System.out.println(JSONML.toString(j)); + System.out.println(); + + a = JSONML.toJSONArray(s); + System.out.println(a.toString(4)); + System.out.println(JSONML.toString(a)); + System.out.println(); + + s = "\n Robert\n Smith\n
\n 12345 Sixth Ave\n Anytown\n CA\n 98765-4321\n
\n "; + j = XML.toJSONObject(s); + System.out.println(j.toString(4)); + + j = new JSONObject(obj); + System.out.println(j.toString()); + + s = "{ \"entity\": { \"imageURL\": \"\", \"name\": \"IXXXXXXXXXXXXX\", \"id\": 12336, \"ratingCount\": null, \"averageRating\": null } }"; + j = new JSONObject(s); + System.out.println(j.toString(2)); + + jj = new JSONStringer(); + s = jj + .object() + .key("single") + .value("MARIE HAA'S") + .key("Johnny") + .value("MARIE HAA\\'S") + .key("foo") + .value("bar") + .key("baz") + .array() + .object() + .key("quux") + .value("Thanks, Josh!") + .endObject() + .endArray() + .key("obj keys") + .value(JSONObject.getNames(obj)) + .endObject() + .toString(); + System.out.println(s); + + System.out.println(new JSONStringer() + .object() + .key("a") + .array() + .array() + .array() + .value("b") + .endArray() + .endArray() + .endArray() + .endObject() + .toString()); + + jj = new JSONStringer(); + jj.array(); + jj.value(1); + jj.array(); + jj.value(null); + jj.array(); + jj.object(); + jj.key("empty-array").array().endArray(); + jj.key("answer").value(42); + jj.key("null").value(null); + jj.key("false").value(false); + jj.key("true").value(true); + jj.key("big").value(123456789e+88); + jj.key("small").value(123456789e-88); + jj.key("empty-object").object().endObject(); + jj.key("long"); + jj.value(9223372036854775807L); + jj.endObject(); + jj.value("two"); + jj.endArray(); + jj.value(true); + jj.endArray(); + jj.value(98.6); + jj.value(-100.0); + jj.object(); + jj.endObject(); + jj.object(); + jj.key("one"); + jj.value(1.00); + jj.endObject(); + jj.value(obj); + jj.endArray(); + System.out.println(jj.toString()); + + System.out.println(new JSONArray(jj.toString()).toString(4)); + + int ar[] = {1, 2, 3}; + JSONArray ja = new JSONArray(ar); + System.out.println(ja.toString()); + + String sa[] = {"aString", "aNumber", "aBoolean"}; + j = new JSONObject(obj, sa); + j.put("Testing JSONString interface", obj); + System.out.println(j.toString(4)); + + j = new JSONObject("{slashes: '///', closetag: '', backslash:'\\\\', ei: {quotes: '\"\\''},eo: {a: '\"quoted\"', b:\"don't\"}, quotes: [\"'\", '\"']}"); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = new JSONObject( + "{foo: [true, false,9876543210, 0.0, 1.00000001, 1.000000000001, 1.00000000000000001," + + " .00000000000000001, 2.00, 0.1, 2e100, -32,[],{}, \"string\"], " + + " to : null, op : 'Good'," + + "ten:10} postfix comment"); + j.put("String", "98.6"); + j.put("JSONObject", new JSONObject()); + j.put("JSONArray", new JSONArray()); + j.put("int", 57); + j.put("double", 123456789012345678901234567890.); + j.put("true", true); + j.put("false", false); + j.put("null", JSONObject.NULL); + j.put("bool", "true"); + j.put("zero", -0.0); + j.put("\\u2028", "\u2028"); + j.put("\\u2029", "\u2029"); + a = j.getJSONArray("foo"); + a.put(666); + a.put(2001.99); + a.put("so \"fine\"."); + a.put("so ."); + a.put(true); + a.put(false); + a.put(new JSONArray()); + a.put(new JSONObject()); + j.put("keys", JSONObject.getNames(j)); + System.out.println(j.toString(4)); + System.out.println(XML.toString(j)); + + System.out.println("String: " + j.getDouble("String")); + System.out.println(" bool: " + j.getBoolean("bool")); + System.out.println(" to: " + j.getString("to")); + System.out.println(" true: " + j.getString("true")); + System.out.println(" foo: " + j.getJSONArray("foo")); + System.out.println(" op: " + j.getString("op")); + System.out.println(" ten: " + j.getInt("ten")); + System.out.println(" oops: " + j.optBoolean("oops")); + + s = "First \u0009<content> This is \"content\". 3 JSON does not preserve the sequencing of elements and contents. III T H R E EContent text is an implied structure in XML. JSON does not have implied structure:7everything is explicit.!]]>"; + j = XML.toJSONObject(s); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + ja = JSONML.toJSONArray(s); + System.out.println(ja.toString(4)); + System.out.println(JSONML.toString(ja)); + System.out.println(""); + + s = "unodostrestruequatrocinqoseis"; + ja = JSONML.toJSONArray(s); + System.out.println(ja.toString(4)); + System.out.println(JSONML.toString(ja)); + System.out.println(""); + + s = " "; + j = XML.toJSONObject(s); + + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + ja = JSONML.toJSONArray(s); + System.out.println(ja.toString(4)); + System.out.println(JSONML.toString(ja)); + System.out.println(""); + + j = XML.toJSONObject("Sample BookThis is chapter 1. It is not very long or interesting.This is chapter 2. Although it is longer than chapter 1, it is not any more interesting."); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = XML.toJSONObject(""); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = XML.toJSONObject(" Fred fbs0001 Scerbo B "); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = XML.toJSONObject("Repository Address Special Collections LibraryABC UniversityMain Library, 40 Circle DriveOurtown, Pennsylvania17654 USA"); + System.out.println(j.toString()); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = XML.toJSONObject("deluxe&"toot"&toot;Aeksbonusbonus2"); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = HTTP.toJSONObject("GET / HTTP/1.0\nAccept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, */*\nAccept-Language: en-us\nUser-Agent: Mozilla/4.0 (compatible; MSIE 5.5; Windows 98; Win 9x 4.90; T312461; Q312461)\nHost: www.nokko.com\nConnection: keep-alive\nAccept-encoding: gzip, deflate\n"); + System.out.println(j.toString(2)); + System.out.println(HTTP.toString(j)); + System.out.println(""); + + j = HTTP.toJSONObject("HTTP/1.1 200 Oki Doki\nDate: Sun, 26 May 2002 17:38:52 GMT\nServer: Apache/1.3.23 (Unix) mod_perl/1.26\nKeep-Alive: timeout=15, max=100\nConnection: Keep-Alive\nTransfer-Encoding: chunked\nContent-Type: text/html\n"); + System.out.println(j.toString(2)); + System.out.println(HTTP.toString(j)); + System.out.println(""); + + j = new JSONObject("{nix: null, nux: false, null: 'null', 'Request-URI': '/', Method: 'GET', 'HTTP-Version': 'HTTP/1.0'}"); + System.out.println(j.toString(2)); + System.out.println("isNull: " + j.isNull("nix")); + System.out.println(" has: " + j.has("nix")); + System.out.println(XML.toString(j)); + System.out.println(HTTP.toString(j)); + System.out.println(""); + + j = XML.toJSONObject(""+"\n\n"+""+ + ""+ + "GOOGLEKEY '+search+' 0 10 true false latin1 latin1"+ + ""+ + ""); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = new JSONObject("{Envelope: {Body: {\"ns1:doGoogleSearch\": {oe: \"latin1\", filter: true, q: \"'+search+'\", key: \"GOOGLEKEY\", maxResults: 10, \"SOAP-ENV:encodingStyle\": \"http://schemas.xmlsoap.org/soap/encoding/\", start: 0, ie: \"latin1\", safeSearch:false, \"xmlns:ns1\": \"urn:GoogleSearch\"}}}}"); + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + + j = CookieList.toJSONObject(" f%oo = b+l=ah ; o;n%40e = t.wo "); + System.out.println(j.toString(2)); + System.out.println(CookieList.toString(j)); + System.out.println(""); + + j = Cookie.toJSONObject("f%oo=blah; secure ;expires = April 24, 2002"); + System.out.println(j.toString(2)); + System.out.println(Cookie.toString(j)); + System.out.println(""); + + j = new JSONObject("{script: 'It is not allowed in HTML to send a close script tag in a stringso we insert a backslash before the /'}"); + System.out.println(j.toString()); + System.out.println(""); + + JSONTokener jt = new JSONTokener("{op:'test', to:'session', pre:1}{op:'test', to:'session', pre:2}"); + j = new JSONObject(jt); + System.out.println(j.toString()); + System.out.println("pre: " + j.optInt("pre")); + int i = jt.skipTo('{'); + System.out.println(i); + j = new JSONObject(jt); + System.out.println(j.toString()); + System.out.println(""); + + a = CDL.toJSONArray("Comma delimited list test, '\"Strip\"Quotes', 'quote, comma', No quotes, 'Single Quotes', \"Double Quotes\"\n1,'2',\"3\"\n,'It is \"good,\"', \"It works.\"\n\n"); + + s = CDL.toString(a); + System.out.println(s); + System.out.println(""); + System.out.println(a.toString(4)); + System.out.println(""); + a = CDL.toJSONArray(s); + System.out.println(a.toString(4)); + System.out.println(""); + + a = new JSONArray(" [\"\", next is an implied null , , ok,] "); + System.out.println(a.toString()); + System.out.println(""); + System.out.println(XML.toString(a)); + System.out.println(""); + + j = new JSONObject("{ fun => with non-standard forms ; forgiving => This package can be used to parse formats that are similar to but not stricting conforming to JSON; why=To make it easier to migrate existing data to JSON,one = [[1.00]]; uno=[[{1=>1}]];'+':+6e66 ;pluses=+++;empty = '' , 'double':0.666,true: TRUE, false: FALSE, null=NULL;[true] = [[!,@;*]]; string=> o. k. ; \r oct=0666; hex=0x666; dec=666; o=0999; noh=0x0x}"); + System.out.println(j.toString(4)); + System.out.println(""); + if (j.getBoolean("true") && !j.getBoolean("false")) { + System.out.println("It's all good"); + } + + System.out.println(""); + j = new JSONObject(j, new String[]{"dec", "oct", "hex", "missing"}); + System.out.println(j.toString(4)); + + System.out.println(""); + System.out.println(new JSONStringer().array().value(a).value(j).endArray()); + + j = new JSONObject("{string: \"98.6\", long: 2147483648, int: 2147483647, longer: 9223372036854775807, double: 9223372036854775808}"); + System.out.println(j.toString(4)); + + System.out.println("\ngetInt"); + System.out.println("int " + j.getInt("int")); + System.out.println("long " + j.getInt("long")); + System.out.println("longer " + j.getInt("longer")); + //System.out.println("double " + j.getInt("double")); + //System.out.println("string " + j.getInt("string")); + + System.out.println("\ngetLong"); + System.out.println("int " + j.getLong("int")); + System.out.println("long " + j.getLong("long")); + System.out.println("longer " + j.getLong("longer")); + //System.out.println("double " + j.getLong("double")); + //System.out.println("string " + j.getLong("string")); + + System.out.println("\ngetDouble"); + System.out.println("int " + j.getDouble("int")); + System.out.println("long " + j.getDouble("long")); + System.out.println("longer " + j.getDouble("longer")); + System.out.println("double " + j.getDouble("double")); + System.out.println("string " + j.getDouble("string")); + + j.put("good sized", 9223372036854775807L); + System.out.println(j.toString(4)); + + a = new JSONArray("[2147483647, 2147483648, 9223372036854775807, 9223372036854775808]"); + System.out.println(a.toString(4)); + + System.out.println("\nKeys: "); + it = j.keys(); + while (it.hasNext()) { + s = (String)it.next(); + System.out.println(s + ": " + j.getString(s)); + } + + + System.out.println("\naccumulate: "); + j = new JSONObject(); + j.accumulate("stooge", "Curly"); + j.accumulate("stooge", "Larry"); + j.accumulate("stooge", "Moe"); + a = j.getJSONArray("stooge"); + a.put(5, "Shemp"); + System.out.println(j.toString(4)); + + System.out.println("\nwrite:"); + System.out.println(j.write(new StringWriter())); + + s = "122333"; + j = XML.toJSONObject(s); + System.out.println(j.toString(4)); + System.out.println(XML.toString(j)); + + s = "Content of the first chapterContent of the second chapter Content of the first subchapter Content of the second subchapterThird Chapter"; + j = XML.toJSONObject(s); + System.out.println(j.toString(4)); + System.out.println(XML.toString(j)); + + a = JSONML.toJSONArray(s); + System.out.println(a.toString(4)); + System.out.println(JSONML.toString(a)); + + Collection c = null; + Map m = null; + + j = new JSONObject(m); + a = new JSONArray(c); + j.append("stooge", "Joe DeRita"); + j.append("stooge", "Shemp"); + j.accumulate("stooges", "Curly"); + j.accumulate("stooges", "Larry"); + j.accumulate("stooges", "Moe"); + j.accumulate("stoogearray", j.get("stooges")); + j.put("map", m); + j.put("collection", c); + j.put("array", a); + a.put(m); + a.put(c); + System.out.println(j.toString(4)); + + s = "{plist=Apple; AnimalSmells = { pig = piggish; lamb = lambish; worm = wormy; }; AnimalSounds = { pig = oink; lamb = baa; worm = baa; Lisa = \"Why is the worm talking like a lamb?\" } ; AnimalColors = { pig = pink; lamb = black; worm = pink; } } "; + j = new JSONObject(s); + System.out.println(j.toString(4)); + + s = " (\"San Francisco\", \"New York\", \"Seoul\", \"London\", \"Seattle\", \"Shanghai\")"; + a = new JSONArray(s); + System.out.println(a.toString()); + + s = "The content of b and The content of cdoremi"; + j = XML.toJSONObject(s); + + System.out.println(j.toString(2)); + System.out.println(XML.toString(j)); + System.out.println(""); + ja = JSONML.toJSONArray(s); + System.out.println(ja.toString(4)); + System.out.println(JSONML.toString(ja)); + System.out.println(""); + + s = "111111111111111"; + j = JSONML.toJSONObject(s); + System.out.println(j); + ja = JSONML.toJSONArray(s); + System.out.println(ja); + + + System.out.println("\nTesting Exceptions: "); + + System.out.print("Exception: "); + try { + a = new JSONArray("[\n\r\n\r}"); + System.out.println(a.toString()); + } catch (Exception e) { + System.out.println(e); + } + + System.out.print("Exception: "); + try { + a = new JSONArray("<\n\r\n\r "); + System.out.println(a.toString()); + } catch (Exception e) { + System.out.println(e); + } + + System.out.print("Exception: "); + try { + a = new JSONArray(); + a.put(Double.NEGATIVE_INFINITY); + a.put(Double.NaN); + System.out.println(a.toString()); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(j.getDouble("stooge")); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(j.getDouble("howard")); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(j.put(null, "howard")); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(a.getDouble(0)); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(a.get(-1)); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + System.out.println(a.put(Double.NaN)); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + j = XML.toJSONObject(" "); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + j = XML.toJSONObject(" "); + } catch (Exception e) { + System.out.println(e); + } + System.out.print("Exception: "); + try { + j = XML.toJSONObject("'. */ + public static final Character GT = new Character('>'); + + /** The Character '<'. */ + public static final Character LT = new Character('<'); + + /** The Character '?'. */ + public static final Character QUEST = new Character('?'); + + /** The Character '"'. */ + public static final Character QUOT = new Character('"'); + + /** The Character '/'. */ + public static final Character SLASH = new Character('/'); + + /** + * Replace special characters with XML escapes: + * 
+     * & (ampersand) is replaced by &amp;
+     * < (less than) is replaced by &lt;
+     * > (greater than) is replaced by &gt;
+     * " (double quote) is replaced by &quot;
+     *
+ * @param string The string to be escaped. + * @return The escaped string. + */ + public static String escape(String string) { + StringBuffer sb = new StringBuffer(); + for (int i = 0, len = string.length(); i < len; i++) { + char c = string.charAt(i); + switch (c) { + case '&': + sb.append("&"); + break; + case '<': + sb.append("<"); + break; + case '>': + sb.append(">"); + break; + case '"': + sb.append("""); + break; + default: + sb.append(c); + } + } + return sb.toString(); + } + + /** + * Throw an exception if the string contains whitespace. + * Whitespace is not allowed in tagNames and attributes. + * @param string + * @throws JSONException + */ + public static void noSpace(String string) throws JSONException { + int i, length = string.length(); + if (length == 0) { + throw new JSONException("Empty string."); + } + for (i = 0; i < length; i += 1) { + if (Character.isWhitespace(string.charAt(i))) { + throw new JSONException("'" + string + + "' contains a space character."); + } + } + } + + /** + * Scan the content following the named tag, attaching it to the context. + * @param x The XMLTokener containing the source string. + * @param context The JSONObject that will include the new material. + * @param name The tag name. + * @return true if the close tag is processed. + * @throws JSONException + */ + private static boolean parse(XMLTokener x, JSONObject context, + String name) throws JSONException { + char c; + int i; + String n; + JSONObject o = null; + String s; + Object t; + +// Test for and skip past these forms: +// +// +// +// +// Report errors for these forms: +// <> +// <= +// << + + t = x.nextToken(); + +// "); + return false; + } + x.back(); + } else if (c == '[') { + t = x.nextToken(); + if (t.equals("CDATA")) { + if (x.next() == '[') { + s = x.nextCDATA(); + if (s.length() > 0) { + context.accumulate("content", s); + } + return false; + } + } + throw x.syntaxError("Expected 'CDATA['"); + } + i = 1; + do { + t = x.nextMeta(); + if (t == null) { + throw x.syntaxError("Missing '>' after ' 0); + return false; + } else if (t == QUEST) { + +// "); + return false; + } else if (t == SLASH) { + +// Close tag + + } else if (t == SLASH) { + if (x.nextToken() != GT) { + throw x.syntaxError("Misshaped tag"); + } + if (o.length() > 0) { + context.accumulate(n, o); + } else { + context.accumulate(n, ""); + } + return false; + +// Content, between <...> and + + } else if (t == GT) { + for (;;) { + t = x.nextContent(); + if (t == null) { + if (n != null) { + throw x.syntaxError("Unclosed tag " + n); + } + return false; + } else if (t instanceof String) { + s = (String)t; + if (s.length() > 0) { + o.accumulate("content", JSONObject.stringToValue(s)); + } + +// Nested element + + } else if (t == LT) { + if (parse(x, o, n)) { + if (o.length() == 0) { + context.accumulate(n, ""); + } else if (o.length() == 1 && + o.opt("content") != null) { + context.accumulate(n, o.opt("content")); + } else { + context.accumulate(n, o); + } + return false; + } + } + } + } else { + throw x.syntaxError("Misshaped tag"); + } + } + } + } + + + /** + * Convert a well-formed (but not necessarily valid) XML string into a + * JSONObject. Some information may be lost in this transformation + * because JSON is a data format and XML is a document format. XML uses + * elements, attributes, and content text, while JSON uses unordered + * collections of name/value pairs and arrays of values. JSON does not + * does not like to distinguish between elements and attributes. + * Sequences of similar elements are represented as JSONArrays. Content + * text may be placed in a "content" member. Comments, prologs, DTDs, and + * <[ [ ]]> are ignored. + * @param string The source string. + * @return A JSONObject containing the structured data from the XML string. + * @throws JSONException + */ + public static JSONObject toJSONObject(String string) throws JSONException { + JSONObject o = new JSONObject(); + XMLTokener x = new XMLTokener(string); + while (x.more() && x.skipPast("<")) { + parse(x, o, null); + } + return o; + } + + + /** + * Convert a JSONObject into a well-formed, element-normal XML string. + * @param o A JSONObject. + * @return A string. + * @throws JSONException + */ + public static String toString(Object o) throws JSONException { + return toString(o, null); + } + + + /** + * Convert a JSONObject into a well-formed, element-normal XML string. + * @param o A JSONObject. + * @param tagName The optional name of the enclosing tag. + * @return A string. + * @throws JSONException + */ + public static String toString(Object o, String tagName) + throws JSONException { + StringBuffer b = new StringBuffer(); + int i; + JSONArray ja; + JSONObject jo; + String k; + Iterator keys; + int len; + String s; + Object v; + if (o instanceof JSONObject) { + +// Emit + + if (tagName != null) { + b.append('<'); + b.append(tagName); + b.append('>'); + } + +// Loop thru the keys. + + jo = (JSONObject)o; + keys = jo.keys(); + while (keys.hasNext()) { + k = keys.next().toString(); + v = jo.opt(k); + if (v == null) { + v = ""; + } + if (v instanceof String) { + s = (String)v; + } else { + s = null; + } + +// Emit content in body + + if (k.equals("content")) { + if (v instanceof JSONArray) { + ja = (JSONArray)v; + len = ja.length(); + for (i = 0; i < len; i += 1) { + if (i > 0) { + b.append('\n'); + } + b.append(escape(ja.get(i).toString())); + } + } else { + b.append(escape(v.toString())); + } + +// Emit an array of similar keys + + } else if (v instanceof JSONArray) { + ja = (JSONArray)v; + len = ja.length(); + for (i = 0; i < len; i += 1) { + v = ja.get(i); + if (v instanceof JSONArray) { + b.append('<'); + b.append(k); + b.append('>'); + b.append(toString(v)); + b.append("'); + } else { + b.append(toString(v, k)); + } + } + } else if (v.equals("")) { + b.append('<'); + b.append(k); + b.append("/>"); + +// Emit a new tag + + } else { + b.append(toString(v, k)); + } + } + if (tagName != null) { + +// Emit the close tag + + b.append("'); + } + return b.toString(); + +// XML does not have good support for arrays. If an array appears in a place +// where XML is lacking, synthesize an element. + + } else if (o instanceof JSONArray) { + ja = (JSONArray)o; + len = ja.length(); + for (i = 0; i < len; ++i) { + v = ja.opt(i); + b.append(toString(v, (tagName == null) ? "array" : tagName)); + } + return b.toString(); + } else { + s = (o == null) ? "null" : escape(o.toString()); + return (tagName == null) ? "\"" + s + "\"" : + (s.length() == 0) ? "<" + tagName + "/>" : + "<" + tagName + ">" + s + ""; + } + } +} \ No newline at end of file diff --git a/source/java/org/json/XMLTokener.java b/source/java/org/json/XMLTokener.java new file mode 100644 index 0000000..47ff3f2 --- /dev/null +++ b/source/java/org/json/XMLTokener.java @@ -0,0 +1,365 @@ +package org.json; + +/* +Copyright (c) 2002 JSON.org + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +*/ + +/** + * The XMLTokener extends the JSONTokener to provide additional methods + * for the parsing of XML texts. + * @author JSON.org + * @version 2010-01-30 + */ +public class XMLTokener extends JSONTokener { + + + /** The table of entity values. It initially contains Character values for + * amp, apos, gt, lt, quot. + */ + public static final java.util.HashMap entity; + + static { + entity = new java.util.HashMap(8); + entity.put("amp", XML.AMP); + entity.put("apos", XML.APOS); + entity.put("gt", XML.GT); + entity.put("lt", XML.LT); + entity.put("quot", XML.QUOT); + } + + /** + * Construct an XMLTokener from a string. + * @param s A source string. + */ + public XMLTokener(String s) { + super(s); + } + + /** + * Get the text in the CDATA block. + * @return The string up to the ]]>. + * @throws JSONException If the ]]> is not found. + */ + public String nextCDATA() throws JSONException { + char c; + int i; + StringBuffer sb = new StringBuffer(); + for (;;) { + c = next(); + if (end()) { + throw syntaxError("Unclosed CDATA"); + } + sb.append(c); + i = sb.length() - 3; + if (i >= 0 && sb.charAt(i) == ']' && + sb.charAt(i + 1) == ']' && sb.charAt(i + 2) == '>') { + sb.setLength(i); + return sb.toString(); + } + } + } + + + /** + * Get the next XML outer token, trimming whitespace. There are two kinds + * of tokens: the '<' character which begins a markup tag, and the content + * text between markup tags. + * + * @return A string, or a '<' Character, or null if there is no more + * source text. + * @throws JSONException + */ + public Object nextContent() throws JSONException { + char c; + StringBuffer sb; + do { + c = next(); + } while (Character.isWhitespace(c)); + if (c == 0) { + return null; + } + if (c == '<') { + return XML.LT; + } + sb = new StringBuffer(); + for (;;) { + if (c == '<' || c == 0) { + back(); + return sb.toString().trim(); + } + if (c == '&') { + sb.append(nextEntity(c)); + } else { + sb.append(c); + } + c = next(); + } + } + + + /** + * Return the next entity. These entities are translated to Characters: + * & ' > < ". + * @param a An ampersand character. + * @return A Character or an entity String if the entity is not recognized. + * @throws JSONException If missing ';' in XML entity. + */ + public Object nextEntity(char a) throws JSONException { + StringBuffer sb = new StringBuffer(); + for (;;) { + char c = next(); + if (Character.isLetterOrDigit(c) || c == '#') { + sb.append(Character.toLowerCase(c)); + } else if (c == ';') { + break; + } else { + throw syntaxError("Missing ';' in XML entity: &" + sb); + } + } + String s = sb.toString(); + Object e = entity.get(s); + return e != null ? e : a + s + ";"; + } + + + /** + * Returns the next XML meta token. This is used for skipping over + * and structures. + * @return Syntax characters (< > / = ! ?) are returned as + * Character, and strings and names are returned as Boolean. We don't care + * what the values actually are. + * @throws JSONException If a string is not properly closed or if the XML + * is badly structured. + */ + public Object nextMeta() throws JSONException { + char c; + char q; + do { + c = next(); + } while (Character.isWhitespace(c)); + switch (c) { + case 0: + throw syntaxError("Misshaped meta tag"); + case '<': + return XML.LT; + case '>': + return XML.GT; + case '/': + return XML.SLASH; + case '=': + return XML.EQ; + case '!': + return XML.BANG; + case '?': + return XML.QUEST; + case '"': + case '\'': + q = c; + for (;;) { + c = next(); + if (c == 0) { + throw syntaxError("Unterminated string"); + } + if (c == q) { + return Boolean.TRUE; + } + } + default: + for (;;) { + c = next(); + if (Character.isWhitespace(c)) { + return Boolean.TRUE; + } + switch (c) { + case 0: + case '<': + case '>': + case '/': + case '=': + case '!': + case '?': + case '"': + case '\'': + back(); + return Boolean.TRUE; + } + } + } + } + + + /** + * Get the next XML Token. These tokens are found inside of angle + * brackets. It may be one of these characters: / > = ! ? or it + * may be a string wrapped in single quotes or double quotes, or it may be a + * name. + * @return a String or a Character. + * @throws JSONException If the XML is not well formed. + */ + public Object nextToken() throws JSONException { + char c; + char q; + StringBuffer sb; + do { + c = next(); + } while (Character.isWhitespace(c)); + switch (c) { + case 0: + throw syntaxError("Misshaped element"); + case '<': + throw syntaxError("Misplaced '<'"); + case '>': + return XML.GT; + case '/': + return XML.SLASH; + case '=': + return XML.EQ; + case '!': + return XML.BANG; + case '?': + return XML.QUEST; + +// Quoted string + + case '"': + case '\'': + q = c; + sb = new StringBuffer(); + for (;;) { + c = next(); + if (c == 0) { + throw syntaxError("Unterminated string"); + } + if (c == q) { + return sb.toString(); + } + if (c == '&') { + sb.append(nextEntity(c)); + } else { + sb.append(c); + } + } + default: + +// Name + + sb = new StringBuffer(); + for (;;) { + sb.append(c); + c = next(); + if (Character.isWhitespace(c)) { + return sb.toString(); + } + switch (c) { + case 0: + return sb.toString(); + case '>': + case '/': + case '=': + case '!': + case '?': + case '[': + case ']': + back(); + return sb.toString(); + case '<': + case '"': + case '\'': + throw syntaxError("Bad character in a name"); + } + } + } + } + + + /** + * Skip characters until past the requested string. + * If it is not found, we are left at the end of the source with a result of false. + * @param to A string to skip past. + * @throws JSONException + */ + public boolean skipPast(String to) throws JSONException { + boolean b; + char c; + int i; + int j; + int offset = 0; + int n = to.length(); + char[] circle = new char[n]; + + /* + * First fill the circle buffer with as many characters as are in the + * to string. If we reach an early end, bail. + */ + + for (i = 0; i < n; i += 1) { + c = next(); + if (c == 0) { + return false; + } + circle[i] = c; + } + /* + * We will loop, possibly for all of the remaining characters. + */ + for (;;) { + j = offset; + b = true; + /* + * Compare the circle buffer with the to string. + */ + for (i = 0; i < n; i += 1) { + if (circle[j] != to.charAt(i)) { + b = false; + break; + } + j += 1; + if (j >= n) { + j -= n; + } + } + /* + * If we exit the loop with b intact, then victory is ours. + */ + if (b) { + return true; + } + /* + * Get the next character. If there isn't one, then defeat is ours. + */ + c = next(); + if (c == 0) { + return false; + } + /* + * Shove the character in the circle buffer and advance the + * circle offset. The offset is mod n. + */ + circle[offset] = c; + offset += 1; + if (offset >= n) { + offset -= n; + } + } + } +} diff --git a/source/java/writer2latex/api/ConverterFactory.java b/source/java/writer2latex/api/ConverterFactory.java index 1f23227..bcc8170 100644 --- a/source/java/writer2latex/api/ConverterFactory.java +++ b/source/java/writer2latex/api/ConverterFactory.java @@ -20,7 +20,7 @@ * * All Rights Reserved. * - * Version 1.2 (2010-07-02) + * Version 1.2 (2010-10-01) * */ @@ -32,8 +32,8 @@ package writer2latex.api; public class ConverterFactory { // Version information - private static final String VERSION = "1.1.4"; - private static final String DATE = "2010-07-02"; + private static final String VERSION = "1.1.5"; + private static final String DATE = "2010-10-06"; /** Return the Writer2LaTeX version in the form * (major version).(minor version).(patch level)
diff --git a/source/java/writer2latex/latex/FieldConverter.java b/source/java/writer2latex/latex/FieldConverter.java index 1dffafc..ad9f9da 100644 --- a/source/java/writer2latex/latex/FieldConverter.java +++ b/source/java/writer2latex/latex/FieldConverter.java @@ -16,11 +16,11 @@ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * - * Copyright: 2002-2008 by Henrik Just + * Copyright: 2002-2010 by Henrik Just * * All Rights Reserved. * - * Version 1.0 (2008-11-23) + * Version 1.2 (2010-10-06) * */ @@ -30,7 +30,11 @@ package writer2latex.latex; import java.util.Enumeration; import java.util.Hashtable; import java.util.Vector; +import java.util.regex.Pattern; +import org.json.JSONArray; +import org.json.JSONException; +import org.json.JSONObject; import org.w3c.dom.Element; import org.w3c.dom.Node; @@ -51,7 +55,10 @@ import writer2latex.util.SimpleInputBuffer; */ public class FieldConverter extends ConverterHelper { - + + // Identify Zotero items + private static final String ZOTERO_ITEM = "ZOTERO_ITEM"; + // Links & references private ExportNameCollection targets = new ExportNameCollection(true); private ExportNameCollection refnames = new ExportNameCollection(true); @@ -71,11 +78,14 @@ public class FieldConverter extends ConverterHelper { private boolean bUsesPageCount = false; private boolean bUsesTitleref = false; private boolean bUsesOooref = false; + private boolean bConvertZotero = false; + private boolean bNeedNatbib = false; public FieldConverter(OfficeReader ofr, LaTeXConfig config, ConverterPalette palette) { super(ofr,config,palette); // hyperref.sty is not compatible with titleref.sty and oooref.sty: bUseHyperref = config.useHyperref() && !config.useTitleref() && !config.useOooref(); + bConvertZotero = config.useBibtex() && config.zoteroBibtexFiles().length()>0; } /**

Append declarations needed by the FieldConverter to @@ -122,7 +132,12 @@ public class FieldConverter extends ConverterHelper { } } pack.append("}").nl(); - } + } + + // Use natbib + if (bNeedNatbib) { + pack.append("\\usepackage{natbib}").nl(); + } // Export sequence declarations // The number format is fetched from the first occurence of the @@ -422,10 +437,197 @@ public class FieldConverter extends ConverterHelper { palette.getInlineCv().traversePCDATA(node,ldp,oc); } } - } + } + + // Try to handle this reference name as a Zotero reference, return true on success + private boolean handleZoteroReferenceName(String sName, LaTeXDocumentPortion ldp, Context oc) { + // First parse the reference name: + // A Zotero reference name has the form ZOTERO_ITEM with a single space separating the items + // The identifier is a unique identifier for the reference and is not used here + if (sName.startsWith(ZOTERO_ITEM)) { + int nObjectStart = sName.indexOf('{'); + int nObjectEnd = sName.lastIndexOf('}'); + if (nObjectStart>-1 && nObjectEnd>-1 && nObjectStartProcess a reference mark (text:reference-mark tag)

+ JSONArray citationItemsArray = null; + try { // The value is an array of objects, one for each source in this citation + citationItemsArray = jo.getJSONArray("citationItems"); + } + catch (JSONException e) { + } + + if (citationItemsArray!=null) { + int nCitationCount = citationItemsArray.length(); + if (nCitationCount>1) { + // For multiple citations, use \citetext, otherwise we cannot add individual prefixes and suffixes + // TODO: If no prefixes or suffixes exist, it's safe to combine the citations + ldp.append("\\citetext{"); + } + + for (int nIndex=0; nIndex0) { + ldp.append("; "); // Separate multiple citations in this reference + } + + // Citation items + String sURI = ""; + boolean bSuppressAuthor = false; + String sPrefix = ""; + String sSuffix = ""; + String sLocator = ""; + String sLocatorType = ""; + + try { // The URI seems to be an array with a single string value(?) + sURI = citationItems.getJSONArray("uri").getString(0); + } + catch (JSONException e) { + } + + try { // SuppressAuthor is a boolean value + bSuppressAuthor = citationItems.getBoolean("suppressAuthor"); + } + catch (JSONException e) { + } + + try { // Prefix is a string value + sPrefix = citationItems.getString("prefix"); + } + catch (JSONException e) { + } + + try { // Suffix is a string value + sSuffix = citationItems.getString("suffix"); + } + catch (JSONException e) { + } + + try { // Locator is a string value, e.g. a page number + sLocator = citationItems.getString("locator"); + } + catch (JSONException e) { + } + + try { + // LocatorType is a string value, e.g. book, verse, page (missing locatorType means page) + sLocatorType = citationItems.getString("locatorType"); + } + catch (JSONException e) { + } + + // Adjust locator type (empty locator type means "page") + // TODO: Handle other locator types (localize and abbreviate): Currently the internal name (e.g. book) is used. + if (sLocator.length()>0 && sLocatorType.length()==0) { + // A locator of the form is interpreted as several pages + if (Pattern.compile("[0-9]+[^0-9]+[0-9]+").matcher(sLocator).find()) { + sLocatorType = "pp."; + } + else { + sLocatorType = "p."; + } + } + + // Insert command. TODO: Evaluate this + if (nCitationCount>1) { // Use commands without parentheses + if (bSuppressAuthor) { ldp.append("\\citeyear"); } + else { ldp.append("\\citet"); } + } + else { + if (bSuppressAuthor) { ldp.append("\\citeyearpar"); } + else { ldp.append("\\citep"); } + } + + if (sPrefix.length()>0) { + ldp.append("[").append(palette.getI18n().convert(sPrefix,true,oc.getLang())).append("]"); + } + + if (sPrefix.length()>0 || sSuffix.length()>0 || sLocatorType.length()>0 || sLocator.length()>0) { + // Note that we need to include an empty suffix if there's a prefix! + ldp.append("[") + .append(palette.getI18n().convert(sSuffix,true,oc.getLang())) + .append(palette.getI18n().convert(sLocatorType,true,oc.getLang())); + if (sLocatorType.length()>0 && sLocator.length()>0) { + ldp.append("~"); + } + ldp.append(palette.getI18n().convert(sLocator,true,oc.getLang())) + .append("]"); + } + + ldp.append("{"); + int nSlash = sURI.lastIndexOf('/'); + if (nSlash>0) { + ldp.append(sURI.substring(nSlash+1)); + } + else { + ldp.append(sURI); + } + ldp.append("}"); + } + } + + if (nCitationCount>1) { // End the \citetext command + ldp.append("}"); + } + + oc.setInZoteroText(true); + + bNeedNatbib = true; + + return true; + } + } + } + return false; + } + + private String shortenRefname(String s) { + // For Zotero items, use the trailing unique identifier + if (s.startsWith(ZOTERO_ITEM)) { + int nLast = s.lastIndexOf(' '); + if (nLast>0) { + return s.substring(nLast+1); + } + } + return s; + } + + /**

Process a reference mark end (text:reference-mark-end tag)

+ * @param node The element containing the reference mark + * @param ldp the LaTeXDocumentPortion to which + * LaTeX code should be added + * @param oc the current context + */ + public void handleReferenceMarkEnd(Element node, LaTeXDocumentPortion ldp, Context oc) { + // Nothing to do, except to mark that this ends any Zotero citation + oc.setInZoteroText(false); + } + + /**

Process a reference mark (text:reference-mark or text:reference-mark-start tag)

* @param node The element containing the reference mark * @param ldp the LaTeXDocumentPortion to which * LaTeX code should be added @@ -433,10 +635,12 @@ public class FieldConverter extends ConverterHelper { */ public void handleReferenceMark(Element node, LaTeXDocumentPortion ldp, Context oc) { if (!oc.isInSection() && !oc.isInCaption() && !oc.isVerbatim()) { - // Note: Always include \label here, even when it's not used String sName = node.getAttribute(XMLString.TEXT_NAME); - if (sName!=null) { - ldp.append("\\label{ref:"+refnames.getExportName(sName)+"}"); + // Zotero (mis)uses reference marks to store citations, so check this first + if (sName!=null && (!bConvertZotero || !handleZoteroReferenceName(sName, ldp, oc))) { + // Plain reference mark + // Note: Always include \label here, even when it's not used + ldp.append("\\label{ref:"+refnames.getExportName(shortenRefname(sName))+"}"); } } else { @@ -455,11 +659,11 @@ public class FieldConverter extends ConverterHelper { String sFormat = node.getAttribute(XMLString.TEXT_REFERENCE_FORMAT); String sName = node.getAttribute(XMLString.TEXT_REF_NAME); if (("page".equals(sFormat) || "".equals(sFormat)) && sName!=null) { - ldp.append("\\pageref{ref:"+refnames.getExportName(sName)+"}"); + ldp.append("\\pageref{ref:"+refnames.getExportName(shortenRefname(sName))+"}"); } else if ("chapter".equals(sFormat) && ofr.referenceMarkInHeading(sName)) { // This is safe if the reference mark is contained in a heading - ldp.append("\\ref{ref:"+refnames.getExportName(sName)+"}"); + ldp.append("\\ref{ref:"+refnames.getExportName(shortenRefname(sName))+"}"); } else { // use current value palette.getInlineCv().traversePCDATA(node,ldp,oc); diff --git a/source/java/writer2latex/latex/InlineConverter.java b/source/java/writer2latex/latex/InlineConverter.java index 9450eb6..f9aafff 100644 --- a/source/java/writer2latex/latex/InlineConverter.java +++ b/source/java/writer2latex/latex/InlineConverter.java @@ -16,11 +16,11 @@ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * - * Copyright: 2002-2008 by Henrik Just + * Copyright: 2002-2010 by Henrik Just * * All Rights Reserved. * - * Version 1.0 (2008-11-22) + * Version 1.2 (2010-10-04) * */ @@ -195,7 +195,13 @@ public class InlineConverter extends ConverterHelper { case Node.TEXT_NODE: String s = childNode.getNodeValue(); if (s.length() > 0) { + if (oc.isInZoteroText()) { // Comment out Zotero citations + ldp.append("%"); + } ldp.append(palette.getI18n().convert(s, false, oc.getLang())); + if (oc.isInZoteroText()) { // End comment out + ldp.nl(); + } } break; @@ -319,6 +325,9 @@ public class InlineConverter extends ConverterHelper { else if (sName.equals(XMLString.TEXT_REFERENCE_MARK_START)) { palette.getFieldCv().handleReferenceMark(child,ldp,oc); } + else if (sName.equals(XMLString.TEXT_REFERENCE_MARK_END)) { + palette.getFieldCv().handleReferenceMarkEnd(child,ldp,oc); + } else if (sName.equals(XMLString.TEXT_REFERENCE_REF)) { palette.getFieldCv().handleReferenceRef(child,ldp,oc); } diff --git a/source/java/writer2latex/latex/LaTeXConfig.java b/source/java/writer2latex/latex/LaTeXConfig.java index 458bf4a..1d42e47 100644 --- a/source/java/writer2latex/latex/LaTeXConfig.java +++ b/source/java/writer2latex/latex/LaTeXConfig.java @@ -16,11 +16,11 @@ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * - * Copyright: 2002-2009 by Henrik Just + * Copyright: 2002-2010 by Henrik Just * * All Rights Reserved. * - * Version 1.2 (2009-11-02) + * Version 1.2 (2010-10-04) * */ @@ -48,7 +48,7 @@ public class LaTeXConfig extends writer2latex.base.ConfigBase { ///////////////////////////////////////////////////////////////////////// // I. Define items needed by ConfigBase - protected int getOptionCount() { return 65; } + protected int getOptionCount() { return 66; } protected String getDefaultConfigPath() { return "/writer2latex/latex/config/"; } ///////////////////////////////////////////////////////////////////////// @@ -144,37 +144,38 @@ public class LaTeXConfig extends writer2latex.base.ConfigBase { private static final int USE_BIBTEX = 31; private static final int BIBTEX_STYLE = 32; private static final int EXTERNAL_BIBTEX_FILES = 33; - private static final int FORMATTING = 34; - private static final int PAGE_FORMATTING = 35; - private static final int OTHER_STYLES = 36; - private static final int IMAGE_CONTENT = 37; - private static final int TABLE_CONTENT = 38; - private static final int TABLE_FIRST_HEAD_STYLE = 39; - private static final int TABLE_HEAD_STYLE = 40; - private static final int TABLE_FOOT_STYLE = 41; - private static final int TABLE_LAST_FOOT_STYLE = 42; - private static final int IGNORE_HARD_PAGE_BREAKS = 43; - private static final int IGNORE_HARD_LINE_BREAKS = 44; - private static final int IGNORE_EMPTY_PARAGRAPHS = 45; - private static final int IGNORE_DOUBLE_SPACES = 46; - private static final int ALIGN_FRAMES = 47; - private static final int FLOAT_FIGURES = 48; - private static final int FLOAT_TABLES = 49; - private static final int FLOAT_OPTIONS = 50; - private static final int FIGURE_SEQUENCE_NAME = 51; - private static final int TABLE_SEQUENCE_NAME = 52; - private static final int IMAGE_OPTIONS = 53; - private static final int REMOVE_GRAPHICS_EXTENSION = 54; - private static final int ORIGINAL_IMAGE_SIZE = 55; - private static final int SIMPLE_TABLE_LIMIT = 56; - private static final int NOTES = 57; - private static final int METADATA = 58; - private static final int TABSTOP = 59; - private static final int WRAP_LINES_AFTER = 60; - private static final int SPLIT_LINKED_SECTIONS = 61; - private static final int SPLIT_TOPLEVEL_SECTIONS = 62; - private static final int SAVE_IMAGES_IN_SUBDIR = 63; - private static final int DEBUG = 64; + private static final int ZOTERO_BIBTEX_FILES = 34; + private static final int FORMATTING = 35; + private static final int PAGE_FORMATTING = 36; + private static final int OTHER_STYLES = 37; + private static final int IMAGE_CONTENT = 38; + private static final int TABLE_CONTENT = 39; + private static final int TABLE_FIRST_HEAD_STYLE = 40; + private static final int TABLE_HEAD_STYLE = 41; + private static final int TABLE_FOOT_STYLE = 42; + private static final int TABLE_LAST_FOOT_STYLE = 43; + private static final int IGNORE_HARD_PAGE_BREAKS = 44; + private static final int IGNORE_HARD_LINE_BREAKS = 45; + private static final int IGNORE_EMPTY_PARAGRAPHS = 46; + private static final int IGNORE_DOUBLE_SPACES = 47; + private static final int ALIGN_FRAMES = 48; + private static final int FLOAT_FIGURES = 49; + private static final int FLOAT_TABLES = 50; + private static final int FLOAT_OPTIONS = 51; + private static final int FIGURE_SEQUENCE_NAME = 52; + private static final int TABLE_SEQUENCE_NAME = 53; + private static final int IMAGE_OPTIONS = 54; + private static final int REMOVE_GRAPHICS_EXTENSION = 55; + private static final int ORIGINAL_IMAGE_SIZE = 56; + private static final int SIMPLE_TABLE_LIMIT = 57; + private static final int NOTES = 58; + private static final int METADATA = 59; + private static final int TABSTOP = 60; + private static final int WRAP_LINES_AFTER = 61; + private static final int SPLIT_LINKED_SECTIONS = 62; + private static final int SPLIT_TOPLEVEL_SECTIONS = 63; + private static final int SAVE_IMAGES_IN_SUBDIR = 64; + private static final int DEBUG = 65; ///////////////////////////////////////////////////////////////////////// // IV. Our options data @@ -247,6 +248,7 @@ public class LaTeXConfig extends writer2latex.base.ConfigBase { options[USE_BIBTEX] = new BooleanOption("use_bibtex","false"); options[BIBTEX_STYLE] = new Option("bibtex_style","plain"); options[EXTERNAL_BIBTEX_FILES] = new Option("external_bibtex_files",""); + options[ZOTERO_BIBTEX_FILES] = new Option("zotero_bibtex_files",""); options[FORMATTING] = new IntegerOption("formatting","convert_basic") { public void setString(String sValue) { super.setString(sValue); @@ -656,6 +658,7 @@ public class LaTeXConfig extends writer2latex.base.ConfigBase { public boolean useBibtex() { return ((BooleanOption) options[USE_BIBTEX]).getValue(); } public String bibtexStyle() { return options[BIBTEX_STYLE].getString(); } public String externalBibtexFiles() { return options[EXTERNAL_BIBTEX_FILES].getString(); } + public String zoteroBibtexFiles() { return options[ZOTERO_BIBTEX_FILES].getString(); } // Formatting options public int formatting() { return ((IntegerOption) options[FORMATTING]).getValue(); } diff --git a/source/java/writer2latex/latex/SectionConverter.java b/source/java/writer2latex/latex/SectionConverter.java index 1ad40f7..064b0f1 100644 --- a/source/java/writer2latex/latex/SectionConverter.java +++ b/source/java/writer2latex/latex/SectionConverter.java @@ -20,12 +20,15 @@ * * All Rights Reserved. * - * Version 1.2 (2010-03-28) + * Version 1.2 (2010-10-06) * */ package writer2latex.latex; +import org.json.JSONArray; +import org.json.JSONException; +import org.json.JSONObject; import org.w3c.dom.Element; import org.w3c.dom.Node; @@ -56,6 +59,68 @@ public class SectionConverter extends ConverterHelper { public void appendDeclarations(LaTeXDocumentPortion pack, LaTeXDocumentPortion decl) { if (bNeedMulticol) { pack.append("\\usepackage{multicol}").nl(); } } + + // Handle a section as a Zotero bibliography + private boolean handleZoteroBibliography(Element node, LaTeXDocumentPortion ldp, Context oc) { + String sName = node.getAttribute(XMLString.TEXT_NAME); + if (config.useBibtex() && config.zoteroBibtexFiles().length()>0 && sName.startsWith("ZOTERO_BIBL")) { + // This section is a Zotero bibliography, and the user wishes to handle it as such + // A Zotero bibliography name has the form ZOTERO_BIBL with a single space separating the items + // The identifier is a unique identifier for the bibliography and is not used here + if (!config.noIndex()) { + // Parse the name (errors are ignored) and add \nocite commands as appropriate + int nObjectStart = sName.indexOf('{'); + int nObjectEnd = sName.lastIndexOf('}'); + if (nObjectStart>-1 && nObjectEnd>-1 && nObjectStart0) { + ldp.append("\\nocite{"); + for (int nIndex=0; nIndex0) { + ldp.append(","); + } + String sURI = null; + try { // Each item is an array containing a single string + sURI = uncited.getJSONArray(nIndex).getString(0); + } + catch (JSONException e) { + } + if (sURI!=null) { + int nSlash = sURI.lastIndexOf('/'); + if (nSlash>0) { ldp.append(sURI.substring(nSlash+1)); } + else { ldp.append(sURI); } + } + } + ldp.append("}").nl(); + } + } + } + } + + // Use the BibTeX style and files given in the configuration + ldp.append("\\bibliographystyle{").append(config.bibtexStyle()).append("}").nl() + .append("\\bibliography{").append(config.zoteroBibtexFiles()).append("}").nl(); + } + return true; + } + else { + return false; + } + } /**

Process a section (text:section tag)

* @param node The element containing the section @@ -102,7 +167,10 @@ public class SectionConverter extends ConverterHelper { if (sFileName!=null) { ldp.append("\\input{").append(sFileName).append("}").nl(); } - palette.getBlockCv().traverseBlockText(node,sectionLdp,ic); + // Zotero might have generated this section as a bibliograhy: + if (!handleZoteroBibliography(node,sectionLdp,ic)) { + palette.getBlockCv().traverseBlockText(node,sectionLdp,ic); + } if (sectionLdp!=ldp) { sectionLdp.append("\\endinput").nl(); } ldp.append(ba.getAfter()); } diff --git a/source/java/writer2latex/latex/util/Context.java b/source/java/writer2latex/latex/util/Context.java index cdaba86..d498a6c 100644 --- a/source/java/writer2latex/latex/util/Context.java +++ b/source/java/writer2latex/latex/util/Context.java @@ -16,11 +16,11 @@ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * - * Copyright: 2002-2009 by Henrik Just + * Copyright: 2002-2010 by Henrik Just * * All Rights Reserved. * - * Version 1.2 (2009-04-30) + * Version 1.2 (2010-10-04) * */ @@ -77,11 +77,14 @@ public class Context { // within a caption private boolean bInCaption = false; + + // within a Zotero citation + private boolean bInZoteroText = false; // within a floating figure (figure environment) private boolean bInFigureFloat = false; - // within a floating table (table envrionment) + // within a floating table (table environment) private boolean bInTableFloat = false; // within a minipage environment @@ -190,6 +193,10 @@ public class Context { public void setInCaption(boolean bInCaption) { this.bInCaption = bInCaption; } public boolean isInCaption() { return bInCaption; } + + public void setInZoteroText(boolean bInZoteroText) { this.bInZoteroText = bInZoteroText; } + + public boolean isInZoteroText() { return bInZoteroText; } public void setInFigureFloat(boolean bInFigureFloat) { this.bInFigureFloat = bInFigureFloat; } diff --git a/source/java/writer2latex/office/XMLString.java b/source/java/writer2latex/office/XMLString.java index 877ecdf..486f429 100644 --- a/source/java/writer2latex/office/XMLString.java +++ b/source/java/writer2latex/office/XMLString.java @@ -20,7 +20,7 @@ * * All Rights Reserved. * - * Version 1.2 (2010-05-09) + * Version 1.2 (2010-10-04) * */ @@ -315,6 +315,7 @@ public class XMLString { public static final String TEXT_TOC_MARK_END="text:toc-mark-end"; public static final String TEXT_REFERENCE_MARK="text:reference-mark"; public static final String TEXT_REFERENCE_MARK_START="text:reference-mark-start"; + public static final String TEXT_REFERENCE_MARK_END="text:reference-mark-end"; public static final String TEXT_REFERENCE_REF="text:reference-ref"; public static final String TEXT_BOOKMARK="text:bookmark"; public static final String TEXT_BOOKMARK_START="text:bookmark-start"; diff --git a/source/oxt/writer2latex/description.xml b/source/oxt/writer2latex/description.xml index e791d95..a005dbf 100644 --- a/source/oxt/writer2latex/description.xml +++ b/source/oxt/writer2latex/description.xml @@ -5,7 +5,7 @@ - + diff --git a/source/oxt/writer2xhtml/description.xml b/source/oxt/writer2xhtml/description.xml index a642906..935e407 100644 --- a/source/oxt/writer2xhtml/description.xml +++ b/source/oxt/writer2xhtml/description.xml @@ -5,7 +5,7 @@ - + diff --git a/source/oxt/writer4latex/description.xml b/source/oxt/writer4latex/description.xml index c5d003e..4ecb95d 100644 --- a/source/oxt/writer4latex/description.xml +++ b/source/oxt/writer4latex/description.xml @@ -4,7 +4,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink"> - + diff --git a/source/oxt/xhtml-config-sample/description.xml b/source/oxt/xhtml-config-sample/description.xml index 7954bac..c7f2657 100644 --- a/source/oxt/xhtml-config-sample/description.xml +++ b/source/oxt/xhtml-config-sample/description.xml @@ -2,5 +2,5 @@ - + diff --git a/source/readme-source.txt b/source/readme-source.txt index ff080ae..596c889 100644 --- a/source/readme-source.txt +++ b/source/readme-source.txt @@ -1,4 +1,4 @@ -Writer2LaTeX source version 1.1.4 +Writer2LaTeX source version 1.1.5 ================================= Writer2LaTeX is (c) 2002-2010 by Henrik Just. @@ -27,12 +27,35 @@ undocumented. This situation is improving from time to time :-) Third-party software -------------------- +From OpenOffice.org: + Writer2LaTeX includes some classes from the OpenOffice.org project: writer2latex.xmerge.* contains some classes which are part of the xmerge project within OOo (some of the classes are slightly modified) See copyright notices within the source files -Also, writer2latex.util.Base64 is Harald Harders public domain Base64 class + +From JSON.org: + +The classes org.json.* are copyright (c) 2002 JSON.org and is used subject to the following notice + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files +(the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, +publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +Fromiharder.sourceforge.net: + +The class writer2latex.util.Base64 is Robert Harders public domain Base64 class Building Writer2LaTeX