add README

Author: taowen

demo/src/test/java/com/jsoniter/demo/FieldMatching.java

@@ -1,7 +1,7 @@
 package com.jsoniter.demo;
 
 import com.jsoniter.DecodingMode;
-import com.jsoniter.JsonException;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.JsonIterator;
 import com.jsoniter.annotation.JsonProperty;
 import com.jsoniter.annotation.JsonObject;

src/main/java/com/jsoniter/CodegenAccess.java

@@ -1,6 +1,7 @@
 package com.jsoniter;
 
 import com.jsoniter.spi.Decoder;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.JsoniterSpi;
 import com.jsoniter.spi.TypeLiteral;
 

src/main/java/com/jsoniter/CodegenImplNative.java

@@ -1,7 +1,7 @@
 package com.jsoniter;
 
 import com.jsoniter.any.Any;
-import com.jsoniter.spi.JsoniterSpi;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.TypeLiteral;
 
 import java.lang.reflect.ParameterizedType;

src/main/java/com/jsoniter/CodegenImplObject.java

@@ -4,7 +4,6 @@
 
 import java.lang.reflect.Type;
 import java.util.*;
-import java.util.zip.CRC32;
 
 class CodegenImplObject {
 
@@ -217,7 +216,7 @@ private static void appendMissingRequiredProperties(StringBuilder lines, ClassDe
             }
         }
         if (desc.onMissingProperties == null || !desc.ctor.parameters.isEmpty()) {
-            append(lines, "throw new com.jsoniter.JsonException(\"missing required properties: \" + missingFields);");
+            append(lines, "throw new com.jsoniter.spi.JsonException(\"missing required properties: \" + missingFields);");
         } else {
             if (desc.onMissingProperties.field != null) {
                 append(lines, String.format("obj.%s = missingFields;", desc.onMissingProperties.field.getName()));
@@ -230,7 +229,7 @@ private static void appendMissingRequiredProperties(StringBuilder lines, ClassDe
     private static void appendOnUnknownField(StringBuilder lines, ClassDescriptor desc) {
         if (desc.asExtraForUnknownProperties) {
             if (desc.onExtraProperties == null) {
-                append(lines, "throw new com.jsoniter.JsonException('extra property: ' + field.toString());".replace('\'', '"'));
+                append(lines, "throw new com.jsoniter.spi.JsonException('extra property: ' + field.toString());".replace('\'', '"'));
             } else {
                 append(lines, "if (extra == null) { extra = new java.util.HashMap(); }");
                 append(lines, "extra.put(field.toString(), iter.readAny());");
@@ -292,7 +291,7 @@ private static void addFieldDispatch(
                 Binding field = (Binding) entry.getValue();
                 if (field.asExtraWhenPresent) {
                     append(lines, String.format(
-                            "throw new com.jsoniter.JsonException('extra property: %s');".replace('\'', '"'),
+                            "throw new com.jsoniter.spi.JsonException('extra property: %s');".replace('\'', '"'),
                             field.name));
                 } else if (field.shouldSkip) {
                     append(lines, "iter.skip();");

src/main/java/com/jsoniter/JsonIterator.java

@@ -2,6 +2,7 @@
 
 import com.jsoniter.annotation.JsoniterAnnotationSupport;
 import com.jsoniter.any.Any;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.TypeLiteral;
 
 import java.io.Closeable;

src/main/java/com/jsoniter/README.md

@@ -0,0 +1,16 @@
+there are 7 packages, listed in abstraction level order
+
+# bottom abstraction
+
+* spi: bottom of the abstraction
+
+# concrete implementations
+
+* iterator/any: these two packages are tangled together, doing decoding
+* output: doing encoding, should only depend on spi
+
+# addons
+
+* annotation: make spi accessible with annotation. everything here can be done using code
+* fuzzy: pre-defined decoders to work with messy input
+* extra: extra encoders/decoders, useful for a lot of people, but not all of them

src/main/java/com/jsoniter/ReflectionCollectionDecoder.java

@@ -1,6 +1,7 @@
 package com.jsoniter;
 
 import com.jsoniter.spi.Decoder;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.TypeLiteral;
 
 import java.io.IOException;

src/main/java/com/jsoniter/ReflectionMapDecoder.java

@@ -1,6 +1,7 @@
 package com.jsoniter;
 
 import com.jsoniter.spi.Decoder;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.TypeLiteral;
 
 import java.io.IOException;

src/main/java/com/jsoniter/StaticCodeGenerator.java

@@ -3,6 +3,7 @@
 import com.jsoniter.output.EncodingMode;
 import com.jsoniter.output.JsonStream;
 import com.jsoniter.spi.CodegenConfig;
+import com.jsoniter.spi.JsonException;
 
 import java.io.File;
 

src/main/java/com/jsoniter/annotation/JsoniterAnnotationSupport.java

@@ -1,6 +1,6 @@
 package com.jsoniter.annotation;
 
-import com.jsoniter.JsonException;
+import com.jsoniter.spi.JsonException;
 import com.jsoniter.spi.*;
 
 import java.lang.annotation.Annotation;