Merge branch 'master' into remove-unused-dependency

Author: Ankit098

pom.xml

@@ -35,7 +35,7 @@
 	</distributionManagement>
 
 	<properties>
-		<jackson.version>2.13.4</jackson.version>
+		<jackson.version>2.14.2</jackson.version>
 		<junit.version>4.13.2</junit.version>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<maven.compiler.source>1.8</maven.compiler.source>
@@ -47,7 +47,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-compiler-plugin</artifactId>
-				<version>3.5.1</version>
+				<version>3.11.0</version>
 				<configuration>
 					<source>1.8</source>
 					<target>1.8</target>
@@ -69,7 +69,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>2.10.3</version>
+				<version>3.5.0</version>
 				<configuration>
 					<additionalparam>-Xdoclint:none</additionalparam>
 				</configuration>
@@ -116,7 +116,7 @@
 		<dependency>
 			<groupId>com.google.http-client</groupId>
 			<artifactId>google-http-client-apache-v2</artifactId>
-			<version>1.42.2</version>
+			<version>1.43.0</version>
 		</dependency>
 
 		<dependency>

src/main/java/com/browserstack/appautomate/AppAutomateClient.java

@@ -26,6 +26,11 @@ public class AppAutomateClient extends BrowserStackClient implements AppAutomate
 
   private static final String BASE_URL = "https://api-cloud.browserstack.com/app-automate";
 
+  /**
+   *
+   * @param username Browserstack username
+   * @param accessKey Browserstack accessKey
+   */
   public AppAutomateClient(String username, String accessKey) {
     super(System.getProperty("browserstack.app-automate.api", BASE_URL), username, accessKey);
   }
@@ -35,8 +40,8 @@ public AppAutomateClient(String username, String accessKey) {
    *
    * @param sessionId ID that uniquely identifies a session.
    * @return {@link Session} objects containing test session information.
-   * @throws SessionNotFound
-   * @throws AppAutomateException
+   * @throws SessionNotFound session not found error
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public Session getSession(String sessionId) throws SessionNotFound, AppAutomateException {
@@ -52,9 +57,9 @@ public Session getSession(String sessionId) throws SessionNotFound, AppAutomateE
    *
    * @param filePath absolute path of app to be uploaded.
    * @return AppUploadResponse object containing app upload response details.
-   * @throws AppAutomateException
-   * @throws FileNotFoundException
-   * @throws InvalidFileExtensionException
+   * @throws AppAutomateException exception for AppAutomate sessions.
+   * @throws FileNotFoundException file not found at given path
+   * @throws InvalidFileExtensionException unsupported file extension for app
    */
   @Override
   public AppUploadResponse uploadApp(String filePath)
@@ -104,7 +109,7 @@ public AppUploadResponse uploadApp(String filePath)
    * @param status Return only builds that match the specified build status.
    * @param limit Limit results to the specified count.
    * @return List of {@link Build} objects.
-   * @throws AppAutomateException
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Build> getBuilds(final BuildStatus status, final int limit)
@@ -124,7 +129,7 @@ public List<Build> getBuilds(final BuildStatus status, final int limit)
    * </p>
    *
    * @return List of {@link Build} objects.
-   * @throws AppAutomateException
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Build> getBuilds() throws AppAutomateException {
@@ -140,7 +145,7 @@ public List<Build> getBuilds() throws AppAutomateException {
    *
    * @param limit Limit results to the specified count.
    * @return List of {@link Build} objects.
-   * @throws AppAutomateException
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Build> getBuilds(final int limit) throws AppAutomateException {
@@ -156,7 +161,7 @@ public List<Build> getBuilds(final int limit) throws AppAutomateException {
    *
    * @param status Include only builds that match the specified build status.
    * @return List of {@link Build} objects.
-   * @throws AppAutomateException
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Build> getBuilds(final BuildStatus status) throws AppAutomateException {
@@ -168,8 +173,8 @@ public List<Build> getBuilds(final BuildStatus status) throws AppAutomateExcepti
    *
    * @param buildId ID that uniquely identifies a build.
    * @return List of {@link Build} objects.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public Build getBuild(final String buildId) throws BuildNotFound, AppAutomateException {
@@ -185,8 +190,8 @@ public Build getBuild(final String buildId) throws BuildNotFound, AppAutomateExc
    *
    * @param buildName - Name of the build to search with
    * @return {@link Build} object.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public final Build getBuildByName(@Nonnull final String buildName) throws BuildNotFound, AppAutomateException {
@@ -202,7 +207,7 @@ public final Build getBuildByName(@Nonnull final String buildName) throws BuildN
    *
    * @param buildId ID that uniquely identifies a build.
    * @return true or false based on successful deletion of the build.
-   * @throws AppAutomateException
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public boolean deleteBuild(final String buildId) throws AppAutomateException {
@@ -220,8 +225,8 @@ public boolean deleteBuild(final String buildId) throws AppAutomateException {
    * @param status Include only builds that match the specified build status.
    * @param limit Limit results to the specified count.
    * @return List of {@link Session} objects containing test session information.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Session> getSessions(final String buildId, final BuildStatus status, final int limit)
@@ -238,8 +243,8 @@ public List<Session> getSessions(final String buildId, final BuildStatus status,
    *
    * @param buildId ID that uniquely identifies a build.
    * @return List of {@link Session} objects containing test session information.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Session> getSessions(final String buildId)
@@ -253,8 +258,8 @@ public List<Session> getSessions(final String buildId)
    * @param buildId ID that uniquely identifies a build.
    * @param limit Limit results to the specified count.
    * @return List of {@link Session} objects containing test session information.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Session> getSessions(final String buildId, final int limit)
@@ -268,8 +273,8 @@ public List<Session> getSessions(final String buildId, final int limit)
    * @param buildId ID that uniquely identifies a build.
    * @param status Include only builds that match the specified build status.
    * @return List of {@link Session} objects containing test session information.
-   * @throws BuildNotFound
-   * @throws AppAutomateException
+   * @throws BuildNotFound could not find build with given id
+   * @throws AppAutomateException exception for AppAutomate sessions.
    */
   @Override
   public List<Session> getSessions(final String buildId, final BuildStatus status)