add better codestyle javadoc validation than we have now

Author: therepanic

build.gradle

@@ -6,6 +6,22 @@ ext {
 }
 
 allprojects {
+    apply plugin: 'java'
+    apply plugin: 'checkstyle'
+
+    checkstyle {
+        configFile = file("$rootProject.projectDir/src/checkstyle/checkstyle.xml")
+        ignoreFailures = false
+    }
+
+    checkstyleMain {
+        source = 'src/main/java'
+    }
+
+    checkstyleTest {
+        source = 'src/test/java'
+    }
+
     repositories {
         mavenCentral()
     }

client/src/main/java/ru/funpay4j/client/client/FunPayClient.java

@@ -54,13 +54,13 @@ public interface FunPayClient {
      *
      * @param goldenKey golden key which will be used to authorize the user
      * @param csrfToken csrf token which is required to interact with the user in this operation
-     * @param PHPSESSID user session without which the csrf token will be useless
+     * @param phpSessionId user session without which the csrf token will be useless
      * @param request request storing all necessary data for saving offer
      * @throws FunPayApiException if the other api-related exception
      * @throws InvalidGoldenKeyException if the golden key is invalid
      * @throws InvalidCsrfTokenOrPHPSESSIDException if the csrf token or PHPSESSID is invalid
      */
-    void saveOffer(String goldenKey, String csrfToken, String PHPSESSID, SaveOfferRequest request) throws FunPayApiException,
+    void saveOffer(String goldenKey, String csrfToken, String phpSessionId , SaveOfferRequest request) throws FunPayApiException,
             InvalidGoldenKeyException, InvalidCsrfTokenOrPHPSESSIDException;
 
     /**

client/src/main/java/ru/funpay4j/client/client/OkHttpFunPayClient.java

@@ -17,7 +17,11 @@
 import com.google.gson.JsonObject;
 import com.google.gson.JsonParser;
 import lombok.NonNull;
-import okhttp3.*;
+import okhttp3.OkHttpClient;
+import okhttp3.Response;
+import okhttp3.Request;
+import okhttp3.RequestBody;
+import okhttp3.MultipartBody;
 import ru.funpay4j.client.request.SaveOfferRequest;
 import ru.funpay4j.client.exceptions.FunPayApiException;
 import ru.funpay4j.client.exceptions.InvalidCsrfTokenOrPHPSESSIDException;
@@ -108,7 +112,7 @@ public void raiseAllOffers(@NonNull String goldenKey, long gameId, long lotId) t
      */
     @Override
     public void saveOffer(@NonNull String goldenKey, @NonNull String csrfToken,
-                          @NonNull String PHPSESSID, @NonNull SaveOfferRequest request) throws FunPayApiException, InvalidGoldenKeyException{
+                          @NonNull String phpSessionId, @NonNull SaveOfferRequest request) throws FunPayApiException, InvalidGoldenKeyException{
         MultipartBody.Builder multipartBody = new MultipartBody.Builder()
                 .setType(MultipartBody.FORM)
                 .addFormDataPart("csrf_token", csrfToken)
@@ -138,7 +142,7 @@ public void saveOffer(@NonNull String goldenKey, @NonNull String csrfToken,
         }
 
         try (Response response = httpClient.newCall(new Request.Builder().post(multipartBody.build()).url(baseURL + "/lots/offerSave")
-                .addHeader("Cookie", "golden_key=" + goldenKey + "; PHPSESSID=" + PHPSESSID)
+                .addHeader("Cookie", "golden_key=" + goldenKey + "; PHPSESSID=" + phpSessionId)
                 .addHeader("x-requested-with", "XMLHttpRequest")
                 .build()).execute()) {
             String responseBodyString = response.body().string();

client/src/main/java/ru/funpay4j/client/objects/user/ParsedAdvancedSellerReview.java

@@ -14,7 +14,11 @@
 
 package ru.funpay4j.client.objects.user;
 
-import lombok.*;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.EqualsAndHashCode;
+import lombok.AllArgsConstructor;
+import lombok.ToString;
 import lombok.experimental.SuperBuilder;
 
 import java.util.Date;

client/src/main/java/ru/funpay4j/client/objects/user/ParsedPreviewSeller.java

@@ -14,7 +14,11 @@
 
 package ru.funpay4j.client.objects.user;
 
-import lombok.*;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.EqualsAndHashCode;
+import lombok.AllArgsConstructor;
+import lombok.ToString;
 import lombok.experimental.SuperBuilder;
 
 /**

client/src/main/java/ru/funpay4j/client/objects/user/ParsedSeller.java

@@ -14,7 +14,11 @@
 
 package ru.funpay4j.client.objects.user;
 
-import lombok.*;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.EqualsAndHashCode;
+import lombok.AllArgsConstructor;
+import lombok.ToString;
 import lombok.experimental.SuperBuilder;
 import ru.funpay4j.client.objects.offer.ParsedPreviewOffer;
 

client/src/main/java/ru/funpay4j/client/parser/JsoupFunPayParser.java

@@ -16,7 +16,11 @@
 
 import com.google.gson.JsonParser;
 import lombok.NonNull;
-import okhttp3.*;
+import okhttp3.OkHttpClient;
+import okhttp3.Response;
+import okhttp3.Request;
+import okhttp3.RequestBody;
+import okhttp3.MultipartBody;
 import org.jsoup.Jsoup;
 import org.jsoup.nodes.Document;
 import org.jsoup.nodes.Element;
@@ -26,7 +30,11 @@
 import ru.funpay4j.client.objects.lot.ParsedLotCounter;
 import ru.funpay4j.client.objects.offer.ParsedOffer;
 import ru.funpay4j.client.objects.offer.ParsedPreviewOffer;
-import ru.funpay4j.client.objects.user.*;
+import ru.funpay4j.client.objects.user.ParsedPreviewSeller;
+import ru.funpay4j.client.objects.user.ParsedSeller;
+import ru.funpay4j.client.objects.user.ParsedSellerReview;
+import ru.funpay4j.client.objects.user.ParsedUser;
+import ru.funpay4j.client.objects.user.ParsedAdvancedSellerReview;
 import ru.funpay4j.utils.FunPayUserUtil;
 import ru.funpay4j.client.exceptions.FunPayApiException;
 import ru.funpay4j.client.exceptions.offer.OfferNotFoundException;
@@ -36,7 +44,12 @@
 
 import java.io.IOException;
 import java.text.ParseException;
-import java.util.*;
+import java.util.List;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.Map;
+import java.util.HashMap;
+import java.util.Optional;
 
 /**
  * This implementation of FunPayParser uses Jsoup to parse
@@ -402,12 +415,12 @@ public CsrfTokenAndPHPSESSID parseCsrfTokenAndPHPSESSID(@NonNull String goldenKe
             String dataAppData = funPayDocument.getElementsByTag("body").attr("data-app-data");
 
             String csrfToken = JsonParser.parseString(dataAppData).getAsJsonObject().get("csrf-token").getAsString();
-            //Use this regex to get the value of the PHPSESSID key from the Set-Cookie header
-            String PHPSESSID = funPayHtmlResponse.header("Set-Cookie").replaceAll(".*PHPSESSID=([^;]*).*", "$1");
+            //Use this regex to get the value of the PHP_SESSION_ID key from the Set-Cookie header
+            String phpSessionId = funPayHtmlResponse.header("Set-Cookie").replaceAll(".*PHPSESSID=([^;]*).*", "$1");
 
             return CsrfTokenAndPHPSESSID.builder()
                     .csrfToken(csrfToken)
-                    .PHPSESSID(PHPSESSID)
+                    .PHPSESSID(phpSessionId)
                     .build();
         } catch (IOException e) {
             throw new FunPayApiException(e.getLocalizedMessage());

core/src/main/java/ru/funpay4j/core/AuthorizedFunPayExecutor.java

@@ -21,7 +21,11 @@
 import ru.funpay4j.client.objects.user.ParsedSellerReview;
 import ru.funpay4j.client.objects.user.ParsedUser;
 import ru.funpay4j.client.request.SaveOfferRequest;
-import ru.funpay4j.core.commands.offer.*;
+import ru.funpay4j.core.commands.offer.EditOffer;
+import ru.funpay4j.core.commands.offer.CreateOffer;
+import ru.funpay4j.core.commands.offer.DeleteOffer;
+import ru.funpay4j.core.commands.offer.CreateOfferImage;
+import ru.funpay4j.core.commands.offer.RaiseAllOffers;
 import ru.funpay4j.core.commands.user.GetSellerReviews;
 import ru.funpay4j.core.commands.user.GetUser;
 import ru.funpay4j.core.commands.user.UpdateAvatar;

core/src/main/java/ru/funpay4j/core/FunPayExecutor.java

@@ -22,7 +22,11 @@
 import ru.funpay4j.client.objects.game.ParsedPromoGame;
 import ru.funpay4j.client.objects.lot.ParsedLot;
 import ru.funpay4j.client.objects.offer.ParsedOffer;
-import ru.funpay4j.client.objects.user.*;
+import ru.funpay4j.client.objects.user.ParsedAdvancedSellerReview;
+import ru.funpay4j.client.objects.user.ParsedSellerReview;
+import ru.funpay4j.client.objects.user.ParsedUser;
+import ru.funpay4j.client.objects.user.ParsedPreviewSeller;
+import ru.funpay4j.client.objects.user.ParsedSeller;
 import ru.funpay4j.client.client.OkHttpFunPayClient;
 import ru.funpay4j.core.commands.offer.GetOffer;
 import ru.funpay4j.core.commands.game.GetPromoGames;
@@ -39,8 +43,11 @@
 import ru.funpay4j.core.objects.lot.LotCounter;
 import ru.funpay4j.core.objects.offer.Offer;
 import ru.funpay4j.core.objects.offer.PreviewOffer;
-import ru.funpay4j.core.objects.user.*;
-
+import ru.funpay4j.core.objects.user.AdvancedSellerReview;
+import ru.funpay4j.core.objects.user.SellerReview;
+import ru.funpay4j.core.objects.user.User;
+import ru.funpay4j.core.objects.user.Seller;
+import ru.funpay4j.core.objects.user.PreviewSeller;
 import java.net.Proxy;
 import java.util.List;
 import java.util.stream.Collectors;

core/src/main/java/ru/funpay4j/core/commands/game/GetPromoGames.java

@@ -14,7 +14,11 @@
 
 package ru.funpay4j.core.commands.game;
 
-import lombok.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.NonNull;
 
 /**
  * Use this command to get promo games