/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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
 *
 *      http://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 org.apache.juneau.annotation;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.RetentionPolicy.*;
import static org.apache.juneau.commons.utils.CollectionUtils.*;
import static org.apache.juneau.jsonschema.SchemaUtils.*;

import java.lang.annotation.*;
import java.lang.reflect.*;
import java.util.*;
import java.util.function.*;

import org.apache.juneau.*;
import org.apache.juneau.collections.*;
import org.apache.juneau.commons.annotation.*;
import org.apache.juneau.commons.reflect.*;
import org.apache.juneau.commons.utils.*;
import org.apache.juneau.parser.*;
import org.apache.juneau.svl.*;

/**
 * Utility classes and methods for the {@link Schema @Schema} annotation.
 *
 */
public class SchemaAnnotation {
   /**
    * Applies targeted {@link Schema} annotations to a {@link org.apache.juneau.Context.Builder}.
    */
   public static class Apply extends AnnotationApplier<Schema,Context.Builder> {

      /**
       * Constructor.
       *
       * @param vr The resolver for resolving values in annotations.
       */
      public Apply(VarResolverSession vr) {
         super(Schema.class, Context.Builder.class, vr);
      }

      @Override
      public void apply(AnnotationInfo<Schema> ai, Context.Builder b) {
         Schema a = ai.inner();
         if (isEmptyArray(a.on()) && isEmptyArray(a.onClass()))
            return;
         b.annotations(a);
      }
   }

   /**
    * A collection of {@link Schema @Schema annotations}.
    */
   @Documented
   @Target({ METHOD, TYPE })
   @Retention(RUNTIME)
   @Inherited
   public static @interface Array {

      /**
       * The child annotations.
       *
       * @return The annotation value.
       */
      Schema[] value();
   }

   /**
    * Builder class.
    *
    * <h5 class='section'>See Also:</h5><ul>
    *    <li class='jm'>{@link org.apache.juneau.BeanContext.Builder#annotations(Annotation...)}
    * </ul>
    */
   public static class Builder extends AppliedAnnotationObject.BuilderTMF {

      private boolean aev, allowEmptyValue, emax, emin, exclusiveMaximum, exclusiveMinimum, ignore, r, readOnly, required, ro, sie, skipIfEmpty, ui, uniqueItems;
      private ExternalDocs externalDocs = ExternalDocsAnnotation.DEFAULT;
      private Items items = ItemsAnnotation.DEFAULT;
      private long maxi = -1, maxItems = -1, maxl = -1, maxLength = -1, maxp = -1, maxProperties = -1, mini = -1, minItems = -1, minl = -1, minLength = -1, minp = -1, minProperties = -1;
      private String $ref = "", cf = "", collectionFormat = "", discriminator = "", f = "", format = "", max = "", maximum = "", min = "", minimum = "", mo = "", multipleOf = "", p = "",
         pattern = "", t = "", title = "", type = "";
      private String[] default_ = {}, enum_ = {}, additionalProperties = {}, allOf = {}, d = {}, description = {}, df = {}, e = {}, properties = {}, xml = {};
      private boolean deprecatedProperty;
      private String $id = "", contentMediaType = "", contentEncoding = "", exclusiveMaximumValue = "", exclusiveMinimumValue = "";
      private String[] const_ = {}, examples = {}, $comment = {}, prefixItems = {}, unevaluatedItems = {}, unevaluatedProperties = {}, dependentSchemas = {}, dependentRequired = {}, if_ = {},
         then_ = {}, else_ = {}, $defs = {};

      /**
       * Constructor.
       */
      protected Builder() {
         super(Schema.class);
      }

