de.mklinger.qetch.client.impl

Class AbstractQetchClient

java.lang.Object

de.mklinger.qetch.client.impl.AbstractQetchClient

All Implemented Interfaces:

QetchClient, AutoCloseable

Direct Known Subclasses:

QetchClientImpl

public abstract class AbstractQetchClient
extends Object
implements QetchClient

Qetch client base class. This is the base class for all HTTP Qetch clients. Is has no knowledge about the underlying HTTP client implementation. It provides default implementations for some QetchClient methods and protected helper methods for subclasses, dealing with HTTP methods and service URIs.

Author:

Marc Klinger - mklinger[at]mklinger[dot]de

Nested Class Summary

Nested classes/interfaces inherited from interface de.mklinger.qetch.client.QetchClient

QetchClient.Builder

Constructor Summary

Constructors

Constructor and Description
AbstractQetchClient(ServiceUriSupplier serviceUriSupplier)

Method Summary

Modifier and Type	Method and Description
abstract void	close()
abstract CompletableFuture<Job>	createJob(InputJob inputJob)
CompletableFuture<Void>	deleteFile(ConversionFile file)
abstract CompletableFuture<Void>	deleteFile(String fileId)
CompletableFuture<Void>	deleteJob(Job job)
abstract CompletableFuture<Void>	deleteJob(String jobId)
CompletableFuture<File>	downloadAsFile(String fileId, File file)
CompletableFuture<Path>	downloadAsFile(String fileId, Path file)
abstract CompletableFuture<Path>	downloadAsFile(String fileId, Path file, OpenOption... openOptions)
CompletableFuture<Path>	downloadAsTempFile(String fileId)
CompletableFuture<Path>	downloadAsTempFile(String fileId, Path dir)
abstract CompletableFuture<List<AvailableConversion>>	getAvailableConversions()
abstract CompletableFuture<List<AvailableNode>>	getAvailableNodes()
protected URI	getAvailableNodesUri()
protected URI	getConversionsUri()
protected String	getCreateJobForExistingFileMethod()
protected URI	getCreateJobForExistingFileUri()
protected String	getCreateJobForNewFileMethod()
protected URI	getCreateJobForNewFileUri()
CompletableFuture<ConversionFile>	getFile(ConversionFile file)
abstract CompletableFuture<ConversionFile>	getFile(String fileId)
protected URI	getFileContentsUri(String fileId)
abstract CompletableFuture<List<ConversionFile>>	getFiles()
protected URI	getFilesUri()
protected String	getFileUploadMethod()
protected URI	getFileUploadUri()
protected URI	getFileUri(String fileId)
CompletableFuture<Job>	getJob(Job job)
abstract CompletableFuture<Job>	getJob(String jobId)
CompletableFuture<Job>	getJobDone(Job job)
CompletableFuture<Job>	getJobDone(String jobId)
abstract CompletableFuture<List<Job>>	getJobs()
protected URI	getJobsUri()
protected URI	getJobUri(String jobId)
ServiceUriSupplier	getServiceUriSupplier()
protected void	requireSuccessStatusCode(int statusCode, Optional<String> contentType, Optional<byte[]> responseBody)
protected <T> T	transformResponse(int statusCode, Optional<String> contentType, byte[] responseBody, Class<T> type)
abstract CompletableFuture<ConversionFile>	uploadFile(InputConversionFile inputFile)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractQetchClient

public AbstractQetchClient(ServiceUriSupplier serviceUriSupplier)

Method Detail

getServiceUriSupplier

public ServiceUriSupplier getServiceUriSupplier()

close

public abstract void close()

Specified by:

close in interface QetchClient

Specified by:

close in interface AutoCloseable

uploadFile

public abstract CompletableFuture<ConversionFile> uploadFile(InputConversionFile inputFile)

Specified by:

uploadFile in interface QetchClient

getFile

public abstract CompletableFuture<ConversionFile> getFile(String fileId)

