Initial wip

Author: rbygrave

.editorconfig

@@ -0,0 +1,12 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+spaces_around_operators = true

.gitignore

@@ -0,0 +1,5 @@
+target/
+build/
+.idea/
+*.iml
+.gradle

blackbox-test/pom.xml

@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>org.avaje.mason</groupId>
+    <artifactId>mason-parent</artifactId>
+    <version>0.1-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>blackbox-test</artifactId>
+  <name>blackbox test</name>
+  <description>test module</description>
+
+  <dependencies>
+
+    <dependency>
+      <groupId>org.avaje.mason</groupId>
+      <artifactId>mason-core</artifactId>
+      <version>0.1-SNAPSHOT</version>
+    </dependency>
+
+    <!-- test dependencies -->
+    <dependency>
+      <groupId>io.avaje</groupId>
+      <artifactId>junit</artifactId>
+      <version>1.0</version>
+      <scope>test</scope>
+    </dependency>
+
+  </dependencies>
+
+
+  <build>
+    <plugins>
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.8.1</version>
+        <configuration>
+          <source>1.8</source>
+          <target>1.8</target>
+          <!-- Turn off annotation processing for building -->
+          <compilerArgument>-proc:none</compilerArgument>
+        </configuration>
+      </plugin>
+
+      <plugin>
+        <groupId>org.moditect</groupId>
+        <artifactId>moditect-maven-plugin</artifactId>
+        <version>1.0.0.RC1</version>
+        <executions>
+          <execution>
+            <id>add-module-infos</id>
+            <phase>package</phase>
+            <goals>
+              <goal>add-module-info</goal>
+            </goals>
+            <configuration>
+              <module>
+                <moduleInfoFile>src/main/java9/module-info.java</moduleInfoFile>
+              </module>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
+    </plugins>
+  </build>
+
+</project>

mason-core/pom.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.avaje.mason</groupId>
+    <artifactId>mason-core</artifactId>
+    <version>0.1-SNAPSHOT</version>
+
+  <parent>
+    <groupId>org.avaje.mason</groupId>
+    <artifactId>mason-parent</artifactId>
+    <version>0.1-SNAPSHOT</version>
+  </parent>
+
+    <properties>
+        <maven.compiler.source>11</maven.compiler.source>
+        <maven.compiler.target>11</maven.compiler.target>
+    </properties>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-core</artifactId>
+            <version>2.12.5</version>
+        </dependency>
+
+        <dependency>
+            <groupId>io.avaje</groupId>
+            <artifactId>junit</artifactId>
+            <version>1.0</version>
+            <scope>test</scope>
+        </dependency>
+
+    </dependencies>
+
+</project>

mason-core/src/main/java/io/avaje/mason/JsonAdapter.java

@@ -0,0 +1,33 @@
+package io.avaje.mason;
+
+import java.io.IOException;
+import java.lang.annotation.Annotation;
+import java.lang.reflect.Type;
+import java.util.Set;
+import java.util.function.Supplier;
+
+public abstract class JsonAdapter<T> {
+
+  public void toJsonFrom(JsonWriter writer, Supplier<T> supplier) throws IOException {
+    toJson(writer, supplier.get());
+  }
+
+  public abstract void toJson(JsonWriter writer, T value) throws IOException;
+
+  public abstract T fromJson(JsonReader reader) throws IOException;
+
+  /**
+   * Return a null safe version of this adapter.
+   */
+  public final JsonAdapter<T> nullSafe() {
+    if (this instanceof NullSafeJsonAdapter) {
+      return this;
+    }
+    return new NullSafeJsonAdapter<>(this);
+  }
+
+  public interface Factory {
+
+    JsonAdapter<?> create(Type type, Set<? extends Annotation> annotations, Jsonb jsonb);
+  }
+}