      /**
       * Sets the {@link Schema#const_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder const_(String...value) {
         const_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#default_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder default_(String...value) {
         default_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#else_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder else_(String...value) {
         else_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#enum_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder enum_(String...value) {
         enum_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#if_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder if_(String...value) {
         if_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#then_} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder then_(String...value) {
         then_ = value;
         return this;
      }

      /**
       * Sets the {@link Schema#$comment} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder $comment(String...value) {
         this.$comment = value;
         return this;
      }

      /**
       * Sets the {@link Schema#$defs} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder $defs(String...value) {
         this.$defs = value;
         return this;
      }

      /**
       * Sets the {@link Schema#$id} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder $id(String value) {
         this.$id = value;
         return this;
      }

      /**
       * Sets the {@link Schema#$ref} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder $ref(String value) {
         this.$ref = value;
         return this;
      }

      /**
       * Sets the {@link Schema#additionalProperties} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder additionalProperties(String...value) {
         additionalProperties = value;
         return this;
      }

      /**
       * Sets the {@link Schema#aev} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder aev(boolean value) {
         aev = value;
         return this;
      }

      /**
       * Sets the {@link Schema#allOf} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder allOf(String...value) {
         allOf = value;
         return this;
      }

      /**
       * Sets the {@link Schema#allowEmptyValue} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder allowEmptyValue(boolean value) {
         allowEmptyValue = value;
         return this;
      }

      /**
       * Instantiates a new {@link Schema @Schema} object initialized with this builder.
       *
       * @return A new {@link Schema @Schema} object.
       */
      public Schema build() {
         return new Object(this);
      }

