3rd party class customization

api/src/main/java/jakarta/json/bind/JsonbConfig.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2016, 2020 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2016, 2021 Oracle and/or its affiliates. All rights reserved.
  *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v. 2.0, which is available at
@@ -21,6 +21,7 @@
 import jakarta.json.bind.config.PropertyNamingStrategy;
 import jakarta.json.bind.config.PropertyVisibilityStrategy;
 
+import jakarta.json.bind.decorator.TypeDecorator;
 import jakarta.json.bind.serializer.JsonbDeserializer;
 import jakarta.json.bind.serializer.JsonbSerializer;
 
@@ -126,6 +127,11 @@ public class JsonbConfig {
      */
     public static final String DESERIALIZERS = "jsonb.derializers";
 
+    /**
+     * Property used to specify custom deserializers.
+     */
+    public static final String TYPE_DECORATORS = "jsonb.type-decorators";
+
     /**
      * Property used to specify custom binary data strategy.
      */
@@ -360,6 +366,21 @@ public final JsonbConfig withDeserializers(final JsonbDeserializer... deserializ
         return this;
     }
 
+    /**
+     * Property used to specify custom type decorators.
+     *
+     * Configures value of {@link #TYPE_DECORATORS} property.
+     *
+     * Calling withTypeDecorators more than once will merge the type decorators with previous value.
+     *
+     * @param typeDecorators Custom type decorators which affects deserialization and serialization of the decorated types.
+     * @return This JsonbConfig instance.
+     */
+    public final JsonbConfig withTypeDecorators(final TypeDecorator... typeDecorators) {
+        mergeProperties(TYPE_DECORATORS, typeDecorators, TypeDecorator.class);
+        return this;
+    }
+
     /**
      * Property used to specify custom binary data strategy.
      *

api/src/main/java/jakarta/json/bind/decorator/BuilderProviderLoader.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0, which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the
+ * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
+ * version 2 with the GNU Classpath Exception, which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ */
+
+package jakarta.json.bind.decorator;
+
+import java.security.AccessController;
+import java.security.PrivilegedAction;
+import java.util.ServiceLoader;
+
+import jakarta.json.bind.spi.DecoratorBuilderProvider;
+
+/**
+ * SPI loader of the {@link DecoratorBuilderProvider}.
+ */
+class BuilderProviderLoader {
+
+    private static DecoratorBuilderProvider instance = null;
+
+    private BuilderProviderLoader() {
+        throw new IllegalStateException("This class cannot be instantiated");
+    }
+
+    static DecoratorBuilderProvider provider() {
+        if (instance == null) {
+            synchronized (DecoratorBuilderProvider.class) {
+                if (instance != null) {
+                    return instance;
+                }
+                PrivilegedAction<DecoratorBuilderProvider> loader = () ->
+                        ServiceLoader.load(DecoratorBuilderProvider.class)
+                                .findFirst()
+                                .orElseThrow(() -> new IllegalStateException("Could not find any BuilderProvider implementation"));
+                instance = AccessController.doPrivileged(loader);
+            }
+        }
+        return instance;
+    }
+
+}

api/src/main/java/jakarta/json/bind/decorator/CommonDecorator.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0, which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the
+ * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
+ * version 2 with the GNU Classpath Exception, which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ */
+
+package jakarta.json.bind.decorator;
+
+import java.text.DateFormat;
+import java.text.NumberFormat;
+import java.util.Optional;
+
+import jakarta.json.bind.adapter.JsonbAdapter;
+import jakarta.json.bind.serializer.JsonbDeserializer;
+
+/**
+ * Common interface for all of the decorators.
+ */
+public interface CommonDecorator {
+
+    /**
+     * Return {@link NumberFormat} specified to the required {@link Scope}.
+     *
+     * @param scope required scope
+     * @return specified {@link NumberFormat} instance, otherwise empty
+     */
+    Optional<NumberFormat> numberFormat(Scope scope);
+
+    /**
+     * Return {@link DateFormat} specified to the required {@link Scope}.
+     *
+     * @param scope required scope
+     * @return specified {@link DateFormat} instance, otherwise empty
+     */
+    Optional<DateFormat> dateFormat(Scope scope);
+
+    /**
+     * Return {@link JsonbDeserializer} of the component.
+     *
+     * @return component deserializer instance, otherwise empty
+     */
+    Optional<JsonbDeserializer<?>> deserializer();
+
+    /**
+     * Return {@link JsonbAdapter} of the component.
+     *
+     * @return component adapter instance, otherwise empty
+     */
+    Optional<JsonbAdapter<?, ?>> adapter();
+
+    /**
+     * Return if the component can be nillable in the given {@link Scope}.
+     *
+     * @param scope required scope
+     * @return property nillable state, otherwise empty
+     */
+    Optional<Boolean> nillable(Scope scope);
+
+}

api/src/main/java/jakarta/json/bind/decorator/CommonDecoratorBuilder.java

@@ -0,0 +1,128 @@
+/*
+ * Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0, which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the
+ * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
+ * version 2 with the GNU Classpath Exception, which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ */
+
+package jakarta.json.bind.decorator;
+
+import java.text.DateFormat;
+import java.text.NumberFormat;
+import java.util.Locale;
+
+import jakarta.json.bind.adapter.JsonbAdapter;
+import jakarta.json.bind.serializer.JsonbDeserializer;
+
+/**
+ * Common interface for all decorator builders.
+ */
+public interface CommonDecoratorBuilder<T extends CommonDecoratorBuilder<T, B>, B> {
+
+    /**
+     * Whether this component can be nillable.
+     *
+     * @param nillable nillable component
+     * @return updated builder instance
+     */
+    T nillable(boolean nillable);
+
+    /**
+     * Set {@link JsonbDeserializer} which should be used.
+     *
+     * @param deserializer component deserializer
+     * @return updated builder instance
+     */
+    T deserializer(JsonbDeserializer<?> deserializer);
+
+    /**
+     * Set {@link JsonbAdapter} which should be used.
+     *
+     * @param adapter component adapter
+     * @return updated builder instance
+     */
+    T adapter(JsonbAdapter<?, ?> adapter);
+
+    /**
+     * Set number format and locale which should be used.
+     *
+     * @param numberFormat number format
+     * @param locale locale
+     * @return updated builder instance
+     */
+    T numberFormat(String numberFormat, Locale locale);
+
+    /**
+     * Set number format which should be used.
+     *
+     * @param numberFormat number format
+     * @return updated builder instance
+     */
+    T numberFormat(String numberFormat);
+
+    /**
+     * Set locale which should be used.
+     *
+     * @param locale locale
+     * @return updated builder instance
+     */
+    T numberFormat(Locale locale);
+
+    /**
+     * Set {@link NumberFormat} instance which should be used.
+     *
+     * @param numberFormat pre created NumberFormat instance
+     * @return updated builder instance
+     */
+    T numberFormat(NumberFormat numberFormat);
+
+    /**
+     * Set date format and locale which should be used.
+     *
+     * @param dateFormat date format
+     * @param locale locale
+     * @return updated builder instance
+     */
+    T dateFormat(String dateFormat, Locale locale);
+
+    /**
+     * Set date format which should be used.
+     *
+     * @param dateFormat date format
+     * @return updated builder instance
+     */
+    T dateFormat(String dateFormat);
+
+    /**
+     * Set locale which should be used.
+     *
+     * @param locale locale
+     * @return updated builder instance
+     */
+    T dateFormat(Locale locale);
+
+    /**
+     * Set {@link DateFormat} instance which should be used.
+     *
+     * @param dateFormat pre created DateFormat instance
+     * @return updated builder instance
+     */
+    T dateFormat(DateFormat dateFormat);
+
+    /**
+     * Build the new instance from this builder.
+     *
+     * @return new instance
+     */
+    B build();
+
+}

api/src/main/java/jakarta/json/bind/decorator/CreatorDecorator.java

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2021 Oracle and/or its affiliates. All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0, which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the
+ * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
+ * version 2 with the GNU Classpath Exception, which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ */
+
+package jakarta.json.bind.decorator;
+
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * Decorated creator customization.
+ */
+public interface CreatorDecorator {
+
+    /**
+     * Create new {@link CreatorDecoratorBuilder} instance.
+     *
+     * Builder created via this method targets constructors of the class it is bound to.
+     *
+     * @return new creator decorator builder instance
+     */
+    static CreatorDecoratorBuilder builder() {
+        return BuilderProviderLoader.provider().newCreatorDecoratorBuilder();
+    }
+
+    /**
+     * Create new {@link CreatorDecoratorBuilder} instance based on creator method name.
+     *
+     * @return new creator decorator builder instance
+     */
+    static CreatorDecoratorBuilder builder(String methodName) {
+        return BuilderProviderLoader.provider().newCreatorDecoratorBuilder(methodName);
+    }
+
+    /**
+     * Return creator method name if has been specified.
+     * If the name is empty, it is handled as if it is null.
+     *
+     * @return specified creator method name, otherwise empty
+     */
+    Optional<String> factoryMethodName();
+
+    /**
+     * Return {@link List} of the registered parameters. The order of the parameters needs to be the same as they were added.
+     * If no parameters were added, empty {@link List} is returned.
+     *
+     * @return creator parameters
+     */
+    List<ParamDecorator> params();
+
+}