mason-core/src/main/java/io/avaje/mason/JsonClass.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright (C) 2018 Square, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.avaje.mason;
+
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * Customizes how a type is encoded as JSON.
+ */
+@Retention(RUNTIME)
+@Documented
+public @interface JsonClass {
+
+  /**
+   * True to trigger the annotation processor to generate an adapter for this type.
+   *
+   * <p>There are currently some restrictions on which types that can be used with generated
+   * adapters:
+   *
+   * <ul>
+   *   <li>The class must be implemented in Kotlin (unless using a custom generator, see {@link
+   *       #generator()}).
+   *   <li>The class may not be an abstract class, an inner class, or a local class.
+   *   <li>All superclasses must be implemented in Kotlin.
+   *   <li>All properties must be public, protected, or internal.
+   *   <li>All properties must be either non-transient or have a default value.
+   * </ul>
+   */
+  boolean generateAdapter();
+
+  /**
+   * Not used yet.
+   */
+  String generator() default "";
+}

mason-core/src/main/java/io/avaje/mason/JsonDataException.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2015 Square, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.avaje.mason;
+
+/**
+ * Thrown when the data in a JSON document doesn't match the data expected by the caller. For
+ * example, suppose the application expects a boolean but the JSON document contains a string. When
+ * the call to {@link JsonReader#nextBoolean} is made, a {@code JsonDataException} is thrown.
+ *
+ * <p>Exceptions of this type should be fixed by either changing the application code to accept the
+ * unexpected JSON, or by changing the JSON to conform to the application's expectations.
+ *
+ * <p>This exception may also be triggered if a document's nesting exceeds 31 levels. This depth is
+ * sufficient for all practical applications, but shallow enough to avoid uglier failures like
+ * {@link StackOverflowError}.
+ */
+public final class JsonDataException extends RuntimeException {
+  public JsonDataException() {
+  }
+
+  public JsonDataException(String message) {
+    super(message);
+  }
+
+  public JsonDataException(Throwable cause) {
+    super(cause);
+  }
+
+  public JsonDataException(String message, Throwable cause) {
+    super(message, cause);
+  }
+}

mason-core/src/main/java/io/avaje/mason/JsonEncodingException.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright (C) 2016 Square, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.avaje.mason;
+
+import java.io.IOException;
+
+/**
+ * Thrown when the data being parsed is not encoded as valid JSON.
+ */
+public final class JsonEncodingException extends IOException {
+  public JsonEncodingException(String message) {
+    super(message);
+  }
+}

mason-core/src/main/java/io/avaje/mason/JsonQualifier.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright (C) 2015 Square, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.avaje.mason;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * Annotates another annotation, causing it to specialize how values are encoded and decoded.
+ */
+@Target(ANNOTATION_TYPE)
+@Retention(RUNTIME)
+@Documented
+public @interface JsonQualifier {
+}

mason-core/src/main/java/io/avaje/mason/JsonReader.java

@@ -0,0 +1,36 @@
+package io.avaje.mason;
+
+import java.io.IOException;
+
+public interface JsonReader {
+
+  void beginArray();
+
+  void endArray();
+
+  boolean hasNextElement() throws IOException;
+
+  void beginObject() throws IOException;
+
+  void endObject() throws IOException;
+
+  boolean hasNextField() throws IOException;
+
+  String nextField() throws IOException;
+
+  boolean nextBoolean() throws IOException;
+
+  int nextInt() throws IOException;
+
+  long nextLong() throws IOException;
+
+  String nextString() throws IOException;
+
+  boolean peekIsNull();
+
+  <T> T nextNull();
+
+  String path();
+
+  void promoteNameToValue();
+}

mason-core/src/main/java/io/avaje/mason/JsonType.java

@@ -0,0 +1,26 @@
+package io.avaje.mason;
+
+import java.io.*;
+import java.util.List;
+
+public interface JsonType<T> {
+
+  JsonType<List<T>> list();
+
+  String toJson(T bean) throws IOException;
+
+  void toJson(JsonWriter writer, T bean) throws IOException;
+
+  void toJson(Writer writer, T bean) throws IOException;
+
+  void toJson(OutputStream outputStream, T bean) throws IOException;
+
+  T fromJson(JsonReader reader) throws IOException;
+
+  T fromJson(String content) throws IOException;
+
+  T fromJson(Reader reader) throws IOException;
+
+  T fromJson(InputStream inputStream) throws IOException;
+
+}