      /**
       * Sets the description property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder description(String...value) {
         description = value;
         return this;
      }

      /**
       * Sets the {@link Schema#cf} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder cf(String value) {
         cf = value;
         return this;
      }

      /**
       * Sets the {@link Schema#collectionFormat} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder collectionFormat(String value) {
         collectionFormat = value;
         return this;
      }

      /**
       * Sets the {@link Schema#contentEncoding} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder contentEncoding(String value) {
         contentEncoding = value;
         return this;
      }

      /**
       * Sets the {@link Schema#contentMediaType} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder contentMediaType(String value) {
         contentMediaType = value;
         return this;
      }

      /**
       * Sets the {@link Schema#d} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder d(String...value) {
         d = value;
         return this;
      }

      /**
       * Sets the {@link Schema#dependentRequired} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder dependentRequired(String...value) {
         dependentRequired = value;
         return this;
      }

      /**
       * Sets the {@link Schema#dependentSchemas} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder dependentSchemas(String...value) {
         dependentSchemas = value;
         return this;
      }

      /**
       * Sets the {@link Schema#deprecatedProperty} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder deprecatedProperty(boolean value) {
         deprecatedProperty = value;
         return this;
      }

      /**
       * Sets the {@link Schema#df} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder df(String...value) {
         df = value;
         return this;
      }

      /**
       * Sets the {@link Schema#discriminator} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder discriminator(String value) {
         discriminator = value;
         return this;
      }

      /**
       * Sets the {@link Schema#e} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder e(String...value) {
         e = value;
         return this;
      }

      /**
       * Sets the {@link Schema#emax} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder emax(boolean value) {
         emax = value;
         return this;
      }

      /**
       * Sets the {@link Schema#emin} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder emin(boolean value) {
         emin = value;
         return this;
      }

      /**
       * Sets the {@link Schema#examples} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder examples(String...value) {
         examples = value;
         return this;
      }

      /**
       * Sets the {@link Schema#exclusiveMaximum} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder exclusiveMaximum(boolean value) {
         exclusiveMaximum = value;
         return this;
      }

      /**
       * Sets the {@link Schema#exclusiveMaximumValue} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder exclusiveMaximumValue(String value) {
         exclusiveMaximumValue = value;
         return this;
      }

      /**
       * Sets the {@link Schema#exclusiveMinimum} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder exclusiveMinimum(boolean value) {
         exclusiveMinimum = value;
         return this;
      }

      /**
       * Sets the {@link Schema#exclusiveMinimumValue} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder exclusiveMinimumValue(String value) {
         exclusiveMinimumValue = value;
         return this;
      }

      /**
       * Sets the {@link Schema#externalDocs} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder externalDocs(ExternalDocs value) {
         externalDocs = value;
         return this;
      }

      /**
       * Sets the {@link Schema#f} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder f(String value) {
         f = value;
         return this;
      }

      /**
       * Sets the {@link Schema#format} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder format(String value) {
         format = value;
         return this;
      }

      /**
       * Sets the {@link Schema#ignore} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder ignore(boolean value) {
         ignore = value;
         return this;
      }

      /**
       * Sets the {@link Schema#items} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder items(Items value) {
         items = value;
         return this;
      }

      /**
       * Sets the {@link Schema#max} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder max(String value) {
         max = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxi} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxi(long value) {
         maxi = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maximum} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maximum(String value) {
         maximum = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxItems} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxItems(long value) {
         maxItems = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxl} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxl(long value) {
         maxl = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxLength} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxLength(long value) {
         maxLength = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxp} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxp(long value) {
         maxp = value;
         return this;
      }

      /**
       * Sets the {@link Schema#maxProperties} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder maxProperties(long value) {
         maxProperties = value;
         return this;
      }

      /**
       * Sets the {@link Schema#min} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder min(String value) {
         min = value;
         return this;
      }

      /**
       * Sets the {@link Schema#mini} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder mini(long value) {
         mini = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minimum} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minimum(String value) {
         minimum = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minItems} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minItems(long value) {
         minItems = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minl} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minl(long value) {
         minl = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minLength} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minLength(long value) {
         minLength = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minp} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minp(long value) {
         minp = value;
         return this;
      }

      /**
       * Sets the {@link Schema#minProperties} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder minProperties(long value) {
         minProperties = value;
         return this;
      }

      /**
       * Sets the {@link Schema#mo} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder mo(String value) {
         mo = value;
         return this;
      }

      /**
       * Sets the {@link Schema#multipleOf} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder multipleOf(String value) {
         multipleOf = value;
         return this;
      }

      // -----------------------------------------------------------------------------------------------------------------
      // JSON Schema Draft 2020-12 property setters
      // -----------------------------------------------------------------------------------------------------------------

      /**
       * Sets the {@link Schema#p} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder p(String value) {
         p = value;
         return this;
      }

      /**
       * Sets the {@link Schema#pattern} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder pattern(String value) {
         pattern = value;
         return this;
      }

      /**
       * Sets the {@link Schema#prefixItems} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder prefixItems(String...value) {
         prefixItems = value;
         return this;
      }

      /**
       * Sets the {@link Schema#properties} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder properties(String...value) {
         properties = value;
         return this;
      }

      /**
       * Sets the {@link Schema#r} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder r(boolean value) {
         r = value;
         return this;
      }

      /**
       * Sets the {@link Schema#readOnly} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder readOnly(boolean value) {
         readOnly = value;
         return this;
      }

      /**
       * Sets the {@link Schema#required} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder required(boolean value) {
         required = value;
         return this;
      }

      /**
       * Sets the {@link Schema#ro} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder ro(boolean value) {
         ro = value;
         return this;
      }

      /**
       * Sets the {@link Schema#sie} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder sie(boolean value) {
         sie = value;
         return this;
      }

      /**
       * Sets the {@link Schema#skipIfEmpty} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder skipIfEmpty(boolean value) {
         skipIfEmpty = value;
         return this;
      }

      /**
       * Sets the {@link Schema#t} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder t(String value) {
         t = value;
         return this;
      }

      /**
       * Sets the {@link Schema#title} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder title(String value) {
         title = value;
         return this;
      }

      /**
       * Sets the {@link Schema#type} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder type(String value) {
         type = value;
         return this;
      }

      /**
       * Sets the {@link Schema#ui} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder ui(boolean value) {
         ui = value;
         return this;
      }

      /**
       * Sets the {@link Schema#unevaluatedItems} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder unevaluatedItems(String...value) {
         unevaluatedItems = value;
         return this;
      }

      /**
       * Sets the {@link Schema#unevaluatedProperties} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder unevaluatedProperties(String...value) {
         unevaluatedProperties = value;
         return this;
      }

      /**
       * Sets the {@link Schema#uniqueItems} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder uniqueItems(boolean value) {
         uniqueItems = value;
         return this;
      }

      /**
       * Sets the {@link Schema#xml} property on this annotation.
       *
       * @param value The new value for this property.
       * @return This object.
       */
      public Builder xml(String...value) {
         xml = value;
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.Builder */
      public Builder on(String...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderT */
      public Builder on(Class<?>...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedOnClassAnnotationObject.Builder */
      public Builder onClass(Class<?>...value) {
         super.onClass(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderM */
      public Builder on(Method...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderMF */
      public Builder on(Field...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderT */
      public Builder on(ClassInfo...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderT */
      public Builder onClass(ClassInfo...value) {
         super.onClass(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderTMF */
      public Builder on(FieldInfo...value) {
         super.on(value);
         return this;
      }

      @Override /* Overridden from AppliedAnnotationObject.BuilderTMF */
      public Builder on(MethodInfo...value) {
         super.on(value);
         return this;
      }

   }

   private static class Object extends AppliedOnClassAnnotationObject implements Schema {

      private final String[] description;
      private final boolean aev, allowEmptyValue, exclusiveMaximum, emax, exclusiveMinimum, emin, uniqueItems, ui, required, r, readOnly, ro, sie, skipIfEmpty, ignore;
      private final ExternalDocs externalDocs;
      private final Items items;
      private final long maxLength, maxl, minLength, minl, maxItems, maxi, minItems, mini, maxProperties, maxp, minProperties, minp;
      private final String $ref, format, f, title, multipleOf, mo, maximum, max, minimum, min, pattern, p, type, t, collectionFormat, cf, discriminator;
      private final String[] d, default_, df, enum_, e, allOf, properties, additionalProperties, xml;
      // JSON Schema Draft 2020-12 fields
      private final boolean deprecatedProperty;
      private final String $id, contentMediaType, contentEncoding, exclusiveMaximumValue, exclusiveMinimumValue;
      private final String[] const_, examples, $comment, prefixItems, unevaluatedItems, unevaluatedProperties, dependentSchemas, dependentRequired, if_, then_, else_, $defs;

      Object(SchemaAnnotation.Builder b) {
         super(b);
         description = copyOf(b.description);
         $ref = b.$ref;
         default_ = copyOf(b.default_);
         enum_ = copyOf(b.enum_);
         additionalProperties = copyOf(b.additionalProperties);
         allOf = copyOf(b.allOf);
         aev = b.aev;
         allowEmptyValue = b.allowEmptyValue;
         cf = b.cf;
         collectionFormat = b.collectionFormat;
         d = copyOf(b.d);
         df = copyOf(b.df);
         discriminator = b.discriminator;
         e = copyOf(b.e);
         emax = b.emax;
         emin = b.emin;
         exclusiveMaximum = b.exclusiveMaximum;
         exclusiveMinimum = b.exclusiveMinimum;
         externalDocs = b.externalDocs;
         f = b.f;
         format = b.format;
         ignore = b.ignore;
         items = b.items;
         max = b.max;
         maxi = b.maxi;
         maximum = b.maximum;
         maxItems = b.maxItems;
         maxl = b.maxl;
         maxLength = b.maxLength;
         maxp = b.maxp;
         maxProperties = b.maxProperties;
         min = b.min;
         mini = b.mini;
         minimum = b.minimum;
         minItems = b.minItems;
         minl = b.minl;
         minLength = b.minLength;
         minp = b.minp;
         minProperties = b.minProperties;
         mo = b.mo;
         multipleOf = b.multipleOf;
         p = b.p;
         pattern = b.pattern;
         properties = copyOf(b.properties);
         r = b.r;
         readOnly = b.readOnly;
         required = b.required;
         ro = b.ro;
         sie = b.sie;
         skipIfEmpty = b.skipIfEmpty;
         t = b.t;
         title = b.title;
         type = b.type;
         ui = b.ui;
         uniqueItems = b.uniqueItems;
         xml = copyOf(b.xml);
         deprecatedProperty = b.deprecatedProperty;
         $id = b.$id;
         contentMediaType = b.contentMediaType;
         contentEncoding = b.contentEncoding;
         exclusiveMaximumValue = b.exclusiveMaximumValue;
         exclusiveMinimumValue = b.exclusiveMinimumValue;
         const_ = copyOf(b.const_);
         examples = copyOf(b.examples);
         $comment = copyOf(b.$comment);
         prefixItems = copyOf(b.prefixItems);
         unevaluatedItems = copyOf(b.unevaluatedItems);
         unevaluatedProperties = copyOf(b.unevaluatedProperties);
         dependentSchemas = copyOf(b.dependentSchemas);
         dependentRequired = copyOf(b.dependentRequired);
         if_ = copyOf(b.if_);
         then_ = copyOf(b.then_);
         else_ = copyOf(b.else_);
         $defs = copyOf(b.$defs);
      }

      @Override /* Overridden from Schema */
      public String[] const_() {
         return const_;
      }

      @Override /* Overridden from Schema */
      public String[] default_() {
         return default_;
      }

      @Override /* Overridden from Schema */
      public String[] else_() {
         return else_;
      }

      @Override /* Overridden from Schema */
      public String[] enum_() {
         return enum_;
      }

      @Override /* Overridden from Schema */
      public String[] if_() {
         return if_;
      }

      @Override /* Overridden from Schema */
      public String[] then_() {
         return then_;
      }

      @Override /* Overridden from Schema */
      public String[] $comment() {
         return $comment;
      }

      @Override /* Overridden from Schema */
      public String[] $defs() {
         return $defs;
      }

      @Override /* Overridden from Schema */
      public String $id() {
         return $id;
      }

      @Override /* Overridden from Schema */
      public String $ref() {
         return $ref;
      }

      @Override /* Overridden from Schema */
      public String[] additionalProperties() {
         return additionalProperties;
      }

      @Override /* Overridden from Schema */
      public boolean aev() {
         return aev;
      }

      @Override /* Overridden from Schema */
      public String[] allOf() {
         return allOf;
      }

      @Override /* Overridden from Schema */
      public boolean allowEmptyValue() {
         return allowEmptyValue;
      }

      @Override /* Overridden from Schema */
      public String cf() {
         return cf;
      }

      @Override /* Overridden from Schema */
      public String collectionFormat() {
         return collectionFormat;
      }

      @Override /* Overridden from Schema */
      public String contentEncoding() {
         return contentEncoding;
      }

      @Override /* Overridden from Schema */
      public String contentMediaType() {
         return contentMediaType;
      }

      @Override /* Overridden from Schema */
      public String[] d() {
         return d;
      }

      @Override /* Overridden from Schema */
      public String[] dependentRequired() {
         return dependentRequired;
      }

      @Override /* Overridden from Schema */
      public String[] dependentSchemas() {
         return dependentSchemas;
      }

      @Override /* Overridden from Schema */
      public boolean deprecatedProperty() {
         return deprecatedProperty;
      }

      @Override /* Overridden from Schema */
      public String[] df() {
         return df;
      }

      @Override /* Overridden from Schema */
      public String discriminator() {
         return discriminator;
      }

      @Override /* Overridden from Schema */
      public String[] e() {
         return e;
      }

      @Override /* Overridden from Schema */
      public boolean emax() {
         return emax;
      }

      @Override /* Overridden from Schema */
      public boolean emin() {
         return emin;
      }

      @Override /* Overridden from Schema */
      public String[] examples() {
         return examples;
      }

      @Override /* Overridden from Schema */
      public boolean exclusiveMaximum() {
         return exclusiveMaximum;
      }

      @Override /* Overridden from Schema */
      public String exclusiveMaximumValue() {
         return exclusiveMaximumValue;
      }

      @Override /* Overridden from Schema */
      public boolean exclusiveMinimum() {
         return exclusiveMinimum;
      }

      @Override /* Overridden from Schema */
      public String exclusiveMinimumValue() {
         return exclusiveMinimumValue;
      }

      @Override /* Overridden from Schema */
      public ExternalDocs externalDocs() {
         return externalDocs;
      }

      @Override /* Overridden from Schema */
      public String f() {
         return f;
      }

      @Override /* Overridden from Schema */
      public String format() {
         return format;
      }

      @Override /* Overridden from Schema */
      public boolean ignore() {
         return ignore;
      }

      @Override /* Overridden from Schema */
      public Items items() {
         return items;
      }

      @Override /* Overridden from Schema */
      public String max() {
         return max;
      }

      @Override /* Overridden from Schema */
      public long maxi() {
         return maxi;
      }

      @Override /* Overridden from Schema */
      public String maximum() {
         return maximum;
      }

      @Override /* Overridden from Schema */
      public long maxItems() {
         return maxItems;
      }

      @Override /* Overridden from Schema */
      public long maxl() {
         return maxl;
      }

      @Override /* Overridden from Schema */
      public long maxLength() {
         return maxLength;
      }

      @Override /* Overridden from Schema */
      public long maxp() {
         return maxp;
      }

      @Override /* Overridden from Schema */
      public long maxProperties() {
         return maxProperties;
      }

      @Override /* Overridden from Schema */
      public String min() {
         return min;
      }

      @Override /* Overridden from Schema */
      public long mini() {
         return mini;
      }

      @Override /* Overridden from Schema */
      public String minimum() {
         return minimum;
      }

      @Override /* Overridden from Schema */
      public long minItems() {
         return minItems;
      }

      @Override /* Overridden from Schema */
      public long minl() {
         return minl;
      }

      @Override /* Overridden from Schema */
      public long minLength() {
         return minLength;
      }

      @Override /* Overridden from Schema */
      public long minp() {
         return minp;
      }

      @Override /* Overridden from Schema */
      public long minProperties() {
         return minProperties;
      }

      @Override /* Overridden from Schema */
      public String mo() {
         return mo;
      }

      @Override /* Overridden from Schema */
      public String multipleOf() {
         return multipleOf;
      }

      // -----------------------------------------------------------------------------------------------------------------
      // JSON Schema Draft 2020-12 property getters
      // -----------------------------------------------------------------------------------------------------------------

      @Override /* Overridden from Schema */
      public String p() {
         return p;
      }

      @Override /* Overridden from Schema */
      public String pattern() {
         return pattern;
      }

      @Override /* Overridden from Schema */
      public String[] prefixItems() {
         return prefixItems;
      }

      @Override /* Overridden from Schema */
      public String[] properties() {
         return properties;
      }

      @Override /* Overridden from Schema */
      public boolean r() {
         return r;
      }

      @Override /* Overridden from Schema */
      public boolean readOnly() {
         return readOnly;
      }

      @Override /* Overridden from Schema */
      public boolean required() {
         return required;
      }

      @Override /* Overridden from Schema */
      public boolean ro() {
         return ro;
      }

      @Override /* Overridden from Schema */
      public boolean sie() {
         return sie;
      }

      @Override /* Overridden from Schema */
      public boolean skipIfEmpty() {
         return skipIfEmpty;
      }

      @Override /* Overridden from Schema */
      public String t() {
         return t;
      }

      @Override /* Overridden from Schema */
      public String title() {
         return title;
      }

      @Override /* Overridden from Schema */
      public String type() {
         return type;
      }

      @Override /* Overridden from Schema */
      public boolean ui() {
         return ui;
      }

      @Override /* Overridden from Schema */
      public String[] unevaluatedItems() {
         return unevaluatedItems;
      }

      @Override /* Overridden from Schema */
      public String[] unevaluatedProperties() {
         return unevaluatedProperties;
      }

      @Override /* Overridden from Schema */
      public boolean uniqueItems() {
         return uniqueItems;
      }

      @Override /* Overridden from Schema */
      public String[] xml() {
         return xml;
      }

      @Override /* Overridden from annotation */
      public String[] description() {
         return description;
      }
   }

   /** Default value */
   public static final Schema DEFAULT = create().build();

   /**
    * Converts the specified <ja>@Schema</ja> annotation into a generic map.
    *
    * @param a The annotation instance.  Can be <jk>null</jk>.
    * @return The schema converted to a map, or and empty map if the annotation was null.
    * @throws ParseException Malformed input encountered.
    */
   @SuppressWarnings("deprecation")
   public static JsonMap asMap(Schema a) throws ParseException {
      if (a == null)
         return JsonMap.EMPTY_MAP;
      var m = new JsonMap();
      if (SchemaAnnotation.empty(a))
         return m;
      Predicate<String> ne = Utils::ne;
      Predicate<Collection<?>> nec = Utils::ne;
      Predicate<Map<?,?>> nem = Utils::ne;
      Predicate<Boolean> nf = Utils::isTrue;
      Predicate<Long> nm1 = Utils::nm1;
      // @formatter:off
      return m
         .appendIf(nem, "additionalProperties", parseMap(a.additionalProperties()))
         .appendIf(ne, "allOf", joinnl(a.allOf()))
         .appendFirst(ne, "collectionFormat", a.collectionFormat(), a.cf())
         .appendIf(ne, "default", joinnl(a.default_(), a.df()))
         .appendIf(ne, "discriminator", a.discriminator())
         .appendIf(ne, "description", joinnl(a.description(), a.d()))
         .appendFirst(nec, "enum", parseSet(a.enum_()), parseSet(a.e()))
         // Handle exclusiveMaximum with Draft 2020-12 fallback
         .appendIf(ne, "exclusiveMaximum",
            ne.test(a.exclusiveMaximumValue()) ? a.exclusiveMaximumValue() :
            (a.exclusiveMaximum() || a.emax()) ? "true" : null)
         // Handle exclusiveMinimum with Draft 2020-12 fallback
         .appendIf(ne, "exclusiveMinimum",
            ne.test(a.exclusiveMinimumValue()) ? a.exclusiveMinimumValue() :
            (a.exclusiveMinimum() || a.emin()) ? "true" : null)
         .appendIf(nem, "externalDocs", ExternalDocsAnnotation.merge(m.getMap("externalDocs"), a.externalDocs()))
         .appendFirst(ne, "format", a.format(), a.f())
         .appendIf(ne, "ignore", a.ignore() ? "true" : null)
         .appendIf(nem, "items", merge(m.getMap("items"), a.items()))
         .appendFirst(ne, "maximum", a.maximum(), a.max())
         .appendFirst(nm1, "maxItems", a.maxItems(), a.maxi())
         .appendFirst(nm1, "maxLength", a.maxLength(), a.maxl())
         .appendFirst(nm1, "maxProperties", a.maxProperties(), a.maxp())
         .appendFirst(ne, "minimum", a.minimum(), a.min())
         .appendFirst(nm1, "minItems", a.minItems(), a.mini())
         .appendFirst(nm1, "minLength", a.minLength(), a.minl())
         .appendFirst(nm1, "minProperties", a.minProperties(), a.minp())
         .appendFirst(ne, "multipleOf", a.multipleOf(), a.mo())
         .appendFirst(ne, "pattern", a.pattern(), a.p())
         .appendIf(nem, "properties", parseMap(a.properties()))
         .appendIf(nf, "readOnly", a.readOnly() || a.ro())
         .appendIf(nf, "required", a.required() || a.r())
         .appendIf(ne, "title", a.title())
         .appendFirst(ne, "type", a.type(), a.t())
         .appendIf(nf, "uniqueItems", a.uniqueItems() || a.ui())
         .appendIf(ne, "xml", joinnl(a.xml()))
         .appendIf(ne, "$ref", a.$ref())
         // JSON Schema Draft 2020-12 properties
         .appendIf(ne, "const", joinnl(a.const_()))
         .appendIf(nec, "examples", a.examples().length == 0 ? null : l(a.examples()))
         .appendIf(ne, "$comment", joinnl(a.$comment()))
         .appendIf(nf, "deprecated", a.deprecatedProperty())
         .appendIf(ne, "contentMediaType", a.contentMediaType())
         .appendIf(ne, "contentEncoding", a.contentEncoding())
         .appendIf(ne, "prefixItems", joinnl(a.prefixItems()))
         .appendIf(ne, "unevaluatedItems", joinnl(a.unevaluatedItems()))
         .appendIf(ne, "unevaluatedProperties", joinnl(a.unevaluatedProperties()))
         .appendIf(ne, "dependentSchemas", joinnl(a.dependentSchemas()))
         .appendIf(ne, "dependentRequired", joinnl(a.dependentRequired()))
         .appendIf(ne, "if", joinnl(a.if_()))
         .appendIf(ne, "then", joinnl(a.then_()))
         .appendIf(ne, "else", joinnl(a.else_()))
         .appendIf(ne, "$defs", joinnl(a.$defs()))
         .appendIf(ne, "$id", a.$id())
      ;
      // @formatter:on
   }

   /**
    * Instantiates a new builder for this class.
    *
    * @return A new builder object.
    */
   public static Builder create() {
      return new Builder();
   }

   /**
    * Instantiates a new builder for this class.
    *
    * @param on The targets this annotation applies to.
    * @return A new builder object.
    */
   public static Builder create(Class<?>...on) {
      return create().on(on);
   }

   /**
    * Instantiates a new builder for this class.
    *
    * @param on The targets this annotation applies to.
    * @return A new builder object.
    */
   public static Builder create(String...on) {
      return create().on(on);
   }

   /**
    * Returns <jk>true</jk> if the specified annotation contains all default values.
    *
    * @param a The annotation to check.
    * @return <jk>true</jk> if the specified annotation contains all default values.
    */
   public static boolean empty(Schema a) {
      return a == null || DEFAULT.equals(a);
   }

   private static JsonMap merge(JsonMap m, Items a) throws ParseException {
      if (ItemsAnnotation.empty(a))
         return m;
      Predicate<String> ne = Utils::ne;
      Predicate<Collection<?>> nec = Utils::ne;
      Predicate<Map<?,?>> nem = Utils::ne;
      Predicate<Boolean> nf = Utils::isTrue;
      Predicate<Long> nm1 = Utils::nm1;
      return m.appendFirst(ne, "collectionFormat", a.collectionFormat(), a.cf()).appendIf(ne, "default", joinnl(a.default_(), a.df())).appendFirst(nec, "enum", parseSet(a.enum_()), parseSet(a.e()))
         .appendFirst(ne, "format", a.format(), a.f()).appendIf(nf, "exclusiveMaximum", a.exclusiveMaximum() || a.emax()).appendIf(nf, "exclusiveMinimum", a.exclusiveMinimum() || a.emin())
         .appendIf(nem, "items", SubItemsAnnotation.merge(m.getMap("items"), a.items())).appendFirst(ne, "maximum", a.maximum(), a.max()).appendFirst(nm1, "maxItems", a.maxItems(), a.maxi())
         .appendFirst(nm1, "maxLength", a.maxLength(), a.maxl()).appendFirst(ne, "minimum", a.minimum(), a.min()).appendFirst(nm1, "minItems", a.minItems(), a.mini())
         .appendFirst(nm1, "minLength", a.minLength(), a.minl()).appendFirst(ne, "multipleOf", a.multipleOf(), a.mo()).appendFirst(ne, "pattern", a.pattern(), a.p())
         .appendIf(nf, "uniqueItems", a.uniqueItems() || a.ui()).appendFirst(ne, "type", a.type(), a.t()).appendIf(ne, "$ref", a.$ref());
   }
}