APP-2813/APP-2812 - BDK2.0 modules setup

pom.xml

@@ -13,11 +13,25 @@
 
     <modules>
         <module>symphony-bdk-legacy</module>
+        <!-- other modules are activated using profile "-P2.0" -->
     </modules>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+
+        <!-- Alphabetical order -->
+        <commons-io.version>2.6</commons-io.version>
+        <commons-lang3.version>3.9</commons-lang3.version>
+        <lombok.version>1.18.12</lombok.version>
+        <slf4j.version>1.7.30</slf4j.version>
+
+        <!-- Test dependencies -->
+        <junit.version>RELEASE</junit.version>
+        <logback.version>1.2.3</logback.version>
+        <mockito.version>2.23.4</mockito.version>
+        <mockserver.version>5.9.0</mockserver.version>
+
     </properties>
 
     <licenses>
@@ -42,6 +56,63 @@
         <url>https://github.com/SymphonyPlatformSolutions/symphony-api-client-java</url>
     </scm>
 
+    <dependencyManagement>
+        <dependencies>
+            <!-- Lombok -->
+            <dependency>
+                <groupId>org.projectlombok</groupId>
+                <artifactId>lombok</artifactId>
+                <version>${lombok.version}</version>
+            </dependency>
+
+            <!-- Apache commons -->
+            <dependency>
+                <groupId>commons-io</groupId>
+                <artifactId>commons-io</artifactId>
+                <version>${commons-io.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.apache.commons</groupId>
+                <artifactId>commons-lang3</artifactId>
+                <version>${commons-lang3.version}</version>
+            </dependency>
+
+            <!-- Logging -->
+            <dependency>
+                <groupId>org.slf4j</groupId>
+                <artifactId>slf4j-api</artifactId>
+                <version>${slf4j.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>ch.qos.logback</groupId>
+                <artifactId>logback-classic</artifactId>
+                <version>${logback.version}</version>
+                <scope>runtime</scope>
+            </dependency>
+
+            <!-- Testing -->
+            <dependency>
+                <groupId>org.junit.jupiter</groupId>
+                <artifactId>junit-jupiter</artifactId>
+                <version>${junit.version}</version>
+                <scope>test</scope>
+            </dependency>
+            <dependency>
+                <groupId>org.mockito</groupId>
+                <artifactId>mockito-core</artifactId>
+                <version>${mockito.version}</version>
+                <scope>test</scope>
+            </dependency>
+            <dependency>
+                <groupId>org.mock-server</groupId>
+                <artifactId>mockserver-netty</artifactId>
+                <version>${mockserver.version}</version>
+                <scope>test</scope>
+            </dependency>
+
+        </dependencies>
+    </dependencyManagement>
+
     <build>
         <pluginManagement>
             <plugins>
@@ -163,6 +234,18 @@
                 </plugins>
             </build>
         </profile>
+
+        <profile>
+            <id>2.0</id>
+            <activation>
+                <activeByDefault>false</activeByDefault>
+            </activation>
+            <modules>
+                <module>symphony-bdk-core</module>
+                <module>symphony-bdk-examples</module>
+                <module>symphony-bdk-core-invokers</module>
+            </modules>
+        </profile>
     </profiles>
 
     <distributionManagement>

symphony-bdk-core-invokers/pom.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <artifactId>symphony-api-client-java-parent</artifactId>
+        <groupId>com.symphony.platformsolutions</groupId>
+        <version>1.2.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>symphony-bdk-core-invokers</artifactId>
+    <name>Symphony Java BDK Core Invokers</name>
+    <description>Symphony Java BDK Core Invokers Module</description>
+    <packaging>pom</packaging>
+
+    <modules>
+        <module>symphony-bdk-core-invoker-api</module>
+        <module>symphony-bdk-core-invoker-jersey2</module>
+    </modules>
+
+</project>

symphony-bdk-core-invokers/symphony-bdk-core-invoker-api/pom.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <artifactId>symphony-bdk-core-invokers</artifactId>
+        <groupId>com.symphony.platformsolutions</groupId>
+        <version>1.2.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>symphony-bdk-core-invoker-api</artifactId>
+    <name>Symphony Java BDK Core Invoker API</name>
+    <description>Symphony Java BDK Core Invoker API Module</description>
+
+    <properties>
+        <jersey.version>2.29.1</jersey.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.glassfish.jersey.core</groupId>
+            <artifactId>jersey-client</artifactId>
+            <version>${jersey.version}</version>
+        </dependency>
+    </dependencies>
+
+
+</project>

symphony-bdk-core-invokers/symphony-bdk-core-invoker-api/src/main/java/com/symphony/bdk/core/api/invoker/ApiClient.java

@@ -0,0 +1,159 @@
+package com.symphony.bdk.core.api.invoker;
+
+import java.util.List;
+import java.util.Map;
+
+import javax.ws.rs.core.GenericType;
+
+/**
+ * Interface used to perform HTTP requests performed by the generated Swagger code.
+ */
+public interface ApiClient {
+
+  /**
+   * Invoke API by sending HTTP request with the given options.
+   *
+   * @param <T> Type
+   * @param path The sub-path of the HTTP URL
+   * @param method The request method, one of "GET", "POST", "PUT", "HEAD" and "DELETE"
+   * @param queryParams The query parameters
+   * @param body The request body object
+   * @param headerParams The header parameters
+   * @param cookieParams The cookie parameters
+   * @param formParams The form parameters
+   * @param accept The request's Accept header
+   * @param contentType The request's Content-Type header
+   * @param authNames The authentications to apply
+   * @param returnType The return type into which to deserialize the response
+   * @return The response body in type of string
+   * @throws ApiException API exception
+   */
+  <T> ApiResponse<T> invokeAPI(
+      String path,
+      String method,
+      List<Pair> queryParams,
+      Object body,
+      Map<String, String> headerParams,
+      Map<String, String> cookieParams,
+      Map<String, Object> formParams,
+      String accept,
+      String contentType,
+      String[] authNames,
+      GenericType<T> returnType
+  ) throws ApiException;
+
+  /**
+   * Returns the API base path
+   * @return API base path
+   */
+  String getBasePath();
+
+  /**
+   * Set the API base path
+   * @param basePath Base path
+   * @return API client
+   */
+  ApiClient setBasePath(String basePath);
+
+  /**
+   * Set the User-Agent header's value (by adding to the default header map).
+   * @param userAgent Http user agent
+   * @return API client
+   */
+  ApiClient setUserAgent(String userAgent);
+
+  /**
+   * Add a default header.
+   * @param key The header's key
+   * @param value The header's value
+   * @return API client
+   */
+  ApiClient addDefaultHeader(String key, String value);
+
+  /**
+   * The path of temporary folder used to store downloaded files from endpoints
+   * with file response. The default value is <code>null</code>, i.e. using
+   * the system's default tempopary folder.
+   * @return Temp folder path
+   */
+  String getTempFolderPath();
+
+  /**
+   * Set temp folder path
+   * @param tempFolderPath Temp folder path
+   * @return API client
+   */
+  ApiClient setTempFolderPath(String tempFolderPath);
+
+  /**
+   * Connect timeout (in milliseconds).
+   * @return Connection timeout
+   */
+  int getConnectTimeout();
+
+  /**
+   * Set the connect timeout (in milliseconds).
+   * A value of 0 means no timeout, otherwise values must be between 1 and {@link Integer#MAX_VALUE}.
+   * @param connectionTimeout Connection timeout in milliseconds
+   * @return API client
+   */
+  ApiClient setConnectTimeout(int connectionTimeout);
+
+  /**
+   * read timeout (in milliseconds).
+   * @return Read timeout
+   */
+  int getReadTimeout();
+
+  /**
+   * Set the read timeout (in milliseconds).
+   * A value of 0 means no timeout, otherwise values must be between 1 and
+   * {@link Integer#MAX_VALUE}.
+   * @param readTimeout Read timeout in milliseconds
+   * @return API client
+   */
+  ApiClient setReadTimeout(int readTimeout);
+
+  /**
+   * Format the given parameter object into string.
+   * @param param Object
+   * @return Object in string format
+   */
+  String parameterToString(Object param);
+
+  /**
+   * Format to {@code Pair} objects.
+   * @param collectionFormat Collection format
+   * @param name Name
+   * @param value Value
+   * @return List of pairs
+   */
+  List<Pair> parameterToPairs(String collectionFormat, String name, Object value);
+
+  /**
+   * Select the Accept header's value from the given accepts array:
+   * if JSON exists in the given array, use it;
+   * otherwise use all of them (joining into a string)
+   * @param accepts The accepts array to select from
+   * @return The Accept header to use. If the given array is empty,
+   * null will be returned (not to set the Accept header explicitly).
+   */
+  String selectHeaderAccept(String[] accepts);
+
+  /**
+   * Select the Content-Type header's value from the given array:
+   * if JSON exists in the given array, use it;
+   * otherwise use the first one of the array.
+   * @param contentTypes The Content-Type array to select from
+   * @return The Content-Type header to use. If the given array is empty,
+   * JSON will be used.
+   */
+  String selectHeaderContentType(String[] contentTypes);
+
+  /**
+   * Escape the given string to be used as URL query value.
+   * @param str String
+   * @return Escaped string
+   */
+  String escapeString(String str);
+}