Package net.webpdf.wsclient.session.rest.documents

Interface DocumentManager<T_REST_DOCUMENT extends RestDocument>

Type Parameters:

T_REST_DOCUMENT - The RestDocument type managed by the DocumentManager.

All Known Implementing Classes:

AbstractDocumentManager, RestWebServiceDocumentManager

public interface DocumentManager<T_REST_DOCUMENT extends RestDocument>

A class implementing DocumentManager allows to monitor and interact with the RestDocuments uploaded to a RestSession of the webPDF server.

Method Summary

Modifier and Type	Method	Description
boolean	containsDocument(@NotNull String documentId)	Returns true, if this DocumentManager contains a RestDocument with the given ID.
void	deleteDocument(@NotNull String documentId)	Deletes the RestDocument with the given document ID from the webPDF server.
void	downloadDocument(@NotNull String documentId, @NotNull OutputStream outputStream)	Downloads the RestDocument with the given document ID and writes it to the given OutputStream.
void	downloadDocument(@Nullable RestDocument document, @NotNull OutputStream outputStream)	Downloads the RestDocument and writes it to the given OutputStream.
T_REST_DOCUMENT	getDocument(@NotNull String documentId)	Returns the RestDocument that is known to the DocumentManager for the given document ID.
@NotNull List<HistoryEntry>	getDocumentHistory(@NotNull String documentId)	Returns the HistoryEntrys known for the RestDocument with the given document ID.
@NotNull HistoryEntry	getDocumentHistoryEntry(@NotNull String documentId, int historyId)	Returns the HistoryEntry with the given history ID for the RestDocument with the given document ID.
@NotNull String	getDocumentID(@NotNull DocumentFile document)	Returns the document ID the given DocumentFile is known by to this DocumentManager.
@NotNull List<T_REST_DOCUMENT>	getDocuments()	Returns a list of all RestDocuments known to this DocumentManager.
@NotNull RestSession<T_REST_DOCUMENT>	getSession()	Returns the RestSession the DocumentManager is managing RestDocuments for.
boolean	isDocumentHistoryActive()	Checks whether a document history is collected for managed RestDocuments.
T_REST_DOCUMENT	renameDocument(@NotNull String documentId, @NotNull String fileName)	Rename the RestDocument with the given document ID.
void	setDocumentHistoryActive(boolean documentHistoryActive)	Sets whether a document history shall be collected for managed RestDocuments.
@NotNull List<T_REST_DOCUMENT>	synchronize()	Synchronizes the RestDocuments of this DocumentManager with the actually uploaded documents of the webPDF server.
T_REST_DOCUMENT	synchronize(@NotNull DocumentFile documentFile)	Synchronizes the given DocumentFile with the matching RestDocument managed by this DocumentManager.
@Nullable HistoryEntry	updateDocumentHistory(@NotNull String documentId, @NotNull HistoryEntry historyEntry)	Updates the history of the RestDocument with the given document ID using the given HistoryEntry.
T_REST_DOCUMENT	uploadDocument(@NotNull File file)	Uploads the given File to the webPDF server, adds it to this DocumentManager and returns the resulting RestDocument handle.
T_REST_DOCUMENT	uploadDocument(@NotNull InputStream data, @NotNull String fileName)	Uploads the given InputStream to the webPDF server as a document resource with the given file name, adds it to this DocumentManager and returns the resulting RestDocument handle.

Method Detail

getSession

@NotNull
@NotNull RestSession<T_REST_DOCUMENT> getSession()

Returns the RestSession the DocumentManager is managing RestDocuments for.

Returns:

The RestSession the DocumentManager is managing RestDocuments for.

synchronize

@NotNull
T_REST_DOCUMENT synchronize(@NotNull
                            @NotNull DocumentFile documentFile)
                     throws ResultException

Synchronizes the given DocumentFile with the matching RestDocument managed by this DocumentManager.

Returns:

The synchronized RestDocument.

Throws:

ResultException - Shall be thrown upon a synchronization failure.

synchronize

@NotNull
@NotNull List<T_REST_DOCUMENT> synchronize()
                                    throws ResultException

Synchronizes the RestDocuments of this DocumentManager with the actually uploaded documents of the webPDF server.

Returns:

A list of the synchronized RestDocuments.

Throws:

ResultException - Shall be thrown upon a synchronization failure.

getDocumentID

@NotNull
@NotNull String getDocumentID(@NotNull
                              @NotNull DocumentFile document)
                       throws ResultException

Returns the document ID the given DocumentFile is known by to this DocumentManager.

Parameters:

document - The DocumentFile a document ID shall be found for.

Returns:

The document ID mapped to the given DocumentFile.

Throws:

ResultException - Shall be thrown, if requesting the document ID failed.

getDocument

@NotNull
T_REST_DOCUMENT getDocument(@NotNull
                            @NotNull String documentId)
                     throws ResultException

Returns the RestDocument that is known to the DocumentManager for the given document ID.

Parameters:

documentId - The document ID a RestDocument shall be found for.

Returns:

The RestDocument mapped to the given document ID.

Throws:

ResultException - Shall be thrown, if requesting the document failed.

