Sample regen so docs can show correct type for list builder and build method

Author: spacether

samples/client/3_0_3_unit_test/java/.openapi-generator/FILES

@@ -263,6 +263,7 @@ src/test/java/org/openapijsonschematools/client/configurations/JsonSchemaKeyword
 src/test/java/org/openapijsonschematools/client/schemas/AnyTypeSchemaTest.java
 src/test/java/org/openapijsonschematools/client/schemas/ArrayTypeSchemaTest.java
 src/test/java/org/openapijsonschematools/client/schemas/BooleanSchemaTest.java
+src/test/java/org/openapijsonschematools/client/schemas/ListBuilderTest.java
 src/test/java/org/openapijsonschematools/client/schemas/ListSchemaTest.java
 src/test/java/org/openapijsonschematools/client/schemas/MapSchemaTest.java
 src/test/java/org/openapijsonschematools/client/schemas/NullSchemaTest.java

samples/client/3_0_3_unit_test/java/docs/components/schemas/ArrayTypeMatchesArrays.md

@@ -58,7 +58,7 @@ ArrayTypeMatchesArrays.ArrayTypeMatchesArraysList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## ArrayTypeMatchesArraysListBuilder
 public class ArrayTypeMatchesArraysListBuilder<br>
-builder for `List<? extends @Nullable Object>`
+builder for `List<@Nullable Object>`
 
 A class that builds the List input type
 
@@ -80,7 +80,7 @@ A class that builds the List input type
 | ArrayTypeMatchesArraysListBuilder | add(double item) |
 | ArrayTypeMatchesArraysListBuilder | add(List<?> item) |
 | ArrayTypeMatchesArraysListBuilder | add(Map<String, ?> item) |
-| List<? extends @Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
+| List<@Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## ArrayTypeMatchesArraysList
 public class ArrayTypeMatchesArraysList<br>

samples/client/3_0_3_unit_test/java/docs/components/schemas/RefInItems.md

@@ -57,7 +57,7 @@ RefInItems.RefInItemsList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## RefInItemsListBuilder
 public class RefInItemsListBuilder<br>
-builder for `List<? extends @Nullable Object>`
+builder for `List<@Nullable Object>`
 
 A class that builds the List input type
 
@@ -79,7 +79,7 @@ A class that builds the List input type
 | RefInItemsListBuilder | add(double item) |
 | RefInItemsListBuilder | add(List<?> item) |
 | RefInItemsListBuilder | add(Map<String, ?> item) |
-| List<? extends @Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
+| List<@Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## RefInItemsList
 public class RefInItemsList<br>

samples/client/3_0_3_unit_test/java/src/test/java/org/openapijsonschematools/client/schemas/ListBuilderTest.java

@@ -0,0 +1,61 @@
+package org.openapijsonschematools.client.schemas;
+
+import org.checkerframework.checker.nullness.qual.Nullable;
+import org.junit.Assert;
+import org.junit.Test;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class ListBuilderTest {
+ public static class NullableListWithNullableItemsListBuilder {
+ // class to build List<@Nullable List<Number>>
+ private final List<@Nullable List<Number>> list;
+
+ public NullableListWithNullableItemsListBuilder() {
+ list = new ArrayList<>();
+ }
+
+ public NullableListWithNullableItemsListBuilder(List<@Nullable List<Number>> list) {
+ this.list = list;
+ }
+
+ public NullableListWithNullableItemsListBuilder add(Void item) {
+ list.add(null);
+ return this;
+ }
+
+ public NullableListWithNullableItemsListBuilder add(List<Number> item) {
+ list.add(item);
+ return this;
+ }
+
+ public List<@Nullable List<Number>> build() {
+ return list;
+ }
+ }
+
+ @Test
+ public void testSucceedsWithNullInput() {
+ List<@Nullable List<Number>> inList = new ArrayList<>();
+ inList.add(null);
+ var builder = new NullableListWithNullableItemsListBuilder(inList);
+ Assert.assertEquals(inList, builder.build());
+
+ builder = new NullableListWithNullableItemsListBuilder();
+ builder.add((Void) null);
+ Assert.assertEquals(inList, builder.build());
+ }
+
+ @Test
+ public void testSucceedsWithNonNullInput() {
+ List<List<Number>> inList = new ArrayList<>();
+ inList.add(List.of(1));
+ var builder = new NullableListWithNullableItemsListBuilder(inList);
+ Assert.assertEquals(inList, builder.build());
+
+ builder = new NullableListWithNullableItemsListBuilder();
+ builder.add(List.of(1));
+ Assert.assertEquals(inList, builder.build());
+ }
+}

samples/client/petstore/java/docs/components/requestbodies/userarray/content/applicationjson/Schema.md

@@ -95,7 +95,7 @@ Schema.SchemaList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## SchemaListBuilder
 public class SchemaListBuilder<br>
