add missing javadoc

Author: AlexandrosMor

src/main/java/com/adyen/Client.java

@@ -70,7 +70,12 @@ public Client(String username, String password, Environment environment, String
     }
 
     /**
-     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
+     * @param username your merchant account Username
+     * @param password your merchant accont Password
+     * @param environment This defines the payment enviroment live or test
+     * @param connectionTimeoutMillis Provide the time to time out
+     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link
+     * com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
      */
     @Deprecated
     public Client(String username, String password, Environment environment, int connectionTimeoutMillis) {
@@ -80,7 +85,13 @@ public Client(String username, String password, Environment environment, int con
     }
 
     /**
-     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
+     * @param username your merchant account Username
+     * @param password your merchant accont Password
+     * @param environment This defines the payment enviroment live or test
+     * @param connectionTimeoutMillis Provide the time to time out
+     * @param liveEndpointUrlPrefix provide the merchant specific url
+     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link
+     * com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
      */
     @Deprecated
     public Client(String username, String password, Environment environment, int connectionTimeoutMillis, String liveEndpointUrlPrefix) {
@@ -100,7 +111,11 @@ public Client(String apiKey, Environment environment, String liveEndpointUrlPref
     }
 
     /**
-     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
+     * @param apiKey Defines the api key that can be retrieved by back office
+     * @param environment This defines the payment enviroment live or test
+     * @param connectionTimeoutMillis Provide the time to time out
+     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link
+     * com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
      */
     @Deprecated
     public Client(String apiKey, Environment environment, int connectionTimeoutMillis) {
@@ -110,7 +125,12 @@ public Client(String apiKey, Environment environment, int connectionTimeoutMilli
     }
 
     /**
-     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
+     * @param apiKey Defines the api key that can be retrieved by back office
+     * @param environment This defines the payment enviroment live or test
+     * @param connectionTimeoutMillis Provide the time to time out
+     * @param liveEndpointUrlPrefix provide the merchant specific url
+     * @deprecated As of library version 1.6.1, timeouts should be set by {@link #setTimeouts(int connectionTimeoutMillis, int readTimeoutMillis)} or directly by {@link
+     * com.adyen.Config#setConnectionTimeoutMillis(int connectionTimeoutMillis)}.
      */
     @Deprecated
     public Client(String apiKey, Environment environment, int connectionTimeoutMillis, String liveEndpointUrlPrefix) {
@@ -120,6 +140,7 @@ public Client(String apiKey, Environment environment, int connectionTimeoutMilli
     }
 
     /**
+     * @param environment This defines the payment enviroment live or test
      * @deprecated As of library version 1.5.4, replaced by {@link #setEnvironment(Environment environment, String liveEndpointUrlPrefix)}.
      */
     @Deprecated
@@ -128,7 +149,7 @@ public void setEnvironment(Environment environment) {
     }
 
     /**
-     * @param environment
+     * @param environment           This defines the payment enviroment live or test
      * @param liveEndpointUrlPrefix Provide the unique live url prefix from the "API URLs and Response" menu in the Adyen Customer Area
      */
     public void setEnvironment(Environment environment, String liveEndpointUrlPrefix) {

src/main/java/com/adyen/Util/Util.java

@@ -73,9 +73,9 @@ public static <T> String implode(String glue, List<T> list) {
     /**
      * Returns an Amount struct to use on requests
      *
-     * @param amount
-     * @param currency
-     * @return
+     * @param amount Defines the amount
+     * @param currency Defines the amount currency
+     * @return amount
      */
     public static Amount createAmount(String amount, String currency) {
         return createAmount(new BigDecimal(amount), currency);
@@ -84,9 +84,9 @@ public static Amount createAmount(String amount, String currency) {
     /**
      * Returns an Amount struct to use on requests
      *
-     * @param amount
-     * @param currency
-     * @return
+     * @param amount Defines the amount
+     * @param currency Defines the amount currency
+     * @return amount
      */
     public static Amount createAmount(BigDecimal amount, String currency) {
         Amount amountData = new Amount();
@@ -138,6 +138,8 @@ public static int getDecimalPlaces(String currency) {
     /**
      * Convert the given object to string with each line indented by 4 spaces
      * (except the first line).
+     * @param o string
+     * @return string target "\n" replacement with "\n    "
      */
     public static String toIndentedString(Object o) {
         if (o == null) {

src/main/java/com/adyen/model/AbstractPaymentRequest.java

@@ -169,6 +169,9 @@ public AbstractPaymentRequest() {
 
     /**
      * Set browser data
+     * @param userAgent http header
+     * @param acceptHeader http header
+     * @return browser data
      */
     public T setBrowserInfoData(String userAgent, String acceptHeader) {
         BrowserInfo browserInfo = new BrowserInfo();
@@ -182,7 +185,7 @@ public T setBrowserInfoData(String userAgent, String acceptHeader) {
     /**
      * get additionalData map Create the map if doesn't exists
      *
-     * @return
+     * @return additional data
      */
     public Map<String, String> getOrCreateAdditionalData() {
         if (this.getAdditionalData() == null) {

src/main/java/com/adyen/model/PaymentRequest.java

@@ -112,6 +112,12 @@ public PaymentRequest setCardData(String cardNumber, String cardHolder, String e
 
     /**
      * Set Data needed for payment request using secured fields
+     * @param encryptedCardNumber encrypted Card Number
+     * @param cardHolder card holder
+     * @param encryptedExpiryMonth encrypted expiry month
+     * @param encryptedExpiryYear encrypted expiry year
+     * @param encryptedSecurityCode encrypted security code
+     * @return payment request
      */
     public PaymentRequest setSecuredFieldsData(String encryptedCardNumber, String cardHolder, String encryptedExpiryMonth, String encryptedExpiryYear, String encryptedSecurityCode) {
         this.setCardHolder(cardHolder)
@@ -176,6 +182,8 @@ public void setThreeDS2RequestData(ThreeDS2RequestData threeDS2RequestData) {
 
     /**
      * Set invoiceLines in addtionalData
+     * @param invoiceLines Invoice lines
+     * @return payment request
      */
     public PaymentRequest setInvoiceLines(List<InvoiceLine> invoiceLines) {
         Integer count = 1;

src/main/java/com/adyen/model/checkout/PaymentsRequest.java

@@ -721,8 +721,12 @@ public PaymentsRequest addEncryptedCardData(String encryptedCardNumber, String e
 
     /**
      * Add raw card data into the payment request. You need to be PCI compliant!
-     *
-     * @return paymentMethod
+     * @param cardNumber card number
+     * @param expiryMonth expiry month
+     * @param expiryYear expiry year
+     * @param holderName holder name
+     * @param securityCode  security code
+     * @return paymentMethod payment method
      */
     public PaymentsRequest addCardData(String cardNumber, String expiryMonth, String expiryYear, String securityCode, String holderName) {
         DefaultPaymentMethodDetails paymentMethodDetails = new DefaultPaymentMethodDetails();

src/main/java/com/adyen/model/marketpay/AccountHolderBalanceResponse.java

@@ -122,7 +122,7 @@ public List<AccountDetailBalance> getBalancePerAccount() {
     /**
      * Creating a new balancePerAccount list
      *
-     * @param balancePerAccount
+     * @param balancePerAccount balance per account
      */
     public void setBalancePerAccount(List<AccountDetailBalance> balancePerAccount) {
 

src/main/java/com/adyen/model/marketpay/AccountHolderDetails.java

@@ -126,7 +126,7 @@ public void setPhoneNumber(PhoneNumber phoneNumber) {
     /**
      * Populate the virtual bankAccountDetails to bypass the bankAccountDetailsContainer list
      *
-     * @return
+     * @return bank account details
      */
     public List<BankAccountDetail> getBankAccountDetails() {
         if (bankAccountDetails == null) {
@@ -143,6 +143,7 @@ public List<BankAccountDetail> getBankAccountDetails() {
 
     /**
      * Creating a new bankAccountDetails list
+     * @param bankAccountDetails  bank account details
      */
     public void setBankAccountDetails(List<BankAccountDetail> bankAccountDetails) {
         this.bankAccountDetails = bankAccountDetails;
@@ -158,8 +159,8 @@ public void setBankAccountDetails(List<BankAccountDetail> bankAccountDetails) {
     /**
      * Add bankAccountDetail to the bankAccountDetailContainers and bankAccountDetails list
      *
-     * @param bankAccountDetail
-     * @return
+     * @param bankAccountDetail BankAccountDetail
+     * @return account holder details
      */
     public AccountHolderDetails addBankAccountDetail(BankAccountDetail bankAccountDetail) {
         BankAccountDetailContainer bankAccountDetailContainer = new BankAccountDetailContainer(bankAccountDetail);

src/main/java/com/adyen/model/marketpay/AccountHolderTransactionListResponse.java

@@ -90,8 +90,8 @@ public List<AccountTransactionList> getAccountTransactionLists() {
 
     /**
      * Creating a new accountTransactionLists list
-     *
-     * @param accountTransactionLists
+     * @param accountTransactionLists  AccountTransactionList
+
      */
     public void setAccountTransactionLists(List<AccountTransactionList> accountTransactionLists) {
 
@@ -107,6 +107,12 @@ public void setAccountTransactionLists(List<AccountTransactionList> accountTrans
 
     }
 
+    /**
+     * Creating a new AccountHolderTransactionList Response
+     *
+     * @param accountTransactionList accountTransactionList
+     * @return AccountHolderTransactionListResponse
+     */
     public AccountHolderTransactionListResponse addAccountTransactionList(AccountTransactionList accountTransactionList) {
         AccountTransactionListContainer accountTransactionListContainer = new AccountTransactionListContainer(accountTransactionList);
 

src/main/java/com/adyen/model/marketpay/AccountTransactionList.java

@@ -105,8 +105,7 @@ public List<Transaction> getTransactions() {
 
     /**
      * Creating a new transactions list
-     *
-     * @param transactions
+     * @param transactions transactions
      */
     public void setTransactions(List<Transaction> transactions) {
 

src/main/java/com/adyen/model/marketpay/BusinessDetails.java

@@ -69,7 +69,7 @@ public List<ShareholderContact> getShareholders() {
     /**
      * Creating a new shareholders list
      *
-     * @param shareholders
+     * @param shareholders shareholders
      */
     public void setShareholders(List<ShareholderContact> shareholders) {
         this.shareholders = shareholders;
@@ -86,8 +86,8 @@ public void setShareholders(List<ShareholderContact> shareholders) {
     /**
      * Add shareholderContact to the shareholderContactContainers and shareholders list
      *
-     * @param shareholderContact
-     * @return
+     * @param shareholderContact shareholderContact
+     * @return BusinessDetails
      */
     public BusinessDetails addShareholderContact(ShareholderContact shareholderContact) {
         ShareholderContactContainer shareholderContactContainer = new ShareholderContactContainer(shareholderContact);