POS Mobile API (#1463)

* Update templates to generate javadoc

* Generate PosMobileAPI

* Add deprecation

Author: gcatanese

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

@@ -13,7 +13,6 @@
 package com.adyen.model.posmobile;
 
 import java.util.Objects;
-import java.lang.reflect.Type;
 import java.util.Map;
 import jakarta.ws.rs.core.GenericType;
 
@@ -22,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
@@ -34,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;
@@ -44,7 +47,7 @@ public AbstractOpenApiSchema(String schemaType, Boolean isNullable) {
      *
      * @return an instance of the actual schema/object
      */
-    public abstract Map<String, GenericType> getSchemas();
+    public abstract Map<String, GenericType<?>> getSchemas();
 
     /**
      * Get the actual instance
@@ -144,4 +147,4 @@ public Boolean isNullable() {
 
 
 
-}
+}

src/main/java/com/adyen/model/posmobile/CreateSessionRequest.java

@@ -13,16 +13,14 @@
 package com.adyen.model.posmobile;
 
 import java.util.Objects;
-import java.util.Arrays;
 import java.util.Map;
 import java.util.HashMap;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.fasterxml.jackson.annotation.JsonCreator;
 import com.fasterxml.jackson.annotation.JsonTypeName;
 import com.fasterxml.jackson.annotation.JsonValue;
-import io.swagger.annotations.ApiModel;
-import io.swagger.annotations.ApiModelProperty;
+import java.util.Arrays;
 import com.fasterxml.jackson.annotation.JsonPropertyOrder;
 import com.fasterxml.jackson.core.JsonProcessingException;
 
@@ -52,7 +50,7 @@ public CreateSessionRequest() {
   /**
    * The unique identifier of your merchant account.
    *
-   * @param merchantAccount
+   * @param merchantAccount The unique identifier of your merchant account.
    * @return the current {@code CreateSessionRequest} instance, allowing for method chaining
    */
   public CreateSessionRequest merchantAccount(String merchantAccount) {
@@ -62,9 +60,8 @@ public CreateSessionRequest merchantAccount(String merchantAccount) {
 
   /**
    * The unique identifier of your merchant account.
-   * @return merchantAccount
+   * @return merchantAccount The unique identifier of your merchant account.
    */
-  @ApiModelProperty(required = true, value = "The unique identifier of your merchant account.")
   @JsonProperty(JSON_PROPERTY_MERCHANT_ACCOUNT)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getMerchantAccount() {
@@ -74,8 +71,8 @@ public String getMerchantAccount() {
   /**
    * The unique identifier of your merchant account.
    *
-   * @param merchantAccount
-   */ 
+   * @param merchantAccount The unique identifier of your merchant account.
+   */
   @JsonProperty(JSON_PROPERTY_MERCHANT_ACCOUNT)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setMerchantAccount(String merchantAccount) {
@@ -85,7 +82,7 @@ public void setMerchantAccount(String merchantAccount) {
   /**
    * The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
    *
-   * @param setupToken
+   * @param setupToken The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
    * @return the current {@code CreateSessionRequest} instance, allowing for method chaining
    */
   public CreateSessionRequest setupToken(String setupToken) {
@@ -95,9 +92,8 @@ public CreateSessionRequest setupToken(String setupToken) {
 
   /**
    * The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
-   * @return setupToken
+   * @return setupToken The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
    */
-  @ApiModelProperty(required = true, value = "The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.")
   @JsonProperty(JSON_PROPERTY_SETUP_TOKEN)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getSetupToken() {
@@ -107,8 +103,8 @@ public String getSetupToken() {
   /**
    * The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
    *
-   * @param setupToken
-   */ 
+   * @param setupToken The setup token provided by the POS Mobile SDK.  - When using the Android POS Mobile SDK, obtain the token through the `AuthenticationService.authenticate(setupToken)` callback of `AuthenticationService`.  - When using the iOS POS Mobile SDK, obtain the token through the `PaymentServiceDelegate.register(with:)` callback of `PaymentServiceDelegate`.
+   */
   @JsonProperty(JSON_PROPERTY_SETUP_TOKEN)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setSetupToken(String setupToken) {
@@ -118,7 +114,7 @@ public void setSetupToken(String setupToken) {
   /**
    * The unique identifier of the store that you want to process transactions for.
    *
-   * @param store
+   * @param store The unique identifier of the store that you want to process transactions for.
    * @return the current {@code CreateSessionRequest} instance, allowing for method chaining
    */
   public CreateSessionRequest store(String store) {
@@ -128,9 +124,8 @@ public CreateSessionRequest store(String store) {
 
   /**
    * The unique identifier of the store that you want to process transactions for.
-   * @return store
+   * @return store The unique identifier of the store that you want to process transactions for.
    */
-  @ApiModelProperty(value = "The unique identifier of the store that you want to process transactions for.")
   @JsonProperty(JSON_PROPERTY_STORE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getStore() {
@@ -140,8 +135,8 @@ public String getStore() {
   /**
    * The unique identifier of the store that you want to process transactions for.
    *
-   * @param store
-   */ 
+   * @param store The unique identifier of the store that you want to process transactions for.
+   */
   @JsonProperty(JSON_PROPERTY_STORE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setStore(String store) {

src/main/java/com/adyen/model/posmobile/CreateSessionResponse.java

@@ -13,16 +13,14 @@
 package com.adyen.model.posmobile;
 
 import java.util.Objects;
-import java.util.Arrays;
 import java.util.Map;
 import java.util.HashMap;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.fasterxml.jackson.annotation.JsonCreator;
 import com.fasterxml.jackson.annotation.JsonTypeName;
 import com.fasterxml.jackson.annotation.JsonValue;
-import io.swagger.annotations.ApiModel;
-import io.swagger.annotations.ApiModelProperty;
+import java.util.Arrays;
 import com.fasterxml.jackson.annotation.JsonPropertyOrder;
 import com.fasterxml.jackson.core.JsonProcessingException;
 
@@ -60,7 +58,7 @@ public CreateSessionResponse() {
   /**
    * The unique identifier of the session.
    *
-   * @param id
+   * @param id The unique identifier of the session.
    * @return the current {@code CreateSessionResponse} instance, allowing for method chaining
    */
   public CreateSessionResponse id(String id) {
@@ -70,9 +68,8 @@ public CreateSessionResponse id(String id) {
 
   /**
    * The unique identifier of the session.
-   * @return id
+   * @return id The unique identifier of the session.
    */
-  @ApiModelProperty(value = "The unique identifier of the session.")
   @JsonProperty(JSON_PROPERTY_ID)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getId() {
@@ -82,8 +79,8 @@ public String getId() {
   /**
    * The unique identifier of the session.
    *
-   * @param id
-   */ 
+   * @param id The unique identifier of the session.
+   */
   @JsonProperty(JSON_PROPERTY_ID)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setId(String id) {
@@ -93,7 +90,7 @@ public void setId(String id) {
   /**
    * The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
    *
-   * @param installationId
+   * @param installationId The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
    * @return the current {@code CreateSessionResponse} instance, allowing for method chaining
    */
   public CreateSessionResponse installationId(String installationId) {
@@ -103,9 +100,8 @@ public CreateSessionResponse installationId(String installationId) {
 
   /**
    * The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
-   * @return installationId
+   * @return installationId The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
    */
-  @ApiModelProperty(value = "The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.")
   @JsonProperty(JSON_PROPERTY_INSTALLATION_ID)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getInstallationId() {
@@ -115,8 +111,8 @@ public String getInstallationId() {
   /**
    * The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
    *
-   * @param installationId
-   */ 
+   * @param installationId The unique identifier of the SDK installation. If you create the [Terminal API](https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/) transaction request on your backend, use this as the `POIID` in the `MessageHeader` of the request.
+   */
   @JsonProperty(JSON_PROPERTY_INSTALLATION_ID)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setInstallationId(String installationId) {
@@ -126,7 +122,7 @@ public void setInstallationId(String installationId) {
   /**
    * The unique identifier of your merchant account.
    *
-   * @param merchantAccount
+   * @param merchantAccount The unique identifier of your merchant account.
    * @return the current {@code CreateSessionResponse} instance, allowing for method chaining
    */
   public CreateSessionResponse merchantAccount(String merchantAccount) {
@@ -136,9 +132,8 @@ public CreateSessionResponse merchantAccount(String merchantAccount) {
 
   /**
    * The unique identifier of your merchant account.
-   * @return merchantAccount
+   * @return merchantAccount The unique identifier of your merchant account.
    */
-  @ApiModelProperty(value = "The unique identifier of your merchant account.")
   @JsonProperty(JSON_PROPERTY_MERCHANT_ACCOUNT)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getMerchantAccount() {
@@ -148,8 +143,8 @@ public String getMerchantAccount() {
   /**
    * The unique identifier of your merchant account.
    *
-   * @param merchantAccount
-   */ 
+   * @param merchantAccount The unique identifier of your merchant account.
+   */
   @JsonProperty(JSON_PROPERTY_MERCHANT_ACCOUNT)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setMerchantAccount(String merchantAccount) {
@@ -159,7 +154,7 @@ public void setMerchantAccount(String merchantAccount) {
   /**
    * The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
    *
-   * @param sdkData
+   * @param sdkData The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
    * @return the current {@code CreateSessionResponse} instance, allowing for method chaining
    */
   public CreateSessionResponse sdkData(String sdkData) {
@@ -169,9 +164,8 @@ public CreateSessionResponse sdkData(String sdkData) {
 
   /**
    * The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
-   * @return sdkData
+   * @return sdkData The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
    */
-  @ApiModelProperty(value = "The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.")
   @JsonProperty(JSON_PROPERTY_SDK_DATA)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getSdkData() {
@@ -181,8 +175,8 @@ public String getSdkData() {
   /**
    * The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
    *
-   * @param sdkData
-   */ 
+   * @param sdkData The data that the SDK uses to authenticate responses from the Adyen payments platform. Pass this value to your POS app.
+   */
   @JsonProperty(JSON_PROPERTY_SDK_DATA)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setSdkData(String sdkData) {
@@ -192,7 +186,7 @@ public void setSdkData(String sdkData) {
   /**
    * The unique identifier of the store that you want to process transactions for.
    *
-   * @param store
+   * @param store The unique identifier of the store that you want to process transactions for.
    * @return the current {@code CreateSessionResponse} instance, allowing for method chaining
    */
   public CreateSessionResponse store(String store) {
@@ -202,9 +196,8 @@ public CreateSessionResponse store(String store) {
 
   /**
    * The unique identifier of the store that you want to process transactions for.
-   * @return store
+   * @return store The unique identifier of the store that you want to process transactions for.
    */
-  @ApiModelProperty(value = "The unique identifier of the store that you want to process transactions for.")
   @JsonProperty(JSON_PROPERTY_STORE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public String getStore() {
@@ -214,8 +207,8 @@ public String getStore() {
   /**
    * The unique identifier of the store that you want to process transactions for.
    *
-   * @param store
-   */ 
+   * @param store The unique identifier of the store that you want to process transactions for.
+   */
   @JsonProperty(JSON_PROPERTY_STORE)
   @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
   public void setStore(String store) {

src/main/java/com/adyen/service/PosMobileApi.java

@@ -23,6 +23,13 @@
 import java.io.IOException;
 import java.util.HashMap;
 import java.util.Map;
+
+/**
+ * The service has been moved to a different package 'com.adyen.service.posmobile'
+ * @deprecated Use instead com.adyen.service.posmobile.PosMobileApi
+ *
+ */
+@Deprecated(since = "v37.0.0", forRemoval = true)
 public class PosMobileApi extends Service {
 
     public static final String API_VERSION = "68";
@@ -33,6 +40,7 @@ public class PosMobileApi extends Service {
     * Default constructor in {@link com.adyen.service package}.
     * @param client {@link Client }  (required)
     */
+    @Deprecated(since = "v37.0.0", forRemoval = true)
     public PosMobileApi(Client client) {
         super(client);
         this.baseURL = createBaseURL("https://checkout-test.adyen.com/checkout/possdk/v68");
@@ -44,6 +52,7 @@ public PosMobileApi(Client client) {
     * @param client {@link Client }  (required)
     * @param baseURL {@link String }  (required)
     */
+    @Deprecated(since = "v37.0.0", forRemoval = true)
     public PosMobileApi(Client client, String baseURL) {
         super(client);
         this.baseURL = baseURL;
@@ -56,6 +65,7 @@ public PosMobileApi(Client client, String baseURL) {
     * @return {@link CreateSessionResponse }
     * @throws ApiException if fails to make API call
     */
+    @Deprecated(since = "v37.0.0", forRemoval = true)
     public CreateSessionResponse createCommunicationSession(CreateSessionRequest createSessionRequest) throws ApiException, IOException {
         return createCommunicationSession(createSessionRequest, null);
     }
@@ -68,6 +78,7 @@ public CreateSessionResponse createCommunicationSession(CreateSessionRequest cre
     * @return {@link CreateSessionResponse }
     * @throws ApiException if fails to make API call
     */
+    @Deprecated(since = "v37.0.0", forRemoval = true)
     public CreateSessionResponse createCommunicationSession(CreateSessionRequest createSessionRequest, RequestOptions requestOptions) throws ApiException, IOException {
 
         String requestBody = createSessionRequest.toJson();