Java, adds schema contains (#360)

* Adds initial ContainsValidator

* Adds ContainsValidator, adds needed containsPathToSchemas input to the validate method

* Fixes 303 java unit tests

* Regenerates other java samples

* Docs updated, java 310 tests updated

* Fixes java test with list of only null

* Samples regen

* Deletes lingering FakeValidator.java

Author: spacether

docs/generators/java.md

@@ -277,7 +277,7 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |AllOf|✓|OAS2,OAS3
 |AnyOf|✓|OAS3
 |Const|✓|OAS3
-|Contains|✗|OAS3
+|Contains|✓|OAS3
 |Default|✓|OAS2,OAS3
 |DependentRequired|✗|OAS3
 |DependentSchemas|✗|OAS3

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

@@ -210,14 +210,14 @@ src/main/java/org/openapijsonschematools/client/schemas/validation/BooleanEnumVa
 src/main/java/org/openapijsonschematools/client/schemas/validation/BooleanSchemaValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/BooleanValueMethod.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/ConstValidator.java
+src/main/java/org/openapijsonschematools/client/schemas/validation/ContainsValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/CustomIsoparser.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/DefaultValueMethod.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/DoubleEnumValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/DoubleValueMethod.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/EnumValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/ExclusiveMaximumValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/ExclusiveMinimumValidator.java
-src/main/java/org/openapijsonschematools/client/schemas/validation/FakeValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/FloatEnumValidator.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/FloatValueMethod.java
 src/main/java/org/openapijsonschematools/client/schemas/validation/FormatValidator.java

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/AdditionalPropertiesValidator.java

@@ -15,7 +15,12 @@ public AdditionalPropertiesValidator(Class<? extends JsonSchema> additionalPrope
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         if (!(arg instanceof Map<?, ?> mapArg)) {
             return null;
         }

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/AllOfValidator.java

@@ -11,7 +11,12 @@ public AllOfValidator(List<Class<? extends JsonSchema>> allOf) {
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         PathToSchemasMap pathToSchemas = new PathToSchemasMap();
         for(Class<? extends JsonSchema> allOfClass: allOf) {
             JsonSchema allOfSchema = JsonSchemaFactory.getInstance(allOfClass);

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/AnyOfValidator.java

@@ -14,7 +14,12 @@ public AnyOfValidator(List<Class<? extends JsonSchema>> anyOf) {
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         PathToSchemasMap pathToSchemas = new PathToSchemasMap();
         List<Class<? extends JsonSchema>> validatedAnyOfClasses = new ArrayList<>();
         for(Class<? extends JsonSchema> anyOfClass: anyOf) {

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/ConstValidator.java

@@ -4,6 +4,7 @@
 import org.checkerframework.checker.nullness.qual.Nullable;
 
 import java.math.BigDecimal;
+import java.util.List;
 import java.util.Objects;
 
 public class ConstValidator extends BigDecimalValidator implements KeywordValidator {
@@ -14,7 +15,12 @@ public ConstValidator(@Nullable Object constValue) {
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         if (arg instanceof Number) {
             BigDecimal castArg = getBigDecimal((Number) arg);
             if (Objects.equals(castArg, constValue)) {

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/ContainsValidator.java

@@ -0,0 +1,77 @@
+package org.openapijsonschematools.client.schemas.validation;
+
+import org.checkerframework.checker.nullness.qual.Nullable;
+import org.openapijsonschematools.client.exceptions.ValidationException;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class ContainsValidator implements KeywordValidator {
+    public final Class<? extends JsonSchema> contains;
+
+    public ContainsValidator(Class<? extends JsonSchema> contains) {
+        this.contains = contains;
+    }
+
+    @Override
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
+        if (!(arg instanceof List)) {
+            return null;
+        }
+        if (containsPathToSchemas.isEmpty()) {
+            throw new ValidationException(
+                "Validation failed for contains keyword in class="+schema.getClass()
+                + " at pathToItem="+validationMetadata.pathToItem()+". No "
+                + "items validated to the contains schema."
+            );
+        }
+        PathToSchemasMap pathToSchemas = new PathToSchemasMap();
+        for (PathToSchemasMap otherPathToSchema: containsPathToSchemas) {
+            pathToSchemas.update(otherPathToSchema);
+        }
+        return pathToSchemas;
+    }
+
+    public List<PathToSchemasMap> getContainsPathToSchemas(
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata
+    ) {
+        if (!(arg instanceof List)) {
+            return new ArrayList<>();
+        }
+        List<PathToSchemasMap> containsPathToSchemas = new ArrayList<>();
+        int i = 0;
+        for(Object itemValue: (List<?>) arg) {
+            PathToSchemasMap thesePathToSchemas = new PathToSchemasMap();
+            List<Object> itemPathToItem = new ArrayList<>(validationMetadata.pathToItem());
+            itemPathToItem.add(i);
+            ValidationMetadata itemValidationMetadata = new ValidationMetadata(
+                    itemPathToItem,
+                    validationMetadata.configuration(),
+                    validationMetadata.validatedPathToSchemas(),
+                    validationMetadata.seenClasses()
+            );
+            JsonSchema containsSchema = JsonSchemaFactory.getInstance(contains);
+            if (itemValidationMetadata.validationRanEarlier(containsSchema)) {
+                // todo add_deeper_validated_schemas
+                containsPathToSchemas.add(thesePathToSchemas);
+                i += 1;
+                continue;
+            }
+
+            try {
+                PathToSchemasMap otherPathToSchemas = JsonSchema.validate(
+                        containsSchema, itemValue, itemValidationMetadata);
+                containsPathToSchemas.add(otherPathToSchemas);
+            } catch (ValidationException ignored) {
+                ;
+            }
+        }
+        return containsPathToSchemas;
+    }
+}

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/EnumValidator.java

@@ -4,6 +4,7 @@
 import org.checkerframework.checker.nullness.qual.Nullable;
 
 import java.math.BigDecimal;
+import java.util.List;
 import java.util.Set;
 
 public class EnumValidator extends BigDecimalValidator implements KeywordValidator {
@@ -19,7 +20,12 @@ private boolean enumContainsArg(@Nullable Object arg){
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         if (enumValues.isEmpty()) {
             throw new ValidationException("No value can match enum because enum is empty");
         }

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/ExclusiveMaximumValidator.java

@@ -3,6 +3,7 @@
 import org.openapijsonschematools.client.exceptions.ValidationException;
 import org.checkerframework.checker.nullness.qual.Nullable;
 
+import java.util.List;
 
 public class ExclusiveMaximumValidator implements KeywordValidator {
     public final Number exclusiveMaximum;
@@ -12,7 +13,12 @@ public ExclusiveMaximumValidator(Number exclusiveMaximum) {
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         if (!(arg instanceof Number)) {
             return null;
         }

samples/client/3_0_3_unit_test/java/src/main/java/org/openapijsonschematools/client/schemas/validation/ExclusiveMinimumValidator.java

@@ -3,6 +3,7 @@
 import org.openapijsonschematools.client.exceptions.ValidationException;
 import org.checkerframework.checker.nullness.qual.Nullable;
 
+import java.util.List;
 
 public class ExclusiveMinimumValidator implements KeywordValidator {
     public final Number exclusiveMinimum;
@@ -12,7 +13,12 @@ public ExclusiveMinimumValidator(Number exclusiveMinimum) {
     }
 
     @Override
-    public @Nullable PathToSchemasMap validate(JsonSchema schema, @Nullable Object arg, ValidationMetadata validationMetadata) {
+    public @Nullable PathToSchemasMap validate(
+        JsonSchema schema,
+        @Nullable Object arg,
+        ValidationMetadata validationMetadata,
+        List<PathToSchemasMap> containsPathToSchemas
+    ) {
         if (!(arg instanceof Number)) {
             return null;
         }