feat!: Remove the SPI and create the org.jsonurl.j2se package

BREAKING CHANGE

The service provider interface didn't provide any real world value so
it's been removed.

A new org.jsonurl.j2se package has been created. The JavaValueFactory
and JavaValueParser classes have been moved into it, and
JavaValueParser has been renamed to JsonUrlParser in order to be
consistent with the naming convention used in org.jsonurl.jsonorg
and org.jsonurl.jsr374.

Author: dmaccormack

module/jsonurl-core/src/main/java/org/jsonurl/JsonUrl.java

@@ -1,7 +1,7 @@
 package org.jsonurl;
 
 /*
- * Copyright 2019 David MacCormack
+ * Copyright 2019-2020 David MacCormack
  * 
  * 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
@@ -32,6 +32,7 @@
 
 import java.io.IOException;
 import java.nio.charset.MalformedInputException;
+import org.jsonurl.j2se.JavaValueFactory;
 
 /**
  * This class provides static methods for performing a number of
@@ -621,6 +622,7 @@ public static final <V> V parseLiteral(
      * {@link #parseLiteral(CharSequence, int, int, ValueFactory)
      * parseLiteral(s, start, length, JavaValueFactory.PRIMITIVE)}.
      * @see JsonUrl#parseLiteral(CharSequence, int, int, ValueFactory)
+     * @see JavaValueFactory#PRIMITIVE
      */
     public static final Object parseLiteral(
             CharSequence s,

module/jsonurl-core/src/main/java/org/jsonurl/Parser.java

@@ -47,7 +47,7 @@
  * with specific types and an instance of
  * {@link org.jsonurl.ValueFactory ValueFactory}. If you don't need
  * control over types you may use
- * {@link org.jsonurl.JavaValueParser JavaValueParser}. 
+ * {@link org.jsonurl.j2se.JsonUrlParser JsonUrlParser}. 
  *
  * @param V value type (any JSON value)
  * @param C composite type (array or object)

module/jsonurl-core/src/main/java/org/jsonurl/JavaValueFactory.java renamed to module/jsonurl-core/src/main/java/org/jsonurl/j2se/JavaValueFactory.java

@@ -1,4 +1,4 @@
-package org.jsonurl;
+package org.jsonurl.j2se;
 
 /*
  * Copyright 2019 David MacCormack
@@ -23,6 +23,10 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import org.jsonurl.NumberBuilder;
+import org.jsonurl.NumberText;
+import org.jsonurl.ValueFactory;
+import org.jsonurl.ValueType;
 
 /**
  * A {@link org.jsonurl.ValueFactory ValueFactory} based on Java SE data types.

module/jsonurl-core/src/main/java/org/jsonurl/JavaValueParser.java renamed to module/jsonurl-core/src/main/java/org/jsonurl/j2se/JsonUrlParser.java

@@ -1,7 +1,7 @@
-package org.jsonurl;
+package org.jsonurl.j2se;
 
 /*
- * Copyright 2019 David MacCormack
+ * Copyright 2019-2020 David MacCormack
  * 
  * 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
@@ -19,6 +19,7 @@
 
 import java.util.List;
 import java.util.Map;
+import org.jsonurl.Parser;
 
 /**
  * A {@link org.jsonurl.Parser Parser} based on Java SE data types.
@@ -27,7 +28,7 @@
  * @author David MacCormack
  * @since 2019-09-01
  */
-public class JavaValueParser extends Parser.TransparentBuilder<Object,
+public class JsonUrlParser extends Parser.TransparentBuilder<Object,
     Object,
     List<Object>,
     Map<String,Object>,
@@ -39,14 +40,14 @@ public class JavaValueParser extends Parser.TransparentBuilder<Object,
     /**
      * Instantiate a new Parser.
      */
-    public JavaValueParser() {
+    public JsonUrlParser() {
         this(JavaValueFactory.PRIMITIVE);
     }
 
     /**
      * Instantiate a new Parser.
      */
-    public JavaValueParser(JavaValueFactory factory) {
+    public JsonUrlParser(JavaValueFactory factory) {
         super(factory);
     }
 }

module/jsonurl-core/src/main/java/org/jsonurl/spi/package-info.java renamed to module/jsonurl-core/src/main/java/org/jsonurl/j2se/package-info.java

@@ -1,11 +1,17 @@
 /**
- * The JSON→URL service provider interface.
+ * This package provides an implementation of the JSON→URL parser
+ * based on Java SE datatypes.
+ *
+ * <p>The primary entry point for most use cases
+ * {@link org.jsonurl.j2se.JsonUrlParser JsonUrlParser}, which implements a
+ * JSON object model API to parse JSON&#x2192;URL text using Java SE types (e.g.
+ * {@link java.util.Map Map}, {@link java.util.List List}, etc).
  * 
  * @author jsonurl.org
  * @author David MacCormack
  * @since 2019-09-01
  */
-package org.jsonurl.spi;
+package org.jsonurl.j2se;
 
 /*
  * Copyright 2019 David MacCormack

module/jsonurl-core/src/main/java/org/jsonurl/package-info.java

@@ -1,15 +1,13 @@
 /**
  * This package provides an extensible JSON→URL parser core and
- * an implementation based on Java SE datatypes.
+ * static utility methods.
  *
- * <p>The primary entry point for most use cases
- * {@link org.jsonurl.JavaValueParser JavaValueParser}, which implements a
- * JSON object model API to parse JSON&#x2192;URL text using Java SE types (e.g.
- * {@link java.util.Map Map}, {@link java.util.List List}, etc).
- * 
  * <p>If you need a parser bound to your own JSON model API then
  * a {@link org.jsonurl.ValueFactory ValueFactory} may be created and
- * supplied to an instance of {@link org.jsonurl.Parser Parser}.
+ * supplied to an instance of {@link org.jsonurl.Parser Parser}. Otherwise,
+ * if a parser based on J2SE datatypes is sufficient then
+ * take a look at {@link org.jsonurl.j2se.JsonUrlParser JsonUrlParser} which
+ * does just that. 
  * 
  * @author jsonurl.org
  * @author David MacCormack

module/jsonurl-core/src/main/java/org/jsonurl/spi/JsonUrlServiceProvider.java

@@ -1,5 +1,7 @@
 package org.jsonurl;
 
+import org.jsonurl.j2se.JavaValueFactory;
+
 /*
  * Copyright 2019 David MacCormack
  * 

module/jsonurl-core/src/test/java/org/jsonurl/BigMathParseTest.java

@@ -1,5 +1,7 @@
 package org.jsonurl;
 
+import org.jsonurl.j2se.JavaValueFactory;
+
 /*
  * Copyright 2019 David MacCormack
  * 

module/jsonurl-core/src/test/java/org/jsonurl/DoubleParseTest.java

@@ -1,7 +1,7 @@
 package org.jsonurl;
 
 /*
- * Copyright 2019 David MacCormack
+ * Copyright 2019-2020 David MacCormack
  * 
  * 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
@@ -20,6 +20,7 @@
 
 import java.util.List;
 import java.util.Map;
+import org.jsonurl.j2se.JavaValueFactory;
 import org.junit.jupiter.api.Test;
 
 /**

module/jsonurl-core/src/test/java/org/jsonurl/JavaValueFactoryParseTest.java

@@ -19,6 +19,8 @@
 
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 
+import org.jsonurl.j2se.JavaValueFactory;
+import org.jsonurl.j2se.JsonUrlParser;
 import org.junit.jupiter.api.Test;
 
 /**
@@ -29,7 +31,7 @@ class JavaValueParserTest {
 
     @Test
     void testConstruct() {
-        assertNotNull(new JavaValueParser());
-        assertNotNull(new JavaValueParser(JavaValueFactory.PRIMITIVE));
+        assertNotNull(new JsonUrlParser());
+        assertNotNull(new JsonUrlParser(JavaValueFactory.PRIMITIVE));
     }
 }

module/jsonurl-core/src/test/java/org/jsonurl/JavaValueParserTest.java

@@ -1,5 +1,7 @@
 package org.jsonurl;
 
+import org.jsonurl.j2se.JavaValueFactory;
+
 /*
  * Copyright 2019 David MacCormack
  * 

module/jsonurl-core/src/test/java/org/jsonurl/PrimitiveParseTest.java

@@ -20,11 +20,11 @@
 import java.util.Set;
 import org.json.JSONArray;
 import org.json.JSONObject;
-import org.jsonurl.JavaValueFactory;
 import org.jsonurl.NumberBuilder;
 import org.jsonurl.NumberText;
 import org.jsonurl.ValueFactory;
 import org.jsonurl.ValueType;
+import org.jsonurl.j2se.JavaValueFactory;
 
 
 /**

module/jsonurl-jsonorg/src/main/java/org/jsonurl/jsonorg/JsonOrgServiceProvider.java

@@ -2,5 +2,5 @@
 # version information used for building snapshots
 #
 parent.version=3-SNAPSHOT
-module.version=1.2.0-SNAPSHOT
+module.version=2.0.0-SNAPSHOT