Add back legacy SDK and update gradle file to publish to central (#146)

Author: Barry-Zou

legacy-sdk/build.gradle

@@ -0,0 +1,75 @@
+plugins {
+    id 'java-library'
+    id 'com.diffplug.spotless' version '6.11.0'
+    id 'com.vanniktech.maven.publish' version '0.27.0'
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation 'io.apimatic:core-interfaces:0.3.1'
+    implementation 'io.apimatic:core:0.6.6'
+    implementation 'io.apimatic:okhttp-client-adapter:0.3.1'
+
+    testImplementation 'junit:junit:4.13.2'
+    testImplementation 'org.junit.vintage:junit-vintage-engine:4.12.3'
+}
+
+sourceCompatibility = 1.8
+targetCompatibility = 1.8
+
+spotless {
+    java {
+        palantirJavaFormat()
+    }
+}
+
+group = 'com.squareup'
+version = rootProject.version
+
+test {
+    useJUnitPlatform()
+}
+
+mavenPublishing {
+    publishToMavenCentral()
+    signAllPublications()
+    
+    coordinates("com.squareup", "square-legacy", "$version")
+
+    pom {
+        name = "Square Legacy Java SDK"
+        description = "Official Square Legacy Java SDK"
+        inceptionYear = "2019"
+        url = "https://github.com/square/square-java-sdk"
+        
+        licenses {
+            license {
+                name = "MIT License"
+                url = "https://opensource.org/licenses/MIT"
+                distribution = "repo"
+            }
+        }
+        
+        developers {
+            developer {
+                id = "square"
+                name = "Square"
+                url = "https://github.com/square"
+            }
+        }
+        
+        scm {
+            url = "https://github.com/square/square-java-sdk"
+            connection = "scm:git:git://github.com/square/square-java-sdk.git"
+            developerConnection = "scm:git:ssh://[email protected]/square/square-java-sdk.git"
+        }
+    }
+}
+
+java {
+    withSourcesJar()
+    withJavadocJar()
+}

legacy-sdk/src/main/java/com/squareup/square/legacy/ApiHelper.java

@@ -0,0 +1,8 @@
+package com.squareup.square.legacy;
+
+import io.apimatic.core.utilities.CoreHelper;
+
+/**
+ * This is a Helper class with commonly used utilities for the SDK.
+ */
+public class ApiHelper extends CoreHelper {}

legacy-sdk/src/main/java/com/squareup/square/legacy/BearerAuthCredentials.java

@@ -0,0 +1,20 @@
+package com.squareup.square.legacy;
+
+/**
+ * Interface to access authentication credentials.
+ */
+public interface BearerAuthCredentials {
+
+    /**
+     * String value for accessToken.
+     * @return accessToken
+     */
+    String getAccessToken();
+
+    /**
+     * Checks if provided credentials matched with existing ones.
+     * @param accessToken String value for credentials.
+     * @return true if credentials matched.
+     */
+    boolean equals(String accessToken);
+}

legacy-sdk/src/main/java/com/squareup/square/legacy/CompatibilityFactoryImpl.java

@@ -0,0 +1,90 @@
+package com.squareup.square.legacy;
+
+import com.squareup.square.legacy.http.Headers;
+import com.squareup.square.legacy.http.client.HttpContext;
+import com.squareup.square.legacy.http.request.HttpBodyRequest;
+import com.squareup.square.legacy.http.request.HttpMethod;
+import com.squareup.square.legacy.http.request.HttpRequest;
+import com.squareup.square.legacy.http.response.HttpResponse;
+import com.squareup.square.legacy.http.response.HttpStringResponse;
+import io.apimatic.coreinterfaces.compatibility.CompatibilityFactory;
+import io.apimatic.coreinterfaces.http.Context;
+import io.apimatic.coreinterfaces.http.HttpHeaders;
+import io.apimatic.coreinterfaces.http.Method;
+import io.apimatic.coreinterfaces.http.request.Request;
+import io.apimatic.coreinterfaces.http.response.ApiResponseType;
+import io.apimatic.coreinterfaces.http.response.DynamicType;
+import io.apimatic.coreinterfaces.http.response.Response;
+import java.io.InputStream;
+import java.util.AbstractMap.SimpleEntry;
+import java.util.List;
+import java.util.Map;
+
+public class CompatibilityFactoryImpl implements CompatibilityFactory {
+
+    @Override
+    public Context createHttpContext(Request request, Response response) {
+        return new HttpContext((HttpRequest) request, (HttpResponse) response);
+    }
+
+    @Override
+    public Request createHttpRequest(
+            Method httpMethod,
+            StringBuilder queryUrlBuilder,
+            HttpHeaders headers,
+            Map<String, Object> queryParameters,
+            List<SimpleEntry<String, Object>> formParameters) {
+        return new HttpRequest(
+                HttpMethod.valueOf(httpMethod.toString()),
+                queryUrlBuilder,
+                (Headers) headers,
+                queryParameters,
+                formParameters);
+    }
+
+    @Override
+    public Request createHttpRequest(
+            Method httpMethod,
+            StringBuilder queryUrlBuilder,
+            HttpHeaders headers,
+            Map<String, Object> queryParameters,
+            Object body) {
+        return new HttpBodyRequest(
+                HttpMethod.valueOf(httpMethod.toString()), queryUrlBuilder, (Headers) headers, queryParameters, body);
+    }
+
+    @Override
+    public Response createHttpResponse(int code, HttpHeaders headers, InputStream rawBody) {
+        return new HttpResponse(code, (Headers) headers, rawBody);
+    }
+
+    @Override
+    public Response createHttpResponse(int code, HttpHeaders headers, InputStream rawBody, String body) {
+        return new HttpStringResponse(code, (Headers) headers, rawBody, body);
+    }
+
+    @Override
+    public HttpHeaders createHttpHeaders(Map<String, List<String>> headers) {
+        return new Headers(headers);
+    }
+
+    @Override
+    public HttpHeaders createHttpHeaders(HttpHeaders headers) {
+        return new Headers((Headers) headers);
+    }
+
+    @Override
+    public HttpHeaders createHttpHeaders() {
+        return new Headers();
+    }
+
+    @Override
+    public DynamicType createDynamicResponse(Response httpResponse) {
+        return null;
+    }
+
+    @Override
+    public <T> ApiResponseType<T> createApiResponse(int statusCode, HttpHeaders headers, T result) {
+        return null;
+    }
+}

legacy-sdk/src/main/java/com/squareup/square/legacy/Configuration.java

@@ -0,0 +1,84 @@
+package com.squareup.square.legacy;
+
+import com.squareup.square.legacy.authentication.BearerAuthModel;
+import com.squareup.square.legacy.http.Headers;
+import com.squareup.square.legacy.http.client.ReadonlyHttpClientConfiguration;
+
+/**
+ * Configuration Interface for the library.
+ */
+public interface Configuration {
+
+    /**
+     * Current API environment.
+     * @return a copy of environment
+     */
+    Environment getEnvironment();
+
+    /**
+     * Sets the base URL requests are made to. Defaults to `https://connect.squareup.com`
+     * @return a copy of customUrl
+     */
+    String getCustomUrl();
+
+    /**
+     * Square Connect API versions.
+     * @return a copy of squareVersion
+     */
+    String getSquareVersion();
+
+    /**
+     * Http Client Configuration instance.
+     * @return a copy of httpClientConfig
+     */
+    ReadonlyHttpClientConfiguration getHttpClientConfig();
+
+    /**
+     * Additional headers to add to each API request.
+     * @return a copy of additionalHeaders
+     */
+    Headers getAdditionalHeaders();
+
+    /**
+     * Additional detail which can be appended with User-Agent header.
+     * @return a copy of userAgentDetail
+     */
+    String getUserAgentDetail();
+
+    /**
+     * The timeout to use for making HTTP requests. The timeout to use for making HTTP requests.
+     * @return a copy of timeout
+     */
+    long timeout();
+
+    /**
+     * OAuth 2.0 Access Token.
+     * @return accessToken
+     */
+    String getAccessToken();
+
+    /**
+     * The credentials to use with BearerAuth.
+     * @return bearerAuthCredentials
+     */
+    BearerAuthCredentials getBearerAuthCredentials();
+
+    /**
+     * The auth credential model for BearerAuth.
+     * @return the instance of BearerAuthModel
+     */
+    BearerAuthModel getBearerAuthModel();
+
+    /**
+     * Get base URI by current environment.
+     * @param server Server for which to get the base URI
+     * @return Processed base URI
+     */
+    String getBaseUri(Server server);
+
+    /**
+     * Get base URI by current environment.
+     * @return Processed base URI
+     */
+    String getBaseUri();
+}

legacy-sdk/src/main/java/com/squareup/square/legacy/Environment.java

@@ -0,0 +1,89 @@
+package com.squareup.square.legacy;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.TreeMap;
+
+/**
+ * Environment to be used.
+ */
+public enum Environment {
+    PRODUCTION,
+
+    SANDBOX,
+
+    CUSTOM;
+
+    private static TreeMap<String, Environment> valueMap = new TreeMap<>();
+    private String value;
+
+    static {
+        PRODUCTION.value = "production";
+        SANDBOX.value = "sandbox";
+        CUSTOM.value = "custom";
+
+        valueMap.put("production", PRODUCTION);
+        valueMap.put("sandbox", SANDBOX);
+        valueMap.put("custom", CUSTOM);
+    }
+
+    /**
+     * Returns the enum member associated with the given string value.
+     * @param toConvert String value to get enum member.
+     * @return The enum member against the given string value.
+     * @throws IOException when provided value is not mapped to any enum member.
+     */
+    @JsonCreator
+    public static Environment constructFromString(String toConvert) throws IOException {
+        Environment enumValue = fromString(toConvert);
+        if (enumValue == null) {
+            throw new IOException("Unable to create enum instance with value: " + toConvert);
+        }
+        return enumValue;
+    }
+
+    /**
+     * Returns the enum member associated with the given string value.
+     * @param toConvert String value to get enum member.
+     * @return The enum member against the given string value.
+     */
+    public static Environment fromString(String toConvert) {
+        return valueMap.get(toConvert);
+    }
+
+    /**
+     * Returns the string value associated with the enum member.
+     * @return The string value against enum member.
+     */
+    @JsonValue
+    public String value() {
+        return value;
+    }
+
+    /**
+     * Get string representation of this enum.
+     */
+    @Override
+    public String toString() {
+        return value.toString();
+    }
+
+    /**
+     * Convert list of Environment values to list of string values.
+     * @param toConvert The list of Environment values to convert.
+     * @return List of representative string values.
+     */
+    public static List<String> toValue(List<Environment> toConvert) {
+        if (toConvert == null) {
+            return null;
+        }
+        List<String> convertedValues = new ArrayList<>();
+        for (Environment enumValue : toConvert) {
+            convertedValues.add(enumValue.value);
+        }
+        return convertedValues;
+    }
+}