Lists java generator, updates version to 4.0.0-alpha

README.md

@@ -15,7 +15,10 @@ so developers can use all of those features.
 
 Currently, the following languages/frameworks are supported:
 
-- python
+- python (Stability: Stable)
+- java (Stability: Experimental)
+ - So far schema validation for v3.0.0-v3.0.3 has been implemented for Java
+ - If you want to use this generator as a Java client, please consider filing PRs adding openapi features in [this project](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/issues/290)
 
 ## Join Our Community
 We use a Discord server as a place to ask questions and help each other. It offers functionality very similar to Slack.
@@ -60,10 +63,49 @@ And many more!
 - [generated client sample code](samples/client/petstore/python)
  - [Openapi v3.0.3 general petstore spec, general features](src/test/resources/3_0/python/petstore_customized.yaml)
 - [generated v3.1.0 unit test client sample code](samples/client/3_1_0_unit_test/python)
-  - [Openapi json schema v3.1.0 unit test spec](src/test/resources/3_1/unit_test_spec/3_1_0_unit_test_spec.yaml)
+ - [Openapi json schema v3.1.0 unit test spec](src/test/resources/3_1/unit_test_spec/3_1_0_unit_test_spec.yaml)
 - [generated v3.0.3 unit test client sample code](samples/client/3_0_3_unit_test/python)
  - [Openapi json schema v3.0.3 unit test spec](src/test/resources/3_0/unit_test_spec/3_0_3_unit_test_spec.yaml)
 
+## Reasons To Use the Java Generator
+
+- v3.0.0 - [v3.0.3](docs/generators/java.md#schema-feature) OpenAPI Specification support for component schemas
+- Very [thorough documentation generated in the style of javadocs, includes code samples](samples/client/petstore/java/docs/components/schemas/Money.md#money)
+- Input types constrained for a Schema in SomeSchema.validate
+ - validate method can accept arbitrary List/Map/null/int/long/double/float/String json data
+- Immutable List output classes generated and returned by validate for List<?> input
+- Immutable Map output classes generated and returned by validate for Map<?,?> input
+- Strictly typed list input can be instantiated in client code using generated ListBuilders
+- Strictly typed map input can be instantiated in client code using generated MapBuilders
+ - Sequential map builders are generated ensuring that required properties are set before build is invoked. Looks like:
+ - `new MapBuilder().requiredA("a").requiredB("b").build()`
+ - `new MapBuilder().requiredA("a").requiredB("b").optionalProp("c").additionalProperty("someAddProp", "d").build()`
+- Run time type checking and validation when
+ - validating schema payloads
+ - instantiating List output class (validation run)
+ - instantiating Map output class (validation run)
+ - Note: if needed, validation of json schema keywords can be deactivated via a SchemaConfiguration class
+- Enums classes are generated and may be input into Schema.validate or the List/MapBuilder add/setter methods
+- The [Checker-Framework's](https://github.com/typetools/checker-framework) NullnessChecker and @Nullable annotations are used in the java client
+ - ensuring that null pointer exceptions will not happen
+- Invalid (in java) property names supported like `class`, `1var`, `hi-there` etc in
+ - schema property names (a fallback setter is written in the MapBuilder)
+- Generated interfaces are largely consistent with the python code
+- Openapi spec inline schemas supported at any depth in any location
+- Format support for: int32, int64, float, double, date, datetime, uuid
+- Payload values are not coerced when validated, so a datetime value can pass other validations that describe the payload only as type string
+- types are generated for enums of type string/integer/boolean using typing.Literal
+- String transmission of numbers supported with type: string, format: number, value can be accessed as a Decimal with schemas.as_decimal(inst)
+- [Autogenerated thorough testing of json schema keyword features in models and endpoints](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/tree/master/samples/client/3_0_3_unit_test/java/src/test/java/org/openapijsonschematools/client/schemas) which come from the [json schema test suite](https://github.com/json-schema-org/JSON-Schema-Test-Suite)
+- [Tests are passing in CI](https://app.circleci.com/pipelines/github/openapi-json-schema-tools/openapi-json-schema-generator?branch=master)
+
+And many more!
+- [Docs for the java generator](docs/generators/java.md)
+- [generated client sample code](samples/client/petstore/java)
+ - [Openapi v3.0.3 general petstore spec, general features](src/test/resources/3_0/python/petstore_customized.yaml)
+- [generated v3.0.3 unit test client sample code](samples/client/3_0_3_unit_test/java)
+ - [Openapi json schema v3.0.3 unit test spec](src/test/resources/3_0/unit_test_spec/3_0_3_unit_test_spec_nopaths.yaml)
+
 ### Can I build here?
 
 Yes; contributions are welcome!

pom.xml

@@ -446,7 +446,7 @@
  </dependencies>
  <properties>
  <!-- RELEASE_VERSION -->
- <revision>3.3.1</revision>
+ <revision>4.0.0-alpha</revision>
  <!-- /RELEASE_VERSION -->
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <java.version>11</java.version>