getDocuments

@NotNull
@NotNull List<T_REST_DOCUMENT> getDocuments()

Returns a list of all RestDocuments known to this DocumentManager.

Returns:

A list of all RestDocuments known to this DocumentManager.

containsDocument

boolean containsDocument(@NotNull
                         @NotNull String documentId)

Returns true, if this DocumentManager contains a RestDocument with the given ID.

Parameters:

documentId - The document ID, that shall be checked for existence.

Returns:

true, if this DocumentManager contains a RestDocument with the given ID.

downloadDocument

void downloadDocument(@NotNull
                      @NotNull String documentId,
                      @NotNull
                      @NotNull OutputStream outputStream)
               throws ResultException

Downloads the RestDocument with the given document ID and writes it to the given OutputStream.

Parameters:

documentId - The document ID of the RestDocument to download.

outputStream - The OutputStream to write the downloaded RestDocument to.

Throws:

ResultException - Shall be thrown, should the download have failed.

downloadDocument

void downloadDocument(@Nullable
                      @Nullable RestDocument document,
                      @NotNull
                      @NotNull OutputStream outputStream)
               throws ResultException

Downloads the RestDocument and writes it to the given OutputStream.

Parameters:

document - The RestDocument to download.

outputStream - The OutputStream to write the downloaded RestDocument to.

Throws:

ResultException - Shall be thrown, should the download have failed.

uploadDocument

@NotNull
T_REST_DOCUMENT uploadDocument(@NotNull
                               @NotNull File file)
                        throws ResultException

Uploads the given File to the webPDF server, adds it to this DocumentManager and returns the resulting RestDocument handle.

Parameters:

file - The File to upload.

Returns:

The resulting RestDocument handle.

Throws:

ResultException - Shall be thrown, should the upload have failed.

uploadDocument

@NotNull
T_REST_DOCUMENT uploadDocument(@NotNull
                               @NotNull InputStream data,
                               @NotNull
                               @NotNull String fileName)
                        throws ResultException

Uploads the given InputStream to the webPDF server as a document resource with the given file name, adds it to this DocumentManager and returns the resulting RestDocument handle.

Parameters:

data - The document InputStream to upload.

fileName - The name of the uploaded document.

Returns:

The resulting RestDocument handle.

Throws:

ResultException - Shall be thrown, should the upload have failed.

deleteDocument

void deleteDocument(@NotNull
                    @NotNull String documentId)
             throws ResultException

Deletes the RestDocument with the given document ID from the webPDF server.

Parameters:

documentId - The document ID of the RestDocument to delete.

Throws:

ResultException - Shall be thrown, should deleting the document have failed.

renameDocument

@NotNull
T_REST_DOCUMENT renameDocument(@NotNull
                               @NotNull String documentId,
                               @NotNull
                               @NotNull String fileName)
                        throws ResultException

Rename the RestDocument with the given document ID.

Parameters:

documentId - The document ID of the RestDocument to rename.

fileName - The new name for the RestDocument.

Returns:

The resulting RestDocument handle.

Throws:

ResultException - Shall be thrown, should renaming the document have failed.

isDocumentHistoryActive

boolean isDocumentHistoryActive()

Checks whether a document history is collected for managed RestDocuments.

Returns:

true should collecting the document history be active.

setDocumentHistoryActive

void setDocumentHistoryActive(boolean documentHistoryActive)
                       throws ResultException

Sets whether a document history shall be collected for managed RestDocuments.

Parameters:

documentHistoryActive - true should collecting the document history be activated.

Throws:

ResultException

getDocumentHistory

@NotNull
@NotNull List<HistoryEntry> getDocumentHistory(@NotNull
                                               @NotNull String documentId)
                                        throws ResultException

Returns the HistoryEntrys known for the RestDocument with the given document ID.

Parameters:

documentId - The document ID of the RestDocument the history shall be requested for.

Returns:

The HistoryEntrys known for the selected RestDocument.

Throws:

ResultException - Shall be thrown, should requesting the document history have failed.

getDocumentHistoryEntry

@NotNull
@NotNull HistoryEntry getDocumentHistoryEntry(@NotNull
                                              @NotNull String documentId,
                                              int historyId)
                                       throws ResultException

Returns the HistoryEntry with the given history ID for the RestDocument with the given document ID.

Parameters:

documentId - The document ID of the RestDocument the HistoryEntry shall be requested for.

historyId - The history ID of the HistoryEntry, that shall be requested.

Returns:

The selected HistoryEntry.

Throws:

ResultException - Shall be thrown, should requesting the document history have failed.

updateDocumentHistory

@Nullable
@Nullable HistoryEntry updateDocumentHistory(@NotNull
                                             @NotNull String documentId,
                                             @NotNull
                                             @NotNull HistoryEntry historyEntry)
                                      throws ResultException

Updates the history of the RestDocument with the given document ID using the given HistoryEntry.

Parameters:

documentId - The document ID of the RestDocument to update.

historyEntry - The HistoryEntry to update the contained values for.

Returns:

The updated HistoryEntry.

Throws:

ResultException - Shall be thrown, should updating the document history have failed.