Specified by:

getFile in interface QetchClient

getFiles

public abstract CompletableFuture<List<ConversionFile>> getFiles()

Specified by:

getFiles in interface QetchClient

deleteFile

public abstract CompletableFuture<Void> deleteFile(String fileId)

Specified by:

deleteFile in interface QetchClient

downloadAsFile

public abstract CompletableFuture<Path> downloadAsFile(String fileId,
                                                       Path file,
                                                       OpenOption... openOptions)

Specified by:

downloadAsFile in interface QetchClient

createJob

public abstract CompletableFuture<Job> createJob(InputJob inputJob)

Specified by:

createJob in interface QetchClient

getJob

public abstract CompletableFuture<Job> getJob(String jobId)

Specified by:

getJob in interface QetchClient

getJobs

public abstract CompletableFuture<List<Job>> getJobs()

Specified by:

getJobs in interface QetchClient

deleteJob

public abstract CompletableFuture<Void> deleteJob(String jobId)

Specified by:

deleteJob in interface QetchClient

getAvailableConversions

public abstract CompletableFuture<List<AvailableConversion>> getAvailableConversions()

Specified by:

getAvailableConversions in interface QetchClient

getAvailableNodes

public abstract CompletableFuture<List<AvailableNode>> getAvailableNodes()

Specified by:

getAvailableNodes in interface QetchClient

getFile

public CompletableFuture<ConversionFile> getFile(ConversionFile file)

Specified by:

getFile in interface QetchClient

deleteFile

public CompletableFuture<Void> deleteFile(ConversionFile file)

Specified by:

deleteFile in interface QetchClient

downloadAsFile

public CompletableFuture<Path> downloadAsFile(String fileId,
                                              Path file)

Specified by:

downloadAsFile in interface QetchClient

downloadAsFile

public CompletableFuture<File> downloadAsFile(String fileId,
                                              File file)

Specified by:

downloadAsFile in interface QetchClient

downloadAsTempFile

public CompletableFuture<Path> downloadAsTempFile(String fileId)

Specified by:

downloadAsTempFile in interface QetchClient

downloadAsTempFile

public CompletableFuture<Path> downloadAsTempFile(String fileId,
                                                  Path dir)

Specified by:

downloadAsTempFile in interface QetchClient

getJob

public CompletableFuture<Job> getJob(Job job)

Specified by:

getJob in interface QetchClient

deleteJob

public CompletableFuture<Void> deleteJob(Job job)

Specified by:

deleteJob in interface QetchClient

getJobDone

public CompletableFuture<Job> getJobDone(Job job)

Specified by:

getJobDone in interface QetchClient

getJobDone

public CompletableFuture<Job> getJobDone(String jobId)

Specified by:

getJobDone in interface QetchClient

getFileUploadUri

protected URI getFileUploadUri()

getFileUploadMethod

protected String getFileUploadMethod()

getFileUri

protected URI getFileUri(String fileId)

getFileContentsUri

protected URI getFileContentsUri(String fileId)

getFilesUri

protected URI getFilesUri()

getCreateJobForExistingFileUri

protected URI getCreateJobForExistingFileUri()

getCreateJobForExistingFileMethod

protected String getCreateJobForExistingFileMethod()

getCreateJobForNewFileUri

protected URI getCreateJobForNewFileUri()

getCreateJobForNewFileMethod

protected String getCreateJobForNewFileMethod()

getJobUri

protected URI getJobUri(String jobId)

getJobsUri

protected URI getJobsUri()

getConversionsUri

protected URI getConversionsUri()

getAvailableNodesUri

protected URI getAvailableNodesUri()

transformResponse

protected <T> T transformResponse(int statusCode,
                                  Optional<String> contentType,
                                  byte[] responseBody,
                                  Class<T> type)

requireSuccessStatusCode

protected void requireSuccessStatusCode(int statusCode,
                                        Optional<String> contentType,
                                        Optional<byte[]> responseBody)