From 42744a1b3891d49569a4bfaf2988988f310cd7e9 Mon Sep 17 00:00:00 2001 From: EstebanSP <36961346+EstebanSP-506@users.noreply.github.com> Date: Mon, 28 Sep 2020 11:27:49 -0600 Subject: [PATCH] Updated Documents Helper --- .../.gitignore | 22 + .../README.md | 207 +++++++++ .../build.gradle | 73 ++++ .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 55190 bytes .../gradle/wrapper/gradle-wrapper.properties | 6 + .../pom.xml | 99 +++++ .../settings.gradle | 1 + .../spapi/documents/CompressionAlgorithm.java | 36 ++ .../spapi/documents/CryptoStreamFactory.java | 29 ++ .../spapi/documents/DownloadBundle.java | 153 +++++++ .../spapi/documents/DownloadHelper.java | 128 ++++++ .../documents/DownloadSpecification.java | 76 ++++ .../spapi/documents/HttpTransferClient.java | 34 ++ .../amazon/spapi/documents/UploadHelper.java | 131 ++++++ .../spapi/documents/UploadSpecification.java | 79 ++++ .../documents/exception/CryptoException.java | 13 + .../exception/HttpResponseException.java | 63 +++ .../exception/MissingCharsetException.java | 13 + .../impl/AESCryptoStreamFactory.java | 96 +++++ .../documents/impl/OkHttpTransferClient.java | 136 ++++++ .../documents/CompressionAlgorithmTest.java | 46 ++ .../spapi/documents/DownloadBundleTest.java | 36 ++ .../spapi/documents/DownloadHelperTest.java | 403 ++++++++++++++++++ .../documents/DownloadSpecificationTest.java | 53 +++ .../spapi/documents/UploadHelperTest.java | 171 ++++++++ .../documents/UploadSpecificationTest.java | 71 +++ .../exception/CryptoExceptionTest.java | 15 + .../exception/HttpResponseExceptionTest.java | 54 +++ .../MissingCharsetExceptionTest.java | 15 + .../impl/AESCryptoStreamFactoryTest.java | 69 +++ .../impl/OkHttpTransferClientTest.java | 331 ++++++++++++++ .../org.mockito.plugins.Mockmaker | 1 + 32 files changed, 2660 insertions(+) create mode 100644 clients/sellingpartner-api-documents-helper-java/.gitignore create mode 100644 clients/sellingpartner-api-documents-helper-java/README.md create mode 100644 clients/sellingpartner-api-documents-helper-java/build.gradle create mode 100644 clients/sellingpartner-api-documents-helper-java/gradle/wrapper/gradle-wrapper.jar create mode 100644 clients/sellingpartner-api-documents-helper-java/gradle/wrapper/gradle-wrapper.properties create mode 100644 clients/sellingpartner-api-documents-helper-java/pom.xml create mode 100644 clients/sellingpartner-api-documents-helper-java/settings.gradle create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CompressionAlgorithm.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CryptoStreamFactory.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadBundle.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadHelper.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadSpecification.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/HttpTransferClient.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadHelper.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadSpecification.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/CryptoException.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/HttpResponseException.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/MissingCharsetException.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactory.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/OkHttpTransferClient.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/CompressionAlgorithmTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadBundleTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadHelperTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadSpecificationTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadHelperTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadSpecificationTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/CryptoExceptionTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/HttpResponseExceptionTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/MissingCharsetExceptionTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactoryTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/OkHttpTransferClientTest.java create mode 100644 clients/sellingpartner-api-documents-helper-java/src/test/resources/mockito-extensions/org.mockito.plugins.Mockmaker diff --git a/clients/sellingpartner-api-documents-helper-java/.gitignore b/clients/sellingpartner-api-documents-helper-java/.gitignore new file mode 100644 index 0000000..e3800fd --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/.gitignore @@ -0,0 +1,22 @@ +.idea +*.class + +# Mobile Tools for Java (J2ME) +.mtj.tmp/ + +# Package Files # +*.jar +*.war +*.ear + +# exclude jar for gradle wrapper +!gradle/wrapper/*.jar + +# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml +hs_err_pid* + +# build files +**/target +target +.gradle +build \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/README.md b/clients/sellingpartner-api-documents-helper-java/README.md new file mode 100644 index 0000000..2637fc6 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/README.md @@ -0,0 +1,207 @@ +# Selling Partner API Documents Helper + +This library provides helper classes that you can use to work with encrypted documents. Specifically, they help with: +* Encrypting and uploading a document +* Downloading an encrypted document and reading its decrypted contents + +Note: It’s the developer’s responsibility to always maintain encryption at rest. Unencrypted document content should never be stored on disk, even temporarily, because documents can contain sensitive information. +The helper classes provided in this library are built to assist with this. + +## Example usage + +### Upload + +```java +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.PipedInputStream; +import java.io.PipedOutputStream; +import java.nio.charset.StandardCharsets; + +import com.amazon.spapi.documents.UploadHelper; +import com.amazon.spapi.documents.UploadSpecification; +import com.amazon.spapi.documents.exception.CryptoException; +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.amazon.spapi.documents.impl.AESCryptoStreamFactory; + +/* We want to maintain encryption at rest, so do not write unencrypted data to disk. This is bad: + InputStream source = new FileInputStream(new File("/path/to/data.txt")); + + Instead, if your data can fit in memory, you can create an InputStream from a String (see encryptAndUpload_fromString()). + Otherwise, you can pipe data into an InputStream using Piped streams (see encryptAndUpload_fromPipedInputStream()). +*/ +public class UploadExample { + private final UploadHelper uploadHelper = new UploadHelper.Builder().build(); + + public void encryptAndUpload_fromString(String key, String initializationVector, String url) { + AESCryptoStreamFactory aesCryptoStreamFactory = + new AESCryptoStreamFactory.Builder(key, initializationVector) + .build(); + + String contentType = String.format("text/plain; charset=%s", StandardCharsets.UTF_8); + + // The character set must be the same one that is specified in contentType. + try (InputStream source = new ByteArrayInputStream("my document contents".getBytes(StandardCharsets.UTF_8))) { + UploadSpecification uploadSpec = + new UploadSpecification.Builder(contentType, aesCryptoStreamFactory, source, url) + .build(); + + uploadHelper.upload(uploadSpec); + } catch (CryptoException | HttpResponseException | IOException e) { + // Handle exception. + } + } + public void encryptAndUpload_fromPipedInputStream(String key, String initializationVector, String url) { + AESCryptoStreamFactory aesCryptoStreamFactory = + new AESCryptoStreamFactory.Builder(key, initializationVector) + .build(); + + String contentType = String.format("text/plain; charset=%s", StandardCharsets.UTF_8); + + try (PipedInputStream source = new PipedInputStream()) { + new Thread ( + new Runnable() { + public void run() { + try (PipedOutputStream documentContents = new PipedOutputStream(source)) { + // The character set must be the same one that is specified in contentType. + documentContents.write("my document contents\n".getBytes(StandardCharsets.UTF_8)); + documentContents.write("more document contents".getBytes(StandardCharsets.UTF_8)); + } catch (IOException e) { + // Handle exception. + } + } + } + ).start(); + + UploadSpecification uploadSpec = + new UploadSpecification.Builder(contentType, aesCryptoStreamFactory, source, url) + .build(); + + uploadHelper.upload(uploadSpec); + } catch (CryptoException | HttpResponseException | IOException e) { + // Handle exception. + } + } +} +``` + +### Download + +```java +import java.io.BufferedReader; +import java.io.IOException; + +import com.amazon.spapi.documents.CompressionAlgorithm; +import com.amazon.spapi.documents.DownloadBundle; +import com.amazon.spapi.documents.DownloadHelper; +import com.amazon.spapi.documents.DownloadSpecification; +import com.amazon.spapi.documents.exception.CryptoException; +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.amazon.spapi.documents.exception.MissingCharsetException; +import com.amazon.spapi.documents.impl.AESCryptoStreamFactory; + +public class DownloadExample { + final DownloadHelper downloadHelper = new DownloadHelper.Builder().build(); + + public void downloadAndDecrypt(String key, String initializationVector, String url, String compressionAlgorithm) { + AESCryptoStreamFactory aesCryptoStreamFactory = + new AESCryptoStreamFactory.Builder(key, initializationVector).build(); + + DownloadSpecification downloadSpec = new DownloadSpecification.Builder(aesCryptoStreamFactory, url) + .withCompressionAlgorithm(CompressionAlgorithm.fromEquivalent(compressionAlgorithm)) + .build(); + + try (DownloadBundle downloadBundle = downloadHelper.download(downloadSpec)) { + // This example assumes that the downloaded document has a charset in the content type, e.g. + // text/plain; charset=UTF-8 + try (BufferedReader reader = downloadBundle.newBufferedReader()) { + String line; + do { + line = reader.readLine(); + // Process the decrypted line. + } while (line != null); + } + } catch (CryptoException | HttpResponseException | IOException | MissingCharsetException e) { + // Handle exception here. + } + } +} +``` + +## Requirements + +Building the Selling Partner API Documents Helper requires: +1. Java 1.8+ +2. Maven/Gradle + + +## Installation + +To install the Selling Partner API Documents Helper to your local Maven repository, simply execute: + +```shell +mvn clean install +``` + +To deploy it to a remote Maven repository instead, configure the settings of the repository and execute: + +```shell +mvn clean deploy +``` + +Refer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information. + +### Maven users + +Add this dependency to your project's POM: + +```xml + + com.amazon.sellingpartnerapi + sellingpartner-api-documents-helper-java + 1.0.0 + +``` + +### Gradle users + +Add this dependency to your project's build file: + +```groovy +implementation "com.amazon.sellingpartnerapi:sellingpartner-api-documents-helper-java:1.0.0" +``` + +### Others + +At first generate the JAR by executing: + +```shell +mvn clean package +``` + +Then manually install the following JARs: + +* `target/sellingpartner-api-documents-helper-java.jar` +* `target/lib/*.jar` + +## License +Swagger Codegen templates are subject to the [Swagger Codegen License](https://github.com/swagger-api/swagger-codegen#license). + +All other work licensed as follows: + +Copyright Amazon.com Inc. or its affiliates. + +All Rights Reserved. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this library except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/clients/sellingpartner-api-documents-helper-java/build.gradle b/clients/sellingpartner-api-documents-helper-java/build.gradle new file mode 100644 index 0000000..4f341f9 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/build.gradle @@ -0,0 +1,73 @@ +plugins { + id 'idea' + id 'eclipse' + id 'java' +} + +group = 'com.amazon.sellingpartnerapi' +version = '1.0.0' + + +repositories { + jcenter() + mavenCentral() +} + +sourceCompatibility = JavaVersion.VERSION_1_8 +targetCompatibility = JavaVersion.VERSION_1_8 + + +/*sourceSets { + main { + java { + srcDirs = ['src/main/java'] + } + resources { + srcDirs = ['src/main/resources'] + } + } + + test { + java { + srcDirs = ['src/test/java'] + } + resources { + srcDirs = ['src/test/resources'] + } + } +}*/ + +task execute(type: JavaExec) { + main = System.getProperty('mainClass') + classpath = sourceSets.main.runtimeClasspath +} + +test { + useJUnitPlatform() + testLogging { + events "passed", "skipped", "failed" + } +} + +dependencies { + testImplementation(platform('org.junit:junit-bom:5.7.0')) + testImplementation('org.junit.jupiter:junit-jupiter') + testRuntimeOnly("org.junit.platform:junit-platform-launcher:1.7.0") + testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.7.0") + testRuntimeOnly("org.junit.vintage:junit-vintage-engine:5.7.0") + + implementation 'com.squareup.okhttp:okhttp:2.7.5' + implementation 'com.google.guava:guava:28.2-jre' + + // https://mvnrepository.com/artifact/org.threeten/threetenbp + implementation group: 'org.threeten', name: 'threetenbp', version: '1.3.5' + + // https://mvnrepository.com/artifact/junit/junit + implementation 'org.junit.jupiter:junit-jupiter-migrationsupport:5.5.1' + + implementation 'org.mockito:mockito-core:3.0.0' + implementation 'org.mockito:mockito-inline:3.0.0' + + implementation 'org.apache.directory.studio:org.apache.commons.io:2.4' + +} diff --git a/clients/sellingpartner-api-documents-helper-java/gradle/wrapper/gradle-wrapper.jar b/clients/sellingpartner-api-documents-helper-java/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..87b738cbd051603d91cc39de6cb000dd98fe6b02 GIT binary patch literal 55190 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 z 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 + + 4.0.0 + com.amazon.sellingpartnerapi + sellingpartner-api-documents-helper-java + 1.0.0 + + + com.squareup.okhttp + okhttp + 2.7.5 + + + com.squareup.okhttp + logging-interceptor + 2.7.5 + + + io.gsonfire + gson-fire + 1.8.0 + + + org.apache.directory.studio + org.apache.commons.io + 2.4 + + + com.google.guava + guava + 28.2-jre + + + org.threeten + threetenbp + 1.3.5 + + + + org.junit.platform + junit-platform-commons + 1.7.0 + + + org.junit.jupiter + junit-jupiter-engine + 5.0.0 + + + org.junit.jupiter + junit-jupiter-params + 5.3.2 + + + org.junit.jupiter + junit-jupiter-migrationsupport + 5.5.1 + + + org.mockito + mockito-core + 3.0.0 + + + org.mockito + mockito-inline + 3.0.0 + + + + + + maven-surefire-plugin + 2.22.2 + + + maven-failsafe-plugin + 2.22.2 + + + + + + org.apache.maven.plugins + maven-compiler-plugin + 3.7.0 + + + + + + 1.8 + ${java.version} + ${java.version} + 1.0.0 + UTF-8 + + diff --git a/clients/sellingpartner-api-documents-helper-java/settings.gradle b/clients/sellingpartner-api-documents-helper-java/settings.gradle new file mode 100644 index 0000000..07ac347 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/settings.gradle @@ -0,0 +1 @@ +rootProject.name = "sellingpartner-api-documents-helper-java" \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CompressionAlgorithm.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CompressionAlgorithm.java new file mode 100644 index 0000000..a107d2d --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CompressionAlgorithm.java @@ -0,0 +1,36 @@ +package com.amazon.spapi.documents; + +/** + * The compression algorithm. + */ +public enum CompressionAlgorithm { + GZIP; + + /** + * Convert from any equivalent enum value. If the specified enum value is null, return null. + * + * @param val The equivalent enum value to convert + * @return This enum's equivalent to the specified enum value + */ + public static CompressionAlgorithm fromEquivalent(T val) { + if (val != null) { + return CompressionAlgorithm.valueOf(val.toString()); + } + + return null; + } + + /** + * Convert from a string. If the specified string is null, return null. + * + * @param val The value to convert. + * @return This enum's equivalent to the specified string + */ + public static CompressionAlgorithm fromEquivalent(String val) { + if (val != null) { + return CompressionAlgorithm.valueOf(val); + } + + return null; + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CryptoStreamFactory.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CryptoStreamFactory.java new file mode 100644 index 0000000..f8ecaca --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/CryptoStreamFactory.java @@ -0,0 +1,29 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.CryptoException; + +import java.io.InputStream; + +/** + * Crypto stream factory interface. + */ +public interface CryptoStreamFactory { + /** + * Create a new {@link InputStream} that decrypts a stream of encrypted data. + * + * @param source The source for encrypted data to decrypt + * @return A new {@link InputStream} from which decrypted data can be read + * @throws CryptoException Crypto exception + */ + InputStream newDecryptStream(InputStream source) throws CryptoException; + + /** + * Create a new {@link InputStream} that encrypts a stream of unencrypted data. + * + * @param source The source for unencrypted data to encrypt + * @return A new {@link InputStream} from which encrypted data can be read + * @throws CryptoException Crypto exception + */ + InputStream newEncryptStream(InputStream source) throws CryptoException; + +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadBundle.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadBundle.java new file mode 100644 index 0000000..028f908 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadBundle.java @@ -0,0 +1,153 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.CryptoException; +import com.amazon.spapi.documents.exception.MissingCharsetException; +import com.squareup.okhttp.MediaType; +import org.apache.commons.io.IOUtils; + +import java.io.BufferedReader; +import java.io.Closeable; +import java.io.File; +import java.io.FileInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.nio.charset.Charset; +import java.util.zip.GZIPInputStream; + +/** + * Helper that contains and provides access to the downloaded contents of an encrypted document. {@link #close()} must + * be called to delete the temporary file that contains the encrypted document contents. + * + * Multiple independent streams and readers (from which unencrypted data can be read while maintaining encryption at + * rest on the filesystem) can be opened from an instance of {@link DownloadBundle}, but once {@link #close()} is + * called the behavior of any open streams or readers from this instance will be unspecified as the underlying + * temporary file will be deleted. + */ +public class DownloadBundle implements AutoCloseable { + private final CompressionAlgorithm compressionAlgorithm; + private final String contentType; + private final CryptoStreamFactory cryptoStreamFactory; + private final File document; + + DownloadBundle(CompressionAlgorithm compressionAlgorithm, String contentType, + CryptoStreamFactory cryptoStreamFactory, File document) { + this.compressionAlgorithm = compressionAlgorithm; + this.contentType = contentType; + this.cryptoStreamFactory = cryptoStreamFactory; + this.document = document; + } + + /** + * The content type of the unencrypted document contents. + * + * @return The content type + */ + public String getContentType() { + return contentType; + } + + /** + * Open an {@link InputStream} that allows the caller to read the decompressed (if applicable) and decrypted + * contents of the downloaded document. It is the responsibility of the caller to close the returned + * {@link InputStream}. The {@link InputStream}'s operation will be unspecified once this {@link DownloadBundle} is + * closed. + * + * @return An {@link InputStream} that decompresses and decrypts the document's contents + * @throws CryptoException Crypto exception + * @throws IOException IO exception + */ + public InputStream newInputStream() throws CryptoException, IOException { + Closeable closeThis = null; + try { + InputStream inputStream = new FileInputStream(document); + closeThis = inputStream; + + inputStream = cryptoStreamFactory.newDecryptStream(inputStream); + closeThis = inputStream; + + if (compressionAlgorithm != null) { + switch (compressionAlgorithm) { + case GZIP: + inputStream = new GZIPInputStream(inputStream); + closeThis = inputStream; + } + } + + closeThis = null; + return inputStream; + } finally { + IOUtils.closeQuietly(closeThis); + } + } + + /** + * Open a {@link BufferedReader} that allows the caller to read the decompressed (if applicable) and decrypted + * contents of the downloaded document. The character set is parsed from {@link #getContentType()}. If the character + * set could not be parsed, this method will fail with {@link MissingCharsetException}. + * + * It is the responsibility of the caller to close the returned {@link BufferedReader}. This {@link BufferedReader} + * will become invalid once this {@link DownloadBundle} is closed. + * + * @return A {@link BufferedReader} that decompresses and decrypts the document's contents + * @throws CryptoException Crypto exception + * @throws IOException IO exception + * @throws MissingCharsetException The character set could not be parsed from {@link #getContentType()} + */ + public BufferedReader newBufferedReader() throws CryptoException, IOException, MissingCharsetException { + return newBufferedReader(null); + } + + /** + * Open a {@link BufferedReader} that allows the caller to read the decompressed (if applicable) and decrypted + * contents of the downloaded document. The character set is parsed from {@link #getContentType()}. If the character + * set could not be parsed and defaultCharset is specified, this method will attempt to open the reader + * with defaultCharset. Otherwise, this method will fail with {@link MissingCharsetException}. + * + * It is the responsibility of the caller to close the returned {@link BufferedReader}. This {@link BufferedReader} + * will become invalid once this {@link DownloadBundle} is closed. + * + * @param defaultCharset The default charset to use if a charset cannot be parsed from the content type. + * @return A {@link BufferedReader} that decompresses and decrypts the document's contents + * @throws CryptoException Crypto exception + * @throws IOException IO exception + * @throws MissingCharsetException The character set could not be parsed from {@link #getContentType()} and + * defaultCharset was not specified. + */ + public BufferedReader newBufferedReader(Charset defaultCharset) throws CryptoException, IOException, + MissingCharsetException { + String contentType = getContentType(); + + Charset charset = MediaType.parse(contentType).charset(); + if (charset == null) { + charset = defaultCharset; + } + + if (charset == null) { + throw new MissingCharsetException(String.format( + "Could not parse character set from content type '%s' and no default provided", contentType)); + } + + Closeable closeThis = null; + try { + InputStream inputStream = newInputStream(); + closeThis = inputStream; + + InputStreamReader reader = new InputStreamReader(inputStream, charset); + closeThis = reader; + + BufferedReader bufferedReader = new BufferedReader(reader); + closeThis = null; + return bufferedReader; + } finally { + IOUtils.closeQuietly(closeThis); + } + } + + /** + * Closes this {@link DownloadBundle}, deleting the temporary file containing the encrypted document contents. + */ + public void close() { + document.delete(); + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadHelper.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadHelper.java new file mode 100644 index 0000000..aaa1436 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadHelper.java @@ -0,0 +1,128 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.amazon.spapi.documents.impl.OkHttpTransferClient; + +import java.io.File; +import java.io.IOException; + +/** + * Helper for downloading encrypted documents. + */ +public class DownloadHelper { + private final HttpTransferClient httpTransferClient; + private final String tmpFilePrefix; + private final String tmpFileSuffix; + private final File tmpFileDirectory; + + private DownloadHelper(HttpTransferClient httpTransferClient, String tmpFilePrefix, String tmpFileSuffix, + File tmpFileDirectory) { + this.httpTransferClient = httpTransferClient; + this.tmpFilePrefix = tmpFilePrefix; + this.tmpFileSuffix = tmpFileSuffix; + this.tmpFileDirectory = tmpFileDirectory; + } + + /** + * Download the specified document's encrypted contents to a temporary file on disk. It is the responsibility of the + * caller to call close on the returned {@link AutoCloseable} {@link DownloadBundle}. + * + * Common reasons for receiving a 403 response include: + *
  • The signed URL has expired + * + * @param spec The specification for the download + * @return The closeable {@link DownloadBundle} + * @throws HttpResponseException On failure HTTP response + * @throws IOException IO Exception + */ + public DownloadBundle download(DownloadSpecification spec) throws HttpResponseException, IOException { + + File tmpFile = File.createTempFile(tmpFilePrefix, tmpFileSuffix, tmpFileDirectory); + + try { + tmpFile.deleteOnExit(); + + String contentType = httpTransferClient.download(spec.getUrl(), tmpFile); + + return new DownloadBundle( + spec.getCompressionAlgorithm(), contentType, spec.getCryptoStreamFactory(), tmpFile); + } catch (Exception e) { + tmpFile.delete(); + throw e; + } + } + + /** + * Use this to create an instance of a {@link DownloadHelper}. + */ + public static class Builder { + private HttpTransferClient httpTransferClient = null; + private String tmpFilePrefix = "SPAPI"; + private String tmpFileSuffix = null; + private File tmpFileDirectory = null; + + /** + * The HTTP transfer client. + * + * @param httpTransferClient The HTTP transfer client + * @return this + */ + public Builder withHttpTransferClient(HttpTransferClient httpTransferClient) { + this.httpTransferClient = httpTransferClient; + return this; + } + + /** + * The tmp file prefix. If not specified, defaults to "SPAPI". + * + * @param tmpFilePrefix The prefix string to be used in generating the tmp file's name; must be at least three + * characters long + * @return this + */ + public Builder withTmpFilePrefix(String tmpFilePrefix) { + if (tmpFilePrefix.length() < 3) { + throw new IllegalArgumentException("Prefix string too short"); + } + + this.tmpFilePrefix = tmpFilePrefix; + return this; + } + + /** + * The tmp file suffix. If not specified, defaults to null. + * + * @param tmpFileSuffix The suffix string to be used in generating the file's name; may be null, in + * which case the suffix ".tmp" will be used + * @return this + */ + public Builder withTmpFileSuffix(String tmpFileSuffix) { + this.tmpFileSuffix = tmpFileSuffix; + return this; + } + + /** + * The tmp file directory. If not specified, defaults to null. + * + * @param tmpFileDirectory The directory in which the file is to be created, or null if the default + * temporary-file directory is to be used + * @return this + */ + public Builder withTmpFileDirectory(File tmpFileDirectory) { + this.tmpFileDirectory = tmpFileDirectory; + return this; + } + + /** + * Create the helper. + * + * @return The helper + */ + public DownloadHelper build() { + if (httpTransferClient == null) { + httpTransferClient = new OkHttpTransferClient.Builder().build(); + } + + return new DownloadHelper(httpTransferClient, tmpFilePrefix, tmpFileSuffix, tmpFileDirectory); + } + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadSpecification.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadSpecification.java new file mode 100644 index 0000000..6b03869 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/DownloadSpecification.java @@ -0,0 +1,76 @@ +package com.amazon.spapi.documents; + +import com.google.common.base.Preconditions; + +/** + * Specification for {@link DownloadHelper#download(DownloadSpecification)}. + */ +public class DownloadSpecification { + private final CompressionAlgorithm compressionAlgorithm; + private final CryptoStreamFactory cryptoStreamFactory; + private final String url; + + private DownloadSpecification(CompressionAlgorithm compressionAlgorithm, CryptoStreamFactory cryptoStreamFactory, + String url) { + this.compressionAlgorithm = compressionAlgorithm; + this.cryptoStreamFactory = cryptoStreamFactory; + this.url = url; + } + + CompressionAlgorithm getCompressionAlgorithm() { + return compressionAlgorithm; + } + + CryptoStreamFactory getCryptoStreamFactory() { + return cryptoStreamFactory; + } + + String getUrl() { + return url; + } + + /** + * Use this to create an instance of a {@link DownloadSpecification}. + */ + public static class Builder { + private final CryptoStreamFactory cryptoStreamFactory; + private final String url; + + private CompressionAlgorithm compressionAlgorithm = null; + + /** + * Create the builder. + * + * @param cryptoStreamFactory The crypto stream factory + * @param url The url to download the encrypted document from + */ + public Builder(CryptoStreamFactory cryptoStreamFactory, String url) { + Preconditions.checkArgument(cryptoStreamFactory != null, "cryptoStreamFactory is required"); + Preconditions.checkArgument(url != null, "url is required"); + + this.cryptoStreamFactory = cryptoStreamFactory; + this.url = url; + } + + /** + * The compression algorithm. + * + * @param compressionAlgorithm The compression algorithm + * @return this + */ + public Builder withCompressionAlgorithm(CompressionAlgorithm compressionAlgorithm) { + this.compressionAlgorithm = compressionAlgorithm; + return this; + } + + /** + * Create the specification. + * + * @return The specification + */ + public DownloadSpecification build() { + return new DownloadSpecification(compressionAlgorithm, cryptoStreamFactory, url); + } + + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/HttpTransferClient.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/HttpTransferClient.java new file mode 100644 index 0000000..ec2dc80 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/HttpTransferClient.java @@ -0,0 +1,34 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.HttpResponseException; + +import java.io.File; +import java.io.IOException; + +/** + * HTTP transfer client. Implementations of this interface must be thread-safe and reusable for multiple requests. + */ +public interface HttpTransferClient { + /** + * Perform an HTTP GET on the specified url, storing the response body to destination. + * + * @param url The url to perform an HTTP GET on + * @param destination The file to write the HTTP GET response body to + * @return The Content-Type header value extracted from the response to the HTTP GET + * @throws HttpResponseException On failure HTTP response + * @throws IOException IO exception + */ + String download(String url, File destination) throws HttpResponseException, IOException; + + /** + * Perform an HTTP PUT on the specified url, uploading the contents of source to the body + * of the request. + * + * @param url The url to perform an HTTP PUT on + * @param contentType The Content-Type header to be used for the HTTP PUT request + * @param source The file to read the HTTP PUT body from + * @throws HttpResponseException On failure HTTP response + * @throws IOException IO exception + */ + void upload(String url, String contentType, File source) throws HttpResponseException, IOException; +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadHelper.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadHelper.java new file mode 100644 index 0000000..553f122 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadHelper.java @@ -0,0 +1,131 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.CryptoException; +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.amazon.spapi.documents.impl.OkHttpTransferClient; +import org.apache.commons.io.FileUtils; + +import java.io.File; +import java.io.IOException; +import java.io.InputStream; + +/** + * Helper class for encrypting and uploading documents. + */ +public class UploadHelper { + private final HttpTransferClient httpTransferClient; + private final String tmpFilePrefix; + private final String tmpFileSuffix; + private final File tmpFileDirectory; + + private UploadHelper(HttpTransferClient httpTransferClient, String tmpFilePrefix, String tmpFileSuffix, + File tmpFileDirectory) { + this.httpTransferClient = httpTransferClient; + this.tmpFilePrefix = tmpFilePrefix; + this.tmpFileSuffix = tmpFileSuffix; + this.tmpFileDirectory = tmpFileDirectory; + } + + /** + * Perform the specified upload. This method will buffer the encrypted contents of the document in a temporary file + * before uploading to the specified url. + * + * Common reasons for receiving a 403 response include: + *
  • The signed URL has expired + *
  • {@link UploadSpecification#getContentType()} does not match the content type the URL was signed with + * + * @param spec The specification for the upload + * @throws CryptoException Crypto exception + * @throws HttpResponseException On failure HTTP response + * @throws IOException IO exception + */ + public void upload(UploadSpecification spec) throws CryptoException, HttpResponseException, IOException { + File tmpFile = File.createTempFile(tmpFilePrefix, tmpFileSuffix, tmpFileDirectory); + + try { + tmpFile.deleteOnExit(); + + try (InputStream inputStream = spec.getCryptoStreamFactory().newEncryptStream(spec.getSource())) { + FileUtils.copyInputStreamToFile(inputStream, tmpFile); + } + + httpTransferClient.upload(spec.getUrl(), spec.getContentType(), tmpFile); + } finally { + tmpFile.delete(); + } + } + + /** + * Use this to create an instance of an {@link UploadHelper}. + */ + public static class Builder { + private HttpTransferClient httpTransferClient = null; + private String tmpFilePrefix = "SPAPI"; + private String tmpFileSuffix = null; + private File tmpFileDirectory = null; + + /** + * The HTTP transfer client. + * + * @param httpTransferClient The HTTP transfer client. + * @return this + */ + public Builder withHttpTransferClient(HttpTransferClient httpTransferClient) { + this.httpTransferClient = httpTransferClient; + return this; + } + + /** + * The tmp file prefix. If not specified, defaults to "SPAPI". + * + * @param tmpFilePrefix The prefix string to be used in generating the tmp file's name; must be at least three + * characters long + * @return this + */ + public Builder withTmpFilePrefix(String tmpFilePrefix) { + if (tmpFilePrefix.length() < 3) { + throw new IllegalArgumentException("Prefix string too short"); + } + + this.tmpFilePrefix = tmpFilePrefix; + return this; + } + + /** + * The tmp file suffix. If not specified, defaults to null. + * + * @param tmpFileSuffix The suffix string to be used in generating the file's name; may be null, in + * which case the suffix ".tmp" will be used + * @return this + */ + public Builder withTmpFileSuffix(String tmpFileSuffix) { + this.tmpFileSuffix = tmpFileSuffix; + return this; + } + + /** + * The tmp file directory. If not specified, defaults to null. + * + * @param tmpFileDirectory The directory in which the file is to be created, or null if the default + * temporary-file directory is to be used + * @return this + */ + public Builder withTmpFileDirectory(File tmpFileDirectory) { + this.tmpFileDirectory = tmpFileDirectory; + return this; + } + + /** + * Create the helper. + * + * @return The helper. + */ + public UploadHelper build() { + if (httpTransferClient == null) { + httpTransferClient = new OkHttpTransferClient.Builder().build(); + } + + return new UploadHelper(httpTransferClient, tmpFilePrefix, tmpFileSuffix, tmpFileDirectory); + } + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadSpecification.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadSpecification.java new file mode 100644 index 0000000..eb93d1f --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/UploadSpecification.java @@ -0,0 +1,79 @@ +package com.amazon.spapi.documents; + +import com.google.common.base.Preconditions; + +import java.io.InputStream; + +/** + * Specification for {@link UploadHelper#upload(UploadSpecification)}. + */ +public class UploadSpecification { + private final String contentType; + private final CryptoStreamFactory cryptoStreamFactory; + private final InputStream source; + private final String url; + + private UploadSpecification(String contentType, CryptoStreamFactory cryptoStreamFactory, InputStream source, + String url) { + this.contentType = contentType; + this.cryptoStreamFactory = cryptoStreamFactory; + this.source = source; + this.url = url; + } + + String getContentType() { + return contentType; + } + + CryptoStreamFactory getCryptoStreamFactory() { + return cryptoStreamFactory; + } + + InputStream getSource() { + return source; + } + + String getUrl() { + return url; + } + + /** + * Use this to create an instance of an {@link UploadSpecification}. + */ + public static class Builder { + private final String contentType; + private final CryptoStreamFactory cryptoStreamFactory; + private final InputStream source; + private final String url; + + /** + * Create the builder. + * + * @param contentType The content type of the document to upload + * @param cryptoStreamFactory The crypto stream factory + * @param source The source of the unencrypted data to upload + * @param url The url + */ + public Builder(String contentType, CryptoStreamFactory cryptoStreamFactory, InputStream source, String url) { + Preconditions.checkArgument(contentType != null, "contentType is required"); + Preconditions.checkArgument(cryptoStreamFactory != null, "cryptoStreamFactory is required"); + Preconditions.checkArgument(source != null, "source is required"); + Preconditions.checkArgument(url != null, "url is required"); + + this.contentType = contentType; + this.cryptoStreamFactory = cryptoStreamFactory; + this.source = source; + this.url = url; + } + + /** + * Create the specification. + * + * @return The specification + */ + public UploadSpecification build() { + return new UploadSpecification(contentType, cryptoStreamFactory, source, url); + } + + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/CryptoException.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/CryptoException.java new file mode 100644 index 0000000..1e36f72 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/CryptoException.java @@ -0,0 +1,13 @@ +package com.amazon.spapi.documents.exception; + +/** + * Crypto exception. + */ +public class CryptoException extends Exception { + /** + * {@inheritDoc} + */ + public CryptoException(Throwable cause) { + super(cause); + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/HttpResponseException.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/HttpResponseException.java new file mode 100644 index 0000000..c749c2c --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/HttpResponseException.java @@ -0,0 +1,63 @@ +package com.amazon.spapi.documents.exception; + +/** + * The details of an HTTP response that indicates failure. + */ +public class HttpResponseException extends Exception { + private final String body; + private final int code; + + /** + * {@inheritDoc} + * + * @param message The {@link Exception} message + * @param body The body + * @param code The HTTP status code + */ + public HttpResponseException(String message, String body, int code) { + super(message); + this.body = body; + this.code = code; + } + + /** + * {@inheritDoc} + * + * @param message The {@link Exception} message + * @param cause The {@link Exception} cause + * @param body The body + * @param code The HTTP status code + */ + public HttpResponseException(String message, Throwable cause, String body, int code) { + super(message, cause); + this.body = body; + this.code = code; + } + + /** + * The body. To ensure that a remote server cannot overwhelm heap memory, the body may have been truncated. + * + * @return The body + */ + public String getBody() { + return body; + } + + /** + * The HTTP status code + * + * @return The HTTP status code + */ + public int getCode() { + return code; + } + + @Override + public String toString() { + return super.toString() + " {code=" + + getCode() + + ", body=" + + getBody() + + '}'; + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/MissingCharsetException.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/MissingCharsetException.java new file mode 100644 index 0000000..693431a --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/exception/MissingCharsetException.java @@ -0,0 +1,13 @@ +package com.amazon.spapi.documents.exception; + +/** + * Missing charset exception. + */ +public class MissingCharsetException extends Exception { + /** + * {@inheritDoc} + */ + public MissingCharsetException(String message) { + super(message); + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactory.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactory.java new file mode 100644 index 0000000..d6b0fc5 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactory.java @@ -0,0 +1,96 @@ +package com.amazon.spapi.documents.impl; + +import com.amazon.spapi.documents.CryptoStreamFactory; +import com.amazon.spapi.documents.exception.CryptoException; +import com.google.common.base.Preconditions; + +import javax.crypto.Cipher; +import javax.crypto.CipherInputStream; +import javax.crypto.NoSuchPaddingException; +import javax.crypto.spec.IvParameterSpec; +import javax.crypto.spec.SecretKeySpec; +import java.io.InputStream; +import java.security.InvalidAlgorithmParameterException; +import java.security.InvalidKeyException; +import java.security.Key; +import java.security.NoSuchAlgorithmException; +import java.util.Base64; + +/** + * A crypto stream factory implementing AES encryption. + */ +public class AESCryptoStreamFactory implements CryptoStreamFactory { + private static final String ENCRYPTION_ALGORITHM = "AES/CBC/PKCS5Padding"; + + private final Key key; + private final byte[] initializationVector; + + private AESCryptoStreamFactory(Key key, byte[] initializationVector) { + this.key = key; + this.initializationVector = initializationVector; + } + + private Cipher createInitializedCipher(int mode) throws CryptoException { + try { + Cipher cipher = Cipher.getInstance(ENCRYPTION_ALGORITHM); + cipher.init(mode, key, new IvParameterSpec(initializationVector)); + return cipher; + } catch (InvalidKeyException | InvalidAlgorithmParameterException | NoSuchAlgorithmException | + NoSuchPaddingException e) { + throw new CryptoException(e); + } + } + + /** + * {@inheritDoc} + */ + @Override + public InputStream newDecryptStream(InputStream source) throws CryptoException { + return new CipherInputStream(source, createInitializedCipher(Cipher.DECRYPT_MODE)); + } + + /** + * {@inheritDoc} + */ + @Override + public InputStream newEncryptStream(InputStream source) throws CryptoException { + return new CipherInputStream(source, createInitializedCipher(Cipher.ENCRYPT_MODE)); + } + + /** + * Use this to create an instance of an {@link AESCryptoStreamFactory}. + */ + public static class Builder { + private static final Base64.Decoder BASE64_DECODER = Base64.getDecoder(); + private static final String REQUIRED_KEY_ALGORITHM = "AES"; + + private final String key; + private final String initializationVector; + + /** + * Create the builder. + * + * @param key The key + * @param initializationVector The initialization vector + */ + public Builder(String key, String initializationVector) { + Preconditions.checkArgument(key != null, "key is required"); + Preconditions.checkArgument(initializationVector != null, "initializationVector is required"); + + this.key = key; + this.initializationVector = initializationVector; + } + + /** + * Create the crypto stream factory. + * + * @return the crypto stream factory + */ + public AESCryptoStreamFactory build() { + Key convertedKey = new SecretKeySpec(BASE64_DECODER.decode(key), REQUIRED_KEY_ALGORITHM); + byte[] convertedInitializationVector = BASE64_DECODER.decode(initializationVector); + + return new AESCryptoStreamFactory(convertedKey, convertedInitializationVector); + } + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/OkHttpTransferClient.java b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/OkHttpTransferClient.java new file mode 100644 index 0000000..6d682bd --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/main/java/com/amazon/spapi/documents/impl/OkHttpTransferClient.java @@ -0,0 +1,136 @@ +package com.amazon.spapi.documents.impl; + +import com.amazon.spapi.documents.HttpTransferClient; +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.squareup.okhttp.MediaType; +import com.squareup.okhttp.OkHttpClient; +import com.squareup.okhttp.Request; +import com.squareup.okhttp.RequestBody; +import com.squareup.okhttp.Response; +import org.apache.commons.io.FileUtils; +import org.apache.commons.io.IOUtils; + +import java.io.File; +import java.io.IOException; +import java.io.Reader; + +/** + * HTTP transfer client utilizing OkHttp. + */ +public class OkHttpTransferClient implements HttpTransferClient { + private static final String CONTENT_TYPE_HEADER = "Content-Type"; + + private final OkHttpClient client; + private final int maxErrorBodyLen; + + private OkHttpTransferClient(OkHttpClient client, int maxErrorBodyLen) { + this.client = client; + this.maxErrorBodyLen = maxErrorBodyLen; + } + + private HttpResponseException createResponseException(Response response) { + String body = ""; + if (maxErrorBodyLen > 0) { + try (Reader bodyReader = response.body().charStream()) { + char[] buf = new char[maxErrorBodyLen]; + int charsRead = IOUtils.read(bodyReader, buf); + if (charsRead > 0) { + body = new String(buf, 0, charsRead); + } + } catch (Exception e) { + // Ignore any failures reading the body so that the original failure is not lost + } + } + + return new HttpResponseException(response.message(), body, response.code()); + } + + /** + * {@inheritDoc} + */ + @Override + public String download(String url, File destination) throws HttpResponseException, IOException { + Request request = new Request.Builder() + .url(url) + .get() + .build(); + + Response response = client.newCall(request).execute(); + try { + if (!response.isSuccessful()) { + throw createResponseException(response); + } + + FileUtils.copyInputStreamToFile(response.body().byteStream(), destination); + } finally { + IOUtils.closeQuietly(response.body()); + } + + return response.header(CONTENT_TYPE_HEADER); + } + + /** + * {@inheritDoc} + */ + @Override + public void upload(String url, String contentType, File source) throws HttpResponseException, IOException { + Request request = new Request.Builder() + .url(url) + .put(RequestBody.create(MediaType.parse(contentType), source)) + .build(); + + Response response = client.newCall(request).execute(); + try { + if (!response.isSuccessful()) { + throw createResponseException(response); + } + } finally { + IOUtils.closeQuietly(response.body()); + } + } + + /** + * Use this to create an instance of an {@link OkHttpTransferClient}. + */ + public static class Builder { + private OkHttpClient client = null; + private int maxErrorBodyLen = 4096; + + /** + * The {@link OkHttpClient}. If not specified, a new instance of {@link OkHttpClient} will be created using the + * no-arg constructor. + * + * @param client The client + * @return this + */ + public Builder withClient(OkHttpClient client) { + this.client = client; + return this; + } + + /** + * When an HTTP response indicates failure, the maximum number of characters for + * {@link HttpResponseException#getBody()}. Default 4096. + * + * @param maxErrorBodyLen The maximum number of characters to extract from the response body on failure + * @return this + */ + public Builder withMaxErrorBodyLen(int maxErrorBodyLen) { + this.maxErrorBodyLen = maxErrorBodyLen; + return this; + } + + /** + * Create the client. + * + * @return The client + */ + public OkHttpTransferClient build() { + if (client == null) { + client = new OkHttpClient(); + } + + return new OkHttpTransferClient(client, maxErrorBodyLen); + } + } +} diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/CompressionAlgorithmTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/CompressionAlgorithmTest.java new file mode 100644 index 0000000..511581b --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/CompressionAlgorithmTest.java @@ -0,0 +1,46 @@ +package com.amazon.spapi.documents; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class CompressionAlgorithmTest { + public enum MyEnum { + GZIP, NOT_GZIP + } + + @Test + public void testFromEquivalent() { + assertEquals(CompressionAlgorithm.GZIP, CompressionAlgorithm.fromEquivalent(MyEnum.GZIP)); + } + + @Test + public void testFromEquivalentNull() { + MyEnum myEnum = null; + assertNull(CompressionAlgorithm.fromEquivalent(myEnum)); + } + + @Test + public void testNotEquivalent() { + Assertions.assertThrows(IllegalArgumentException.class, + () -> CompressionAlgorithm.fromEquivalent(MyEnum.NOT_GZIP)); + } + + @Test + public void testFromString() { + assertEquals(CompressionAlgorithm.GZIP, CompressionAlgorithm.fromEquivalent("GZIP")); + } + + @Test + public void testFromStringNull() { + String val = null; + assertNull(CompressionAlgorithm.fromEquivalent(val)); + } + + @Test + public void testFromStringUnsupportedValue() { + Assertions.assertThrows(IllegalArgumentException.class, + () -> CompressionAlgorithm.fromEquivalent("NOT_GZIP")); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadBundleTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadBundleTest.java new file mode 100644 index 0000000..793207e --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadBundleTest.java @@ -0,0 +1,36 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.impl.AESCryptoStreamFactory; +import org.junit.jupiter.api.Test; + +import java.io.File; +import java.io.FileNotFoundException; + +import static org.junit.jupiter.api.Assertions.*; + +class DownloadBundleTest { + private static String KEY = "sxx/wImF6BFndqSAz56O6vfiAh8iD9P297DHfFgujec="; + private static String VECTOR = "7S2tn363v0wfCfo1IX2Q1A=="; + + private DownloadBundle createBadFileBundle() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + + File file = File.createTempFile("foo", null, null); + file.delete(); + + return new DownloadBundle(null, contentType, cryptoStreamFactory, file); + } + + @Test + public void testNewInputStreamBadFile() throws Exception { + DownloadBundle downloadBundle = createBadFileBundle(); + assertThrows(FileNotFoundException.class, () -> downloadBundle.newInputStream()); + } + + @Test + public void testNewReaderBadFile() throws Exception { + DownloadBundle downloadBundle = createBadFileBundle(); + assertThrows(FileNotFoundException.class, () -> downloadBundle.newBufferedReader()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadHelperTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadHelperTest.java new file mode 100644 index 0000000..b9d46d3 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadHelperTest.java @@ -0,0 +1,403 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.exception.MissingCharsetException; +import com.amazon.spapi.documents.impl.AESCryptoStreamFactory; +import org.apache.commons.io.FileUtils; +import org.apache.commons.io.IOUtils; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.Mockito; +import org.mockito.invocation.InvocationOnMock; +import org.mockito.stubbing.Answer; + +import java.io.BufferedReader; +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.File; +import java.io.InputStream; +import java.io.StringReader; +import java.nio.charset.StandardCharsets; +import java.nio.charset.UnsupportedCharsetException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.zip.GZIPOutputStream; + +import static org.junit.jupiter.api.Assertions.*; + +class DownloadHelperTest { + private static String KEY = "sxx/wImF6BFndqSAz56O6vfiAh8iD9P297DHfFgujec="; + private static String VECTOR = "7S2tn363v0wfCfo1IX2Q1A=="; + + private Answer getTransferAnswer(String contentType, CryptoStreamFactory cryptoStreamFactory, String fileContents, + boolean isGZipped) { + return new Answer() { + @Override + public Object answer(InvocationOnMock invocation) throws Throwable { + File file = invocation.getArgument(1); + + byte[] dataToWrite = fileContents.getBytes(StandardCharsets.UTF_8); + + if (isGZipped) { + ByteArrayOutputStream byteStream = new ByteArrayOutputStream(dataToWrite.length); + GZIPOutputStream zipStream = new GZIPOutputStream(byteStream); + zipStream.write(dataToWrite); + zipStream.close(); + dataToWrite = byteStream.toByteArray(); + } + + // Write encrypted contents to file to mimic downloading an encrypted file + InputStream source = new ByteArrayInputStream(dataToWrite); + try (InputStream inputStream = cryptoStreamFactory.newEncryptStream(source)) { + FileUtils.copyInputStreamToFile(inputStream, file); + } + + return contentType; + } + }; + } + + @Test + public void testSuccess() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "SPAPI.*\\.tmp$"; + String expectContents = "Hello World"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, false)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testSuccessWithCompression() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "SPAPI.*\\.tmp$"; + String expectContents = "Hello World"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, true)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url) + .withCompressionAlgorithm(CompressionAlgorithm.GZIP) + .build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + + try (BufferedReader contents = bundle.newBufferedReader()) { + assertTrue(IOUtils.contentEquals(contents, new StringReader(expectContents))); + } + + assertTrue(file.exists()); + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testSuccessWithCustomTempFileParams() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "NOTSPAPI.*\\.NOTtmp$"; + String expectContents = "Hello World"; + String expectedFilePath = "spapitmp"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, false)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + File tmpDir = new File(Paths.get(System.getProperty("java.io.tmpdir"), expectedFilePath) + .toAbsolutePath().toString()); + tmpDir.mkdirs(); + tmpDir.deleteOnExit(); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .withTmpFilePrefix("NOTSPAPI") + .withTmpFileSuffix(".NOTtmp") + .withTmpFileDirectory(tmpDir) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + assertEquals(expectedFilePath, file.getParentFile().getName()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + try (BufferedReader contents = bundle.newBufferedReader()) { + assertTrue(IOUtils.contentEquals(contents, new StringReader(expectContents))); + } + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + + assertTrue(file.exists()); + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testReaderBadCharset() throws Exception { + String contentType = "text/xml; charset=NOTSUPPORTED"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "NOTSPAPI.*\\.NOTtmp$"; + String expectContents = "Hello World"; + String expectedFilePath = "spapitmp"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, false)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + File tmpDir = new File(Paths.get(System.getProperty("java.io.tmpdir"), expectedFilePath) + .toAbsolutePath().toString()); + tmpDir.mkdirs(); + tmpDir.deleteOnExit(); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .withTmpFilePrefix("NOTSPAPI") + .withTmpFileSuffix(".NOTtmp") + .withTmpFileDirectory(tmpDir) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + assertEquals(expectedFilePath, file.getParentFile().getName()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + assertThrows(UnsupportedCharsetException.class, () -> bundle.newBufferedReader()); + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + + assertTrue(file.exists()); + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testMissingCharsetNoDefault() throws Exception { + String contentType = "text/xml"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "NOTSPAPI.*\\.NOTtmp$"; + String expectContents = "Hello World"; + String expectedFilePath = "spapitmp"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, false)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + File tmpDir = new File(Paths.get(System.getProperty("java.io.tmpdir"), expectedFilePath) + .toAbsolutePath().toString()); + tmpDir.mkdirs(); + tmpDir.deleteOnExit(); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .withTmpFilePrefix("NOTSPAPI") + .withTmpFileSuffix(".NOTtmp") + .withTmpFileDirectory(tmpDir) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + assertEquals(expectedFilePath, file.getParentFile().getName()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + assertThrows(MissingCharsetException.class, () -> bundle.newBufferedReader()); + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + + assertTrue(file.exists()); + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testSuccessMissingBadCharsetDefaultProvided() throws Exception { + String contentType = "text/xml"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "NOTSPAPI.*\\.NOTtmp$"; + String expectContents = "Hello World"; + String expectedFilePath = "spapitmp"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + ArgumentCaptor fileArg = ArgumentCaptor.forClass(File.class); + Mockito.doReturn(contentType).when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + Mockito.doAnswer(getTransferAnswer(contentType, cryptoStreamFactory, expectContents, false)) + .when(httpTransferClient).download(Mockito.eq(url), fileArg.capture()); + + File tmpDir = new File(Paths.get(System.getProperty("java.io.tmpdir"), expectedFilePath) + .toAbsolutePath().toString()); + tmpDir.mkdirs(); + tmpDir.deleteOnExit(); + + DownloadHelper helper = new DownloadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .withTmpFilePrefix("NOTSPAPI") + .withTmpFileSuffix(".NOTtmp") + .withTmpFileDirectory(tmpDir) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + File file; + try (DownloadBundle bundle = helper.download(spec)) { + assertEquals(contentType, bundle.getContentType()); + + file = fileArg.getValue(); + assertTrue(file.exists()); + assertEquals(expectedFilePath, file.getParentFile().getName()); + + assertTrue(file.getName().matches(expectedFileRegex)); + + try (InputStream contents = bundle.newInputStream()) { + assertTrue(IOUtils.contentEquals(contents, new ByteArrayInputStream(expectContents.getBytes( + StandardCharsets.UTF_8)))); + } + + try (BufferedReader contents = bundle.newBufferedReader(StandardCharsets.UTF_8)) { + assertTrue(IOUtils.contentEquals(contents, new StringReader(expectContents))); + } + + assertTrue(file.exists()); + } + + assertFalse(file.exists()); + + Mockito.verify(httpTransferClient).download(Mockito.eq(url), Mockito.any()); + } + + @Test + public void testBadUrlDownload() throws Exception { + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + String url = "sdfkajsdfiefi"; + + Path path = Files.createTempDirectory("SPAPI"); + + DownloadHelper helper = new DownloadHelper.Builder() + .withTmpFileDirectory(path.toFile()) + .build(); + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url) + .build(); + + try { + assertThrows(IllegalArgumentException.class, () -> helper.download(spec)); + } finally { + // This will throw if the directory is not empty, indicating that the temp file was not removed + Files.delete(path); + } + } + + @Test + public void testInvalidTmpFilePrefix() { + DownloadHelper.Builder builder = new DownloadHelper.Builder(); + + assertThrows(IllegalArgumentException.class, () -> builder + .withTmpFilePrefix("A")); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadSpecificationTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadSpecificationTest.java new file mode 100644 index 0000000..b9cac73 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/DownloadSpecificationTest.java @@ -0,0 +1,53 @@ +package com.amazon.spapi.documents; + +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; + +import static org.junit.jupiter.api.Assertions.*; + +class DownloadSpecificationTest { + @Test + public void testBuilderConstructorMissingCryptoStreamFactory() throws Exception { + CryptoStreamFactory cryptoStreamFactory = null; + String url = "https://www.amazon.com"; + + assertThrows(IllegalArgumentException.class, () -> + new DownloadSpecification.Builder(cryptoStreamFactory, url)); + } + + @Test + public void testBuilderConstructorMissingUrl() throws Exception { + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + String url = null; + + assertThrows(IllegalArgumentException.class, () -> + new DownloadSpecification.Builder(cryptoStreamFactory, url)); + } + + @Test + public void testSuccess() throws Exception { + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + String url = "http://abc.com/123"; + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url).build(); + + assertNull(spec.getCompressionAlgorithm()); + assertSame(cryptoStreamFactory, spec.getCryptoStreamFactory()); + assertEquals(url, spec.getUrl()); + } + + @Test + public void testCompressionAlgorithm() throws Exception { + CompressionAlgorithm compressionAlgorithm = CompressionAlgorithm.GZIP; + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + String url = "http://abc.com/123"; + + DownloadSpecification spec = new DownloadSpecification.Builder(cryptoStreamFactory, url) + .withCompressionAlgorithm(compressionAlgorithm) + .build(); + + assertEquals(compressionAlgorithm, spec.getCompressionAlgorithm()); + assertSame(cryptoStreamFactory, spec.getCryptoStreamFactory()); + assertEquals(url, spec.getUrl()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadHelperTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadHelperTest.java new file mode 100644 index 0000000..ae925b1 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadHelperTest.java @@ -0,0 +1,171 @@ +package com.amazon.spapi.documents; + +import com.amazon.spapi.documents.impl.AESCryptoStreamFactory; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.mockito.invocation.InvocationOnMock; +import org.mockito.stubbing.Answer; + +import java.io.ByteArrayInputStream; +import java.io.File; +import java.io.InputStream; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; + +import static org.junit.jupiter.api.Assertions.*; + +class UploadHelperTest { + private static String KEY = "sxx/wImF6BFndqSAz56O6vfiAh8iD9P297DHfFgujec="; + private static String VECTOR = "7S2tn363v0wfCfo1IX2Q1A=="; + + class FileCapture { + volatile boolean existed = false; + volatile File file = null; + } + + private Answer getAnswer(FileCapture fileCapture, Exception e) { + return new Answer() { + @Override + public Object answer(InvocationOnMock invocation) throws Throwable { + File tmpFile = (File)invocation.getArgument(2); + fileCapture.existed = tmpFile.exists(); + fileCapture.file = tmpFile; + + if (e != null) { + throw e; + } + + return null; + } + }; + } + + private Answer getAnswer(FileCapture fileCapture) { + return getAnswer(fileCapture, null); + } + + @Test + public void testSuccess() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "SPAPI.*\\.tmp$"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + + FileCapture fileCapture = new FileCapture(); + Mockito.doAnswer(getAnswer(fileCapture)).when(httpTransferClient) + .upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + + UploadHelper helper = new UploadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .build(); + + UploadSpecification spec = new UploadSpecification.Builder(contentType, cryptoStreamFactory, source, url) + .build(); + helper.upload(spec); + + assertTrue(fileCapture.file.getName().matches(expectedFileRegex)); + assertTrue(fileCapture.existed); + assertFalse(fileCapture.file.exists()); + + Mockito.verify(httpTransferClient).upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + } + + @Test + public void testSuccessWithCustomTmpFileParams() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "http://www.abc.com/123"; + String expectedFileRegex = "NOTSPAPI.*\\.NOTtmp$"; + String expectedFilePath = "spapitmp"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + + FileCapture fileCapture = new FileCapture(); + Mockito.doAnswer(getAnswer(fileCapture)).when(httpTransferClient) + .upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + + File tmpDir = new File(Paths.get(System.getProperty("java.io.tmpdir"), expectedFilePath) + .toAbsolutePath().toString()); + tmpDir.mkdirs(); + + UploadHelper helper = new UploadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .withTmpFilePrefix("NOTSPAPI") + .withTmpFileSuffix(".NOTtmp") + .withTmpFileDirectory(tmpDir) + .build(); + + UploadSpecification spec = new UploadSpecification.Builder(contentType, cryptoStreamFactory, source, url) + .build(); + helper.upload(spec); + + assertTrue(fileCapture.file.getName().matches(expectedFileRegex)); + assertEquals(expectedFilePath, fileCapture.file.getParentFile().getName()); + assertTrue(fileCapture.existed); + assertFalse(fileCapture.file.exists()); + + Mockito.verify(httpTransferClient).upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + } + + @Test + public void testFileDeletedOnFailure() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "http://www.abc.com/123"; + + HttpTransferClient httpTransferClient = Mockito.mock(HttpTransferClient.class); + + FileCapture fileCapture = new FileCapture(); + Mockito.doAnswer(getAnswer(fileCapture, new IllegalArgumentException())).when(httpTransferClient) + .upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + + UploadHelper helper = new UploadHelper.Builder() + .withHttpTransferClient(httpTransferClient) + .build(); + + UploadSpecification spec = new UploadSpecification.Builder(contentType, cryptoStreamFactory, source, url) + .build(); + assertThrows(IllegalArgumentException.class, () -> helper.upload(spec)); + + assertTrue(fileCapture.existed); + assertFalse(fileCapture.file.exists()); + + Mockito.verify(httpTransferClient).upload(Mockito.eq(url), Mockito.eq(contentType), Mockito.any()); + } + + @Test + public void testBadUrlFailedUpload() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "sdfkajsdfiefi"; + + Path path = Files.createTempDirectory("SPAPI"); + try { + UploadHelper helper = new UploadHelper.Builder() + .withTmpFileDirectory(path.toFile()) + .build(); + + UploadSpecification spec = new UploadSpecification.Builder(contentType, cryptoStreamFactory, source, url) + .build(); + assertThrows(IllegalArgumentException.class, () -> helper.upload(spec)); + } finally { + // This will throw if the directory is not empty, indicating that the temp file was not removed + Files.delete(path); + } + } + + @Test + public void testInvalidTmpFilePrefix() { + UploadHelper.Builder builder = new UploadHelper.Builder(); + + assertThrows(IllegalArgumentException.class, () -> builder + .withTmpFilePrefix("A")); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadSpecificationTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadSpecificationTest.java new file mode 100644 index 0000000..ff16734 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/UploadSpecificationTest.java @@ -0,0 +1,71 @@ +package com.amazon.spapi.documents; + +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import static org.junit.jupiter.api.Assertions.*; + +class UploadSpecificationTest { + @Test + public void testBuilderConstructorMissingContentType() throws Exception { + String contentType = null; + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "https://www.amazon.com"; + + assertThrows(IllegalArgumentException.class, () -> new UploadSpecification.Builder( + contentType, cryptoStreamFactory, source, url)); + } + + @Test + public void testBuilderConstructorMissingCryptoStreamFactory() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = null; + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "https://www.amazon.com"; + + assertThrows(IllegalArgumentException.class, () -> new UploadSpecification.Builder( + contentType, cryptoStreamFactory, source, url)); + } + + @Test + public void testBuilderConstructorMissingSource() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + InputStream source = null; + String url = "https://www.amazon.com"; + + assertThrows(IllegalArgumentException.class, () -> new UploadSpecification.Builder( + contentType, cryptoStreamFactory, source, url)); + } + + @Test + public void testBuilderConstructorMissingUrl() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = null; + + assertThrows(IllegalArgumentException.class, () -> new UploadSpecification.Builder( + contentType, cryptoStreamFactory, source, url)); + } + + @Test + public void testSuccess() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + CryptoStreamFactory cryptoStreamFactory = Mockito.mock(CryptoStreamFactory.class); + InputStream source = new ByteArrayInputStream(new byte[0]); + String url = "http://abc.com/123"; + + UploadSpecification spec = new UploadSpecification.Builder(contentType, cryptoStreamFactory, source, url) + .build(); + + assertEquals(contentType, spec.getContentType()); + assertSame(cryptoStreamFactory, spec.getCryptoStreamFactory()); + assertSame(source, spec.getSource()); + assertEquals(url, spec.getUrl()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/CryptoExceptionTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/CryptoExceptionTest.java new file mode 100644 index 0000000..dc35992 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/CryptoExceptionTest.java @@ -0,0 +1,15 @@ +package com.amazon.spapi.documents.exception; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class CryptoExceptionTest { + @Test + public void testConstructor() { + Throwable throwable = new RuntimeException(); + CryptoException exception = new CryptoException(throwable); + + assertSame(throwable, exception.getCause()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/HttpResponseExceptionTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/HttpResponseExceptionTest.java new file mode 100644 index 0000000..2dbd666 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/HttpResponseExceptionTest.java @@ -0,0 +1,54 @@ +package com.amazon.spapi.documents.exception; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class HttpResponseExceptionTest { + @Test + public void testConstructor() { + String message = "This is the message"; + String body = "This is the body"; + int code = 403; + String expectToString = "com.amazon.spapi.documents.exception.HttpResponseException: " + + "This is the message {code=403, body=This is the body}"; + + HttpResponseException exception = new HttpResponseException(message, body, code); + + assertEquals(message, exception.getMessage()); + assertEquals(body, exception.getBody()); + assertEquals(code, exception.getCode()); + assertEquals(expectToString, exception.toString()); + } + + @Test + public void testConstructorNullBody() { + String message = "This is the message"; + String body = null; + int code = 403; + String expectToString = "com.amazon.spapi.documents.exception.HttpResponseException: " + + "This is the message {code=403, body=null}"; + + HttpResponseException exception = new HttpResponseException(message, body, code); + + assertEquals(message, exception.getMessage()); + assertEquals(body, exception.getBody()); + assertEquals(code, exception.getCode()); + assertEquals(expectToString, exception.toString()); + } + + @Test + public void testConstructorCause() { + String message = "This is the message"; + Throwable cause = new RuntimeException(); + String body = "This is the body"; + int code = 403; + + HttpResponseException exception = new HttpResponseException(message, cause, body, code); + + assertEquals(message, exception.getMessage()); + assertSame(cause, exception.getCause()); + assertEquals(body, exception.getBody()); + assertEquals(code, exception.getCode()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/MissingCharsetExceptionTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/MissingCharsetExceptionTest.java new file mode 100644 index 0000000..ccf3a53 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/exception/MissingCharsetExceptionTest.java @@ -0,0 +1,15 @@ +package com.amazon.spapi.documents.exception; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class MissingCharsetExceptionTest { + @Test + public void testConstructor() { + String message = "This is the message"; + MissingCharsetException exception = new MissingCharsetException(message); + + assertEquals(message, exception.getMessage()); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactoryTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactoryTest.java new file mode 100644 index 0000000..0601230 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/AESCryptoStreamFactoryTest.java @@ -0,0 +1,69 @@ +package com.amazon.spapi.documents.impl; + +import com.amazon.spapi.documents.exception.CryptoException; +import com.google.common.io.ByteStreams; +import org.junit.jupiter.api.Test; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.Arrays; +import java.util.Base64; + +import static org.junit.jupiter.api.Assertions.*; + +class AESCryptoStreamFactoryTest { + private static String KEY = "sxx/wImF6BFndqSAz56O6vfiAh8iD9P297DHfFgujec="; + private static String VECTOR = "7S2tn363v0wfCfo1IX2Q1A=="; + + @Test + public void testBuilderConstructorMissingInitializationVector() { + String key = "DEF"; + String initializationVector = null; + + assertThrows(IllegalArgumentException.class, () -> + new AESCryptoStreamFactory.Builder(key, initializationVector)); + } + + @Test + public void testBuilderConstructorMissingKey() { + String key = null; + String initializationVector = "ABC"; + + assertThrows(IllegalArgumentException.class, () -> + new AESCryptoStreamFactory.Builder(key, initializationVector)); + } + + @Test + public void testBadKey() throws Exception { + byte[] decodedKey = Base64.getDecoder().decode(KEY); + String encodedKey = Base64.getEncoder().encodeToString( + Arrays.copyOfRange(decodedKey, 2, decodedKey.length-1)); + + AESCryptoStreamFactory aesCryptoStreamFactory = new AESCryptoStreamFactory.Builder(encodedKey, VECTOR).build(); + try (InputStream inputStream = new ByteArrayInputStream("Hello World!".getBytes(StandardCharsets.UTF_8))) { + assertThrows(CryptoException.class, () -> aesCryptoStreamFactory.newDecryptStream(inputStream)); + } + } + + @Test + public void testEncryptDecrypt() throws Exception { + String stringContent = "Hello World!"; + byte[] byteContent = stringContent.getBytes(StandardCharsets.UTF_8); + + AESCryptoStreamFactory aesCryptoStreamFactory = new AESCryptoStreamFactory.Builder(KEY, VECTOR).build(); + + try (InputStream encryptStream = + aesCryptoStreamFactory.newEncryptStream(new ByteArrayInputStream(byteContent))) { + byte[] encryptedContent = ByteStreams.toByteArray(encryptStream); + + try (InputStream decryptStream = + aesCryptoStreamFactory.newDecryptStream(new ByteArrayInputStream(encryptedContent))) { + byte[] decryptedContent = ByteStreams.toByteArray(decryptStream); + + assertArrayEquals(decryptedContent, byteContent); + assertFalse(Arrays.equals(encryptedContent, decryptedContent)); + } + } + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/OkHttpTransferClientTest.java b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/OkHttpTransferClientTest.java new file mode 100644 index 0000000..f18ed82 --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/java/com/amazon/spapi/documents/impl/OkHttpTransferClientTest.java @@ -0,0 +1,331 @@ +package com.amazon.spapi.documents.impl; + +import com.amazon.spapi.documents.exception.HttpResponseException; +import com.squareup.okhttp.Call; +import com.squareup.okhttp.OkHttpClient; +import com.squareup.okhttp.Request; +import com.squareup.okhttp.Response; +import com.squareup.okhttp.ResponseBody; +import okio.Buffer; +import org.apache.commons.io.IOUtils; +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; +import org.junit.platform.commons.util.ReflectionUtils; +import org.mockito.ArgumentCaptor; +import org.mockito.Mockito; + +import java.io.ByteArrayInputStream; +import java.io.File; +import java.io.FileInputStream; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.StringReader; +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.*; + +class OkHttpTransferClientTest { + + @Test + public void testDefaultBuilder() throws Exception { + OkHttpTransferClient helper = new OkHttpTransferClient.Builder().build(); + OkHttpClient client = (OkHttpClient)ReflectionUtils.tryToReadFieldValue(OkHttpTransferClient.class, + "client", helper).get(); + } + + @Test + public void testDownloadSuccess() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + String url = "https://www.s3-amazon.com/123"; + String content = "Hello world!"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Response response = Mockito.mock(Response.class); + Mockito.doReturn(response).when(call).execute(); + + Mockito.doReturn(contentType).when(response).header("Content-Type"); + + Mockito.doReturn(true).when(response).isSuccessful(); + + ResponseBody responseBody = Mockito.mock(ResponseBody.class); + Mockito.doReturn(responseBody).when(response).body(); + + Mockito.doReturn(new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8))) + .when(responseBody).byteStream(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + assertEquals(contentType, helper.download(url, tmpFile)); + assertTrue(IOUtils.contentEquals(new FileInputStream(tmpFile), + new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8)))); + } finally { + tmpFile.delete(); + } + + assertEquals(url, requestArg.getValue().urlString()); + assertEquals("GET", requestArg.getValue().method()); + Mockito.verify(responseBody).close(); + } + + @Test + public void testDownloadIOException() throws Exception { + String url = "https://www.s3-amazon.com/123"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Mockito.doThrow(new IOException()).when(call).execute(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + Assertions.assertThrows(IOException.class, () -> helper.download(url, tmpFile)); + } finally { + tmpFile.delete(); + } + } + + private void failureResponseMocks(Response response, ResponseBody responseBody, + int httpStatusCode, String message, String bodyContent) throws Exception { + Mockito.doReturn(httpStatusCode).when(response).code(); + Mockito.doReturn(message).when(response).message(); + + Mockito.doReturn(new StringReader(bodyContent)).when(responseBody) + .charStream(); + } + + @Test + public void testDownloadFailure() throws Exception { + String url = "https://www.s3-amazon.com/123"; + String responseBodyText = "This is the response body"; + int maxErrorBodyLen = 5; + int httpStatusCode = 403; + String message = "Forbidden"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Response response = Mockito.mock(Response.class); + Mockito.doReturn(response).when(call).execute(); + + ResponseBody responseBody = Mockito.mock(ResponseBody.class); + Mockito.doReturn(responseBody).when(response).body(); + Mockito.doNothing().when(responseBody).close(); + + failureResponseMocks(response, responseBody, httpStatusCode, message, responseBodyText); + + Mockito.doReturn(false).when(response).isSuccessful(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .withMaxErrorBodyLen(maxErrorBodyLen) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + helper.download(url, tmpFile); + fail("Expected exception"); + } catch(HttpResponseException e) { + assertEquals(httpStatusCode, e.getCode()); + assertEquals(message, e.getMessage()); + assertEquals("This ", e.getBody()); + } finally { + tmpFile.delete(); + } + + Mockito.verify(responseBody).close(); + } + + @Test + public void testFailureInBodyExtraction() throws Exception { + String url = "https://www.s3-amazon.com/123"; + int maxErrorBodyLen = 5; + int httpStatusCode = 403; + String message = "Forbidden"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Response response = Mockito.mock(Response.class); + Mockito.doReturn(response).when(call).execute(); + + ResponseBody responseBody = Mockito.mock(ResponseBody.class); + Mockito.doReturn(responseBody).when(response).body(); + Mockito.doNothing().when(responseBody).close(); + + Mockito.doReturn(httpStatusCode).when(response).code(); + Mockito.doReturn(message).when(response).message(); + + Mockito.doThrow(new IOException()).when(responseBody).charStream(); + + Mockito.doReturn(false).when(response).isSuccessful(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .withMaxErrorBodyLen(maxErrorBodyLen) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + helper.download(url, tmpFile); + fail("Expected exception"); + } catch(HttpResponseException e) { + assertEquals(httpStatusCode, e.getCode()); + assertEquals(message, e.getMessage()); + assertEquals("", e.getBody()); + } finally { + tmpFile.delete(); + } + + Mockito.verify(responseBody).close(); + } + + @Test + public void testUploadSuccess() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + String url = "https://www.s3-amazon.com/123"; + String content = "Hello world!"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Response response = Mockito.mock(Response.class); + Mockito.doReturn(response).when(call).execute(); + + Mockito.doReturn(true).when(response).isSuccessful(); + + ResponseBody responseBody = Mockito.mock(ResponseBody.class); + Mockito.doReturn(responseBody).when(response).body(); + Mockito.doNothing().when(responseBody).close(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + try (FileOutputStream fileOutputStream = new FileOutputStream(tmpFile)) { + fileOutputStream.write(content.getBytes(StandardCharsets.UTF_8)); + } + + helper.upload(url, contentType, tmpFile); + + Buffer buffer = new Buffer(); + requestArg.getValue().body().writeTo(buffer); + assertEquals(content, buffer.readString(StandardCharsets.UTF_8)); + + assertEquals(url, requestArg.getValue().urlString()); + assertEquals("PUT", requestArg.getValue().method()); + assertEquals(contentType, requestArg.getValue().body().contentType().toString()); + } finally { + tmpFile.delete(); + } + + Mockito.verify(responseBody).close(); + } + + @Test + public void testUploadIOException() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + String url = "https://www.s3-amazon.com/123"; + String content = "Hello world!"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Mockito.doThrow(new IOException()).when(call).execute(); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + try (FileOutputStream fileOutputStream = new FileOutputStream(tmpFile)) { + fileOutputStream.write(content.getBytes(StandardCharsets.UTF_8)); + } + + Assertions.assertThrows(IOException.class, () -> helper.upload(url, contentType, tmpFile)); + } finally { + tmpFile.delete(); + } + } + + @Test + public void testUploadFailure() throws Exception { + String contentType = "text/xml; charset=UTF-8"; + String url = "https://www.s3-amazon.com/123"; + String content = "Hello world!"; + + String responseBodyText = "This is the response body"; + int maxErrorBodyLen = 5; + int httpStatusCode = 403; + String message = "Forbidden"; + + OkHttpClient client = Mockito.mock(OkHttpClient.class); + Call call = Mockito.mock(Call.class); + + ArgumentCaptor requestArg = ArgumentCaptor.forClass(Request.class); + Mockito.doReturn(call).when(client).newCall(requestArg.capture()); + + Response response = Mockito.mock(Response.class); + Mockito.doReturn(response).when(call).execute(); + + Mockito.doReturn(false).when(response).isSuccessful(); + + ResponseBody responseBody = Mockito.mock(ResponseBody.class); + Mockito.doReturn(responseBody).when(response).body(); + Mockito.doNothing().when(responseBody).close(); + failureResponseMocks(response, responseBody, httpStatusCode, message, responseBodyText); + + OkHttpTransferClient helper = new OkHttpTransferClient.Builder() + .withClient(client) + .withMaxErrorBodyLen(maxErrorBodyLen) + .build(); + + File tmpFile = File.createTempFile("foo", null); + try { + try (FileOutputStream fileOutputStream = new FileOutputStream(tmpFile)) { + fileOutputStream.write(content.getBytes(StandardCharsets.UTF_8)); + } + + helper.upload(url, contentType, tmpFile); + fail("Expected exception"); + } catch(HttpResponseException e) { + assertEquals(httpStatusCode, e.getCode()); + assertEquals(message, e.getMessage()); + assertEquals("This ", e.getBody()); + } finally { + tmpFile.delete(); + } + + Mockito.verify(responseBody).close(); + } +} \ No newline at end of file diff --git a/clients/sellingpartner-api-documents-helper-java/src/test/resources/mockito-extensions/org.mockito.plugins.Mockmaker b/clients/sellingpartner-api-documents-helper-java/src/test/resources/mockito-extensions/org.mockito.plugins.Mockmaker new file mode 100644 index 0000000..ca6ee9c --- /dev/null +++ b/clients/sellingpartner-api-documents-helper-java/src/test/resources/mockito-extensions/org.mockito.plugins.Mockmaker @@ -0,0 +1 @@ +mock-maker-inline \ No newline at end of file