-builder for `List<Map<String, ? extends @Nullable Object>>`
+builder for `List<Map<String, @Nullable Object>>`
 
 A class that builds the List input type
 
@@ -109,7 +109,7 @@ A class that builds the List input type
 | Modifier and Type | Method and Description |
 | ----------------- | ---------------------- |
 | SchemaListBuilder | add(Map<String, @Nullable Object> item) |
-| List<Map<String, ? extends @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
+| List<Map<String, @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## SchemaList
 public class SchemaList<br>

samples/client/petstore/java/docs/components/responses/successfulxmlandjsonarrayofpet/content/applicationjson/Schema.md

@@ -101,7 +101,7 @@ Schema.SchemaList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## SchemaListBuilder
 public class SchemaListBuilder<br>
-builder for `List<Map<String, ? extends @Nullable Object>>`
+builder for `List<Map<String, @Nullable Object>>`
 
 A class that builds the List input type
 
@@ -115,7 +115,7 @@ A class that builds the List input type
 | Modifier and Type | Method and Description |
 | ----------------- | ---------------------- |
 | SchemaListBuilder | add(Map<String, @Nullable Object> item) |
-| List<Map<String, ? extends @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
+| List<Map<String, @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## SchemaList
 public class SchemaList<br>

samples/client/petstore/java/docs/components/responses/successfulxmlandjsonarrayofpet/content/applicationxml/Schema.md

@@ -101,7 +101,7 @@ Schema.SchemaList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## SchemaListBuilder
 public class SchemaListBuilder<br>
-builder for `List<Map<String, ? extends @Nullable Object>>`
+builder for `List<Map<String, @Nullable Object>>`
 
 A class that builds the List input type
 
@@ -115,7 +115,7 @@ A class that builds the List input type
 | Modifier and Type | Method and Description |
 | ----------------- | ---------------------- |
 | SchemaListBuilder | add(Map<String, @Nullable Object> item) |
-| List<Map<String, ? extends @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
+| List<Map<String, @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## SchemaList
 public class SchemaList<br>

samples/client/petstore/java/docs/components/schemas/AnimalFarm.md

@@ -67,7 +67,7 @@ AnimalFarm.AnimalFarmList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## AnimalFarmListBuilder
 public class AnimalFarmListBuilder<br>
-builder for `List<Map<String, ? extends @Nullable Object>>`
+builder for `List<Map<String, @Nullable Object>>`
 
 A class that builds the List input type
 
@@ -81,7 +81,7 @@ A class that builds the List input type
 | Modifier and Type | Method and Description |
 | ----------------- | ---------------------- |
 | AnimalFarmListBuilder | add(Map<String, @Nullable Object> item) |
-| List<Map<String, ? extends @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
+| List<Map<String, @Nullable Object>> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## AnimalFarmList
 public class AnimalFarmList<br>

samples/client/petstore/java/docs/components/schemas/ArrayHoldingAnyType.md

@@ -58,7 +58,7 @@ ArrayHoldingAnyType.ArrayHoldingAnyTypeList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## ArrayHoldingAnyTypeListBuilder
 public class ArrayHoldingAnyTypeListBuilder<br>
-builder for `List<? extends @Nullable Object>`
+builder for `List<@Nullable Object>`
 
 A class that builds the List input type
 
@@ -80,7 +80,7 @@ A class that builds the List input type
 | ArrayHoldingAnyTypeListBuilder | add(double item) |
 | ArrayHoldingAnyTypeListBuilder | add(List<?> item) |
 | ArrayHoldingAnyTypeListBuilder | add(Map<String, ?> item) |
-| List<? extends @Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
+| List<@Nullable Object> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## ArrayHoldingAnyTypeList
 public class ArrayHoldingAnyTypeList<br>

samples/client/petstore/java/docs/components/schemas/ArrayOfEnums.md

@@ -58,7 +58,7 @@ ArrayOfEnums.ArrayOfEnumsList validatedPayload =
 | @Nullable Object | validate(@Nullable Object arg, SchemaConfiguration configuration) |
 ## ArrayOfEnumsListBuilder
 public class ArrayOfEnumsListBuilder<br>
-builder for `List<? extends @Nullable String>`
+builder for `List<@Nullable String>`
 
 A class that builds the List input type
 
@@ -75,7 +75,7 @@ A class that builds the List input type
 | ArrayOfEnumsListBuilder | add(String item) |
 | ArrayOfEnumsListBuilder | add([StringEnum.StringStringEnumEnums](../../components/schemas/StringEnum.md#stringstringenumenums) item) |
 | ArrayOfEnumsListBuilder | add([StringEnum.NullStringEnumEnums](../../components/schemas/StringEnum.md#nullstringenumenums) item) |
-| List<? extends @Nullable String> | build()<br>Returns list input that should be used with Schema.validate |
+| List<@Nullable String> | build()<br>Returns list input that should be used with Schema.validate |
 
 ## ArrayOfEnumsList
 public class ArrayOfEnumsList<br>