OpenAPI Generator v7: add Webhooks (#1469)

* Generate AcsWebhooks

* Generate ReportWebhooks

* Generate ConfigurationWebhooks

* Generate TransferWebhooks

* Generate TransactionWebhooks

* Generate NegativeBalanceWarningWebhooks

* Deprecate former WebhookHandler implementation

* Update tests

* Generate including javadoc

* Add javadoc for WebhookHandler template

* Generate DisputeWebhooks

* Generate ManagementWebhooks

* Deprecate former ManagementWebhook handler

* Update tests

Author: gcatanese

src/main/java/com/adyen/model/acswebhooks/AbstractOpenApiSchema.java

@@ -21,7 +21,6 @@
 /**
  * Abstract class for oneOf,anyOf schemas defined in OpenAPI spec
  */
-
 public abstract class AbstractOpenApiSchema {
 
     // store the actual instance of the schema/object
@@ -33,6 +32,11 @@ public abstract class AbstractOpenApiSchema {
     // schema type (e.g. oneOf, anyOf)
     private final String schemaType;
 
+    /**
+     *
+     * @param schemaType the schema type
+     * @param isNullable whether the instance is nullable
+    */
     public AbstractOpenApiSchema(String schemaType, Boolean isNullable) {
         this.schemaType = schemaType;
         this.isNullable = isNullable;

src/main/java/com/adyen/model/acswebhooks/AcsWebhooksHandler.java

@@ -0,0 +1,74 @@
+/*
+ * Authentication webhooks
+ *
+ * The version of the OpenAPI document: 1
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package com.adyen.model.acswebhooks;
+
+import java.util.Optional;
+import java.util.logging.Logger;
+
+/**
+ * Handler for processing AcsWebhooks.
+ * <p>
+ * This class provides functionality to deserialize the payload of AcsWebhooks events.
+ */
+public class AcsWebhooksHandler {
+
+    private static final Logger LOG = Logger.getLogger(AcsWebhooksHandler.class.getName());
+
+    private final String payload;
+
+    /**
+     * Constructs a new handler for the given webhook payload
+     *
+     * @param payload the raw JSON payload from the webhook
+     */
+    public AcsWebhooksHandler(String payload) {
+        this.payload = payload;
+    }
+
+    /**
+     * Attempts to deserialize the webhook payload into a AuthenticationNotificationRequest
+     *
+     * @return an Optional containing the deserialized object, or empty if deserialization fails
+     */
+    public Optional<AuthenticationNotificationRequest> getAuthenticationNotificationRequest() {
+        return getOptionalField(AuthenticationNotificationRequest.class);
+    }
+
+    /**
+     * Attempts to deserialize the webhook payload into a RelayedAuthenticationRequest
+     *
+     * @return an Optional containing the deserialized object, or empty if deserialization fails
+     */
+    public Optional<RelayedAuthenticationRequest> getRelayedAuthenticationRequest() {
+        return getOptionalField(RelayedAuthenticationRequest.class);
+    }
+
+    /**
+     * Deserializes the payload into the specified class type.
+     *
+     * @param clazz the class to deserialize into
+     * @param <T>   the type of the class
+     * @return an Optional containing the deserialized object, or empty if an error occurs
+    */
+    private <T> Optional<T> getOptionalField(Class<T> clazz) {
+        try {
+            T val = JSON.getMapper().readValue(payload, clazz);
+            return Optional.ofNullable(val);
+        } catch (Exception e) {
+            // an error has occurred during deserialization (object not found, deserialization error)
+            LOG.warning("Object not found or unexpected error trying to access:  " + clazz.getName());
+            LOG.warning("Deserialization error: " + e.getMessage());
+            return Optional.empty();
+        }
+    }
+
+}

src/main/java/com/adyen/model/acswebhooks/Amount.java

@@ -46,7 +46,7 @@ public Amount() {
   /**
    * The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    *
-   * @param currency
+   * @param currency The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    * @return the current {@code Amount} instance, allowing for method chaining
    */
   public Amount currency(String currency) {
@@ -56,7 +56,7 @@ public Amount currency(String currency) {
 
   /**
    * The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
-   * @return currency
+   * @return currency The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    */
   @JsonProperty(JSON_PROPERTY_CURRENCY)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
@@ -67,7 +67,7 @@ public String getCurrency() {
   /**
    * The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    *
-   * @param currency
+   * @param currency The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
    */
   @JsonProperty(JSON_PROPERTY_CURRENCY)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
@@ -78,7 +78,7 @@ public void setCurrency(String currency) {
   /**
    * The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    *
-   * @param value
+   * @param value The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    * @return the current {@code Amount} instance, allowing for method chaining
    */
   public Amount value(Long value) {
@@ -88,7 +88,7 @@ public Amount value(Long value) {
 
   /**
    * The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
-   * @return value
+   * @return value The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    */
   @JsonProperty(JSON_PROPERTY_VALUE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
@@ -99,7 +99,7 @@ public Long getValue() {
   /**
    * The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    *
-   * @param value
+   * @param value The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    */
   @JsonProperty(JSON_PROPERTY_VALUE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)

src/main/java/com/adyen/model/acswebhooks/AuthenticationDecision.java

@@ -77,7 +77,7 @@ public AuthenticationDecision() {
   /**
    * The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
    *
-   * @param status
+   * @param status The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
    * @return the current {@code AuthenticationDecision} instance, allowing for method chaining
    */
   public AuthenticationDecision status(StatusEnum status) {
@@ -87,7 +87,7 @@ public AuthenticationDecision status(StatusEnum status) {
 
   /**
    * The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
-   * @return status
+   * @return status The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
    */
   @JsonProperty(JSON_PROPERTY_STATUS)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
@@ -98,7 +98,7 @@ public StatusEnum getStatus() {
   /**
    * The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
    *
-   * @param status
+   * @param status The status of the authentication.   Possible values:   * **refused**   * **proceed**   For more information, refer to [Authenticate cardholders using the Authentication SDK](https://docs.adyen.com/issuing/3d-secure/oob-auth-sdk/authenticate-cardholders/).
    */
   @JsonProperty(JSON_PROPERTY_STATUS)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)