summaryrefslogtreecommitdiff
path: root/java/src/com/google/polo/json/JSONString.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/src/com/google/polo/json/JSONString.java')
-rw-r--r--java/src/com/google/polo/json/JSONString.java18
1 files changed, 18 insertions, 0 deletions
diff --git a/java/src/com/google/polo/json/JSONString.java b/java/src/com/google/polo/json/JSONString.java
new file mode 100644
index 0000000..85824b9
--- /dev/null
+++ b/java/src/com/google/polo/json/JSONString.java
@@ -0,0 +1,18 @@
+package com.google.polo.json;
+/**
+ * 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();
+}