update to latest code changes from json.org

source/net/yacy/cora/util/JSONException.java

@@ -6,26 +6,42 @@
 
 package net.yacy.cora.util;
 
-public class JSONException extends Exception {
-    /**
+/**
+ * The JSONException is thrown by the JSON.org classes when things are amiss.
  *
+ * @author JSON.org
+ * @version 2014-05-03
  */
+public class JSONException extends RuntimeException {
     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.
+     *
+     * @param message
+     *            Detail about the reason for the exception.
      */
-    protected JSONException(String message) {
+    public JSONException(String message) {
         super(message);
     }
 
-    protected JSONException(Throwable t) {
-        super(t.getMessage());
-        this.cause = t;
+    /**
+     * Constructs a new JSONException with the specified cause.
+     * @param cause The cause.
+     */
+    public JSONException(Throwable cause) {
+        super(cause.getMessage());
+        this.cause = cause;
     }
 
+    /**
+     * Returns the cause of this exception or null if the cause is nonexistent
+     * or unknown.
+     *
+     * @return the cause of this exception or null if the cause is nonexistent
+     *          or unknown.
+     */
     @Override
     public synchronized Throwable getCause() {
         return this.cause;

source/net/yacy/cora/util/JSONString.java

@@ -0,0 +1,18 @@
+package net.yacy.cora.util;
+/**
+ * The <code>JSONString</code> interface allows a <code>toJSONString()</code>
+ * method so that a class can change the behavior of
+ * <code>JSONObject.toString()</code>, <code>JSONArray.toString()</code>,
+ * and <code>JSONWriter.value(</code>Object<code>)</code>. The
+ * <code>toJSONString</code> method will be used instead of the default behavior
+ * of using the Object's <code>toString()</code> method and quoting the result.
+ */
+public interface JSONString {
+    /**
+     * The <code>toJSONString</code> method allows a class to produce its own JSON
+     * serialization.
+     *
+     * @return A strictly syntactically correct JSON text.
+     */
+    public String toJSONString();
+}

source/net/yacy/cora/util/JSONTokener.java

@@ -27,36 +27,38 @@ SOFTWARE.
  * it. It is used by the JSONObject and JSONArray constructors to parse
  * JSON source strings.
  * @author JSON.org
- * @version 2010-02-02
+ * @version 2014-05-03
  */
 
 package net.yacy.cora.util;
 
 import java.io.BufferedReader;
 import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
 import java.io.Reader;
 import java.io.StringReader;
 
-
 public class JSONTokener {
 
-    private int 	character;
+    private long    character;
     private boolean eof;
-    private int 	index;
-    private int 	line;
+    private long    index;
+    private long    line;
     private char    previous;
-    private final Reader 	reader;
+    private Reader  reader;
     private boolean usePrevious;
 
 
     /**
-     * Construct a JSONTokener from a reader.
+     * Construct a JSONTokener from a Reader.
      *
      * @param reader     A reader.
      */
     public JSONTokener(Reader reader) {
-        this.reader = reader.markSupported() ?
-        		reader : new BufferedReader(reader);
+        this.reader = reader.markSupported()
+            ? reader
+            : new BufferedReader(reader);
         this.eof = false;
         this.usePrevious = false;
         this.previous = 0;
@@ -66,6 +68,15 @@ public class JSONTokener {
     }
 
 
+    /**
+     * Construct a JSONTokener from an InputStream.
+     * @param inputStream The source.
+     */
+    public JSONTokener(InputStream inputStream) throws JSONException {
+        this(new InputStreamReader(inputStream));
+    }
+
+
     /**
      * Construct a JSONTokener from a string.
      *
@@ -122,11 +133,11 @@ public class JSONTokener {
      * @return true if not yet at the end of the source.
      */
     public boolean more() throws JSONException {
-        next();
-        if (end()) {
+        this.next();
+        if (this.end()) {
             return false;
         }
-        back();
+        this.back();
         return true;
     }
 
@@ -144,7 +155,7 @@ public class JSONTokener {
         } else {
             try {
                 c = this.reader.read();
-	        } catch (final IOException exception) {
+            } catch (IOException exception) {
                 throw new JSONException(exception);
             }
 
@@ -176,9 +187,9 @@ public class JSONTokener {
      * @throws JSONException if the character does not match.
      */
     public char next(char c) throws JSONException {
-        char n = next();
+        char n = this.next();
         if (n != c) {
-            throw syntaxError("Expected '" + c + "' and instead saw '" +
+            throw this.syntaxError("Expected '" + c + "' and instead saw '" +
                     n + "'");
         }
         return n;
@@ -199,17 +210,17 @@ public class JSONTokener {
              return "";
          }
 
-         char[] buffer = new char[n];
+         char[] chars = new char[n];
          int pos = 0;
 
          while (pos < n) {
-             buffer[pos] = next();
-             if (end()) {
-                 throw syntaxError("Substring bounds error");
+             chars[pos] = this.next();
+             if (this.end()) {
+                 throw this.syntaxError("Substring bounds error");
              }
              pos += 1;
          }
-         return new String(buffer);
+         return new String(chars);
      }
 
 
@@ -220,7 +231,7 @@ public class JSONTokener {
      */
     public char nextClean() throws JSONException {
         for (;;) {
-            char c = next();
+            char c = this.next();
             if (c == 0 || c > ' ') {
                 return c;
             }
@@ -243,14 +254,14 @@ public class JSONTokener {
         char c;
         StringBuilder sb = new StringBuilder();
         for (;;) {
-            c = next();
+            c = this.next();
             switch (c) {
             case 0:
             case '\n':
             case '\r':
-                throw syntaxError("Unterminated string");
+                throw this.syntaxError("Unterminated string");
             case '\\':
-                c = next();
+                c = this.next();
                 switch (c) {
                 case 'b':
                     sb.append('\b');
@@ -268,7 +279,7 @@ public class JSONTokener {
                     sb.append('\r');
                     break;
                 case 'u':
-                    sb.append((char)Integer.parseInt(next(4), 16));
+                    sb.append((char)Integer.parseInt(this.next(4), 16));
                     break;
                 case '"':
                 case '\'':
@@ -277,7 +288,7 @@ public class JSONTokener {
                     sb.append(c);
                     break;
                 default:
-                    throw syntaxError("Illegal escape.");
+                    throw this.syntaxError("Illegal escape.");
                 }
                 break;
             default:
@@ -293,16 +304,16 @@ public class JSONTokener {
     /**
      * Get the text up but not including the specified character or the
      * end of line, whichever comes first.
-     * @param  d A delimiter character.
+     * @param  delimiter A delimiter character.
      * @return   A string.
      */
-    public String nextTo(char d) throws JSONException {
+    public String nextTo(char delimiter) throws JSONException {
         StringBuilder sb = new StringBuilder();
         for (;;) {
-            char c = next();
-            if (c == d || c == 0 || c == '\n' || c == '\r') {
+            char c = this.next();
+            if (c == delimiter || c == 0 || c == '\n' || c == '\r') {
                 if (c != 0) {
-                    back();
+                    this.back();
                 }
                 return sb.toString().trim();
             }
@@ -321,11 +332,11 @@ public class JSONTokener {
         char c;
         StringBuilder sb = new StringBuilder();
         for (;;) {
-            c = next();
+            c = this.next();
             if (delimiters.indexOf(c) >= 0 || c == 0 ||
                     c == '\n' || c == '\r') {
                 if (c != 0) {
-                    back();
+                    this.back();
                 }
                 return sb.toString().trim();
             }
@@ -342,22 +353,19 @@ public class JSONTokener {
      * @return An object.
      */
     public Object nextValue() throws JSONException {
-        char c = nextClean();
-        String s;
+        char c = this.nextClean();
+        String string;
 
         switch (c) {
             case '"':
             case '\'':
-                return nextString(c);
+                return this.nextString(c);
             case '{':
-                back();
+                this.back();
                 return new JSONObject(this);
             case '[':
-            case '(':
-                back();
+                this.back();
                 return new JSONArray(this);
-        default:
-            break;
         }
 
         /*
@@ -372,15 +380,15 @@ public class JSONTokener {
         StringBuilder sb = new StringBuilder();
         while (c >= ' ' && ",:]}/\\\"[{;=#".indexOf(c) < 0) {
             sb.append(c);
-            c = next();
+            c = this.next();
         }
-        back();
+        this.back();
 
-        s = sb.toString().trim();
-        if (s.equals("")) {
-            throw syntaxError("Missing value");
+        string = sb.toString().trim();
+        if ("".equals(string)) {
+            throw this.syntaxError("Missing value");
         }
-        return JSONObject.stringToValue(s);
+        return JSONObject.stringToValue(string);
     }
 
 
@@ -394,12 +402,12 @@ public class JSONTokener {
     public char skipTo(char to) throws JSONException {
         char c;
         try {
-            int startIndex = this.index;
-            int startCharacter = this.character;
-            int startLine = this.line;
-            this.reader.mark(Integer.MAX_VALUE);
+            long startIndex = this.index;
+            long startCharacter = this.character;
+            long startLine = this.line;
+            this.reader.mark(1000000);
             do {
-                c = next();
+                c = this.next();
                 if (c == 0) {
                     this.reader.reset();
                     this.index = startIndex;
@@ -408,11 +416,10 @@ public class JSONTokener {
                     return c;
                 }
             } while (c != to);
-        } catch (final IOException exc) {
-            throw new JSONException(exc);
+        } catch (IOException exception) {
+            throw new JSONException(exception);
         }
-
-        back();
+        this.back();
         return c;
     }
 
@@ -424,7 +431,7 @@ public class JSONTokener {
      * @return  A JSONException object, suitable for throwing
      */
     public JSONException syntaxError(String message) {
-        return new JSONException(message + toString());
+        return new JSONException(message + this.toString());
     }
 
 
@@ -435,6 +442,7 @@ public class JSONTokener {
      */
     @Override
     public String toString() {
-        return " at " + this.index + " [character " + this.character + " line " + this.line + "]";
+        return " at " + this.index + " [character " + this.character + " line " +
+            this.line + "]";
     }
 }