Package org.bonitasoft.engine.core.document.api.impl

Class DocumentServiceImpl

java.lang.Object

org.bonitasoft.engine.core.document.api.impl.DocumentServiceImpl

All Implemented Interfaces:

DocumentService

public class DocumentServiceImpl
extends Object
implements DocumentService

Author:

Nicolas Chabanoles, Matthieu Chaffotte, Celine Souchet, Baptiste Mesta

Field Summary

Fields inherited from interface org.bonitasoft.engine.core.document.api.DocumentService

DOCUMENT, DOCUMENTMAPPING, SUPERVISED_BY

Constructor Summary

Constructors

Constructor	Description
DocumentServiceImpl(Recorder recorder, ReadPersistenceService persistenceService, SDocumentDownloadURLProvider urlProvider, ArchiveService archiveService)

Method Summary

Modifier and Type	Method	Description
void	archive(AbstractSDocumentMapping docMapping, long archiveDate)	archive the specific document mapping in the archive date
SMappedDocument	attachDocumentToProcessInstance(SDocument document, long processInstanceId, String name, String description)	Save a document
SMappedDocument	attachDocumentToProcessInstance(SDocument document, long processInstanceId, String name, String description, int index)	Save a document
void	deleteArchivedDocuments(List<Long> processInstanceIds)	delete archived documents mapping and documents links to a set of processes
void	deleteContentOfArchivedDocument(long archivedDocumentId)	Remove the content of an archived document while keeping it's metadata.
void	deleteDocument(long documentId)	Delete a document by its id.
void	deleteDocument(SLightDocument document)	Delete the given document.
void	deleteDocumentContentsForProcessInstance(Long processInstanceId)	Delete the document content of a process instance.
void	deleteDocumentsFromProcessInstance(Long processInstanceId)	Delete documents and their associated mappings to a specified process instance.
void	deleteMappedDocument(AbstractSMappedDocument mappedDocument)	Delete the given document mapping without removing the document content.
String	generateDocumentURL(String name, String contentStorageId)
SAMappedDocument	getArchivedDocument(long archivedProcessDocumentId)	Retrieve an archived document
SAMappedDocument	getArchivedVersionOfProcessDocument(long documentId)	Get the archived version corresponding to a document
SLightDocument	getDocument(long documentId)	Get document by its id
byte[]	getDocumentContent(String documentId)	Get document content by document id
List<SMappedDocument>	getDocumentList(String documentName, long processInstanceId, int fromIndex, int numberOfResult)	Get a list of document.
List<AbstractSMappedDocument>	getDocumentList(String documentName, long processInstanceId, long time)	Get a list of document at a given time.
List<SMappedDocument>	getDocumentsOfProcessInstance(long processInstanceId, int fromIndex, int numberPerPage, String field, OrderByType order)	Get a list of documents for specific process instance, this can be used for pagination
SMappedDocument	getMappedDocument(long mappingId)	Get document with mapping by its mapping id
SMappedDocument	getMappedDocument(long processInstanceId, String documentName)	Get document with mapping by its name in the specific process instance
AbstractSMappedDocument	getMappedDocument(long processInstanceId, String documentName, long time)	Get name specified document archived in a certain time in the process instance
long	getNumberOfArchivedDocuments(QueryOptions queryOptions)	Get total number of archived documents according to the query criteria
long	getNumberOfArchivedDocumentsSupervisedBy(long userId, QueryOptions queryOptions)	Get total number of archived documents for the specific supervisor
long	getNumberOfDocuments(QueryOptions queryOptions)	Get total number of document according to the query criteria
long	getNumberOfDocumentsOfProcessInstance(long processInstanceId)	Get total number of documents in the specific process instance
long	getNumberOfDocumentsSupervisedBy(long userId, QueryOptions queryOptions)	Get total number of documents for the specific supervisor
void	removeCurrentVersion(long processInstanceId, String documentName)	Remove the document with the specified process instance and name.
void	removeCurrentVersion(AbstractSMappedDocument document)	Remove this document.
List<SAMappedDocument>	searchArchivedDocuments(QueryOptions queryOptions)	Search all archived documents according to the query criteria.
List<SAMappedDocument>	searchArchivedDocumentsSupervisedBy(long userId, QueryOptions queryOptions)	Search all archived documents for the specific supervisor
List<SMappedDocument>	searchDocuments(QueryOptions queryOptions)	Search all documents according to the query criteria
List<SMappedDocument>	searchDocumentsSupervisedBy(long userId, QueryOptions queryOptions)	Search all documents for the specific supervisor
SMappedDocument	updateDocument(long documentId, SDocument sDocument)	update the document having the documentId with this new version
SMappedDocument	updateDocument(AbstractSDocumentMapping documentToUpdate, SDocument sDocument)
void	updateDocumentIndex(AbstractSDocumentMapping mappedDocument, int index)	update the index of a document inside the list
void	updateDocumentOfList(AbstractSDocumentMapping mappedDocument, SDocument document, int index)

Methods inherited from class java.lang.Object

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

Constructor Details

DocumentServiceImpl

public DocumentServiceImpl(Recorder recorder,
 ReadPersistenceService persistenceService,
 SDocumentDownloadURLProvider urlProvider,
 ArchiveService archiveService)

Method Details

attachDocumentToProcessInstance

public SMappedDocument attachDocumentToProcessInstance(SDocument document,
 long processInstanceId,
 String name,
 String description)
                                                throws SObjectCreationException

Description copied from interface: DocumentService

Save a document

Specified by:

attachDocumentToProcessInstance in interface DocumentService

Parameters:

document - the document to store

processInstanceId - the process instance id to attach the document to

Returns:

The document image from database

Throws:

SObjectCreationException - when the storage has failed

attachDocumentToProcessInstance

public SMappedDocument attachDocumentToProcessInstance(SDocument document,
 long processInstanceId,
 String name,
 String description,
 int index)
                                                throws SObjectCreationException,
SObjectAlreadyExistsException

Description copied from interface: DocumentService

Save a document

Specified by:

attachDocumentToProcessInstance in interface DocumentService

Parameters:

document - the document to store

processInstanceId - the process instance id to attach the document to

index - the index in the list of document

Returns:

The document image from database

Throws:

SObjectCreationException - when the storage has failed

SObjectAlreadyExistsException

updateDocumentOfList

public void updateDocumentOfList(AbstractSDocumentMapping mappedDocument,
 SDocument document,
 int index)
                          throws SObjectModificationException

Specified by:

updateDocumentOfList in interface DocumentService

Parameters:

mappedDocument - the document to update

document - the new content

index - the new index

Throws:

SObjectModificationException

updateDocumentIndex

public void updateDocumentIndex(AbstractSDocumentMapping mappedDocument,
 int index)
                         throws SObjectModificationException

Description copied from interface: DocumentService

update the index of a document inside the list

Specified by:

updateDocumentIndex in interface DocumentService

Parameters:

mappedDocument - the document to update

index - the new index

Throws:

SObjectModificationException

deleteDocumentsFromProcessInstance

public void deleteDocumentsFromProcessInstance(Long processInstanceId)
                                        throws SBonitaReadException,
SObjectModificationException,
SObjectNotFoundException

Description copied from interface: DocumentService

Delete documents and their associated mappings to a specified process instance.

Specified by:

deleteDocumentsFromProcessInstance in interface DocumentService

Parameters:

processInstanceId - the id of the process instance to delete documents from

Throws:

SBonitaReadException - if an error occurred while getting the documents or their mappings

SObjectModificationException - if an error occurred during the deletion

SObjectNotFoundException - if an element does not exist

deleteDocumentContentsForProcessInstance

public void deleteDocumentContentsForProcessInstance(Long processInstanceId)
                                              throws SBonitaReadException,
SObjectModificationException,
SObjectNotFoundException

Description copied from interface: DocumentService

Delete the document content of a process instance. It only deletes the content, not the document mapping. Note that to reach the document content, the document mapping must still exist at the time of call: indeed, this is the only way to reach the content from the process instance. So if you need to call this method and also delete the document mappings, ensure this method is called first.

Specified by:

deleteDocumentContentsForProcessInstance in interface DocumentService

Parameters:

processInstanceId - the process instance id to delete the document contents from

Throws:

SBonitaReadException

SObjectModificationException

SObjectNotFoundException

generateDocumentURL

public String generateDocumentURL(String name,
 String contentStorageId)

Specified by:

generateDocumentURL in interface DocumentService

getArchivedDocument

public SAMappedDocument getArchivedDocument(long archivedProcessDocumentId)
                                     throws SObjectNotFoundException

Description copied from interface: DocumentService

Retrieve an archived document

Specified by:

getArchivedDocument in interface DocumentService

Parameters:

archivedProcessDocumentId - the id of the archived document

Returns:

the corresponding archive

Throws:

SObjectNotFoundException - when the archive does not exist

getArchivedVersionOfProcessDocument

public SAMappedDocument getArchivedVersionOfProcessDocument(long documentId)
                                                     throws SObjectNotFoundException

Description copied from interface: DocumentService

Get the archived version corresponding to a document

Specified by:

getArchivedVersionOfProcessDocument in interface DocumentService

Parameters:

documentId - identifier of process document

Returns:

the archive of the corresponding document

Throws:

SObjectNotFoundException - when the document does not exist

getDocument

public SLightDocument getDocument(long documentId)
                           throws SObjectNotFoundException,
SBonitaReadException

Description copied from interface: DocumentService

Get document by its id

Specified by:

getDocument in interface DocumentService

Parameters:

documentId - identifier of document

Returns:

an SDocumentMapping object with id corresponding to the parameter

Throws:

SObjectNotFoundException

SBonitaReadException

getMappedDocument

public SMappedDocument getMappedDocument(long processInstanceId,
 String documentName)
                                  throws SObjectNotFoundException,
SBonitaReadException

Description copied from interface: DocumentService

Get document with mapping by its name in the specific process instance

Specified by:

getMappedDocument in interface DocumentService

Parameters:

processInstanceId - identifier of process instance

documentName - name of process document

Returns:

the corresponding SDocumentMapping object

Throws:

SObjectNotFoundException

SBonitaReadException

getMappedDocument

public AbstractSMappedDocument getMappedDocument(long processInstanceId,
 String documentName,
 long time)
                                          throws SObjectNotFoundException,
SBonitaReadException

Description copied from interface: DocumentService

Get name specified document archived in a certain time in the process instance

Specified by:

getMappedDocument in interface DocumentService

Parameters:

processInstanceId - identifier of process instance

documentName - name of document

time - the archived time of document

Returns:

an SDocumentMapping object archived in the specific time or not archived

Throws:

SObjectNotFoundException

SBonitaReadException

getDocumentContent

public byte[] getDocumentContent(String documentId)
                          throws SObjectNotFoundException

Description copied from interface: DocumentService

Get document content by document id

Specified by:

getDocumentContent in interface DocumentService

Parameters:

documentId - identifier of the document

Returns:

document content

Throws:

SObjectNotFoundException

getMappedDocument

public SMappedDocument getMappedDocument(long mappingId)
                                  throws SObjectNotFoundException,
SBonitaReadException

Description copied from interface: DocumentService

Get document with mapping by its mapping id

Specified by:

getMappedDocument in interface DocumentService

Parameters:

mappingId - identifier of the mapping of the document

Returns:

an SDocumentMapping object with id corresponding to the parameter

Throws:

SObjectNotFoundException

SBonitaReadException

getDocumentsOfProcessInstance

public List<SMappedDocument> getDocumentsOfProcessInstance(long processInstanceId,
 int fromIndex,
 int numberPerPage,
 String field,
 OrderByType order)
                                                    throws SBonitaReadException

Description copied from interface: DocumentService

Get a list of documents for specific process instance, this can be used for pagination

Specified by:

getDocumentsOfProcessInstance in interface DocumentService

Parameters:

processInstanceId - identifier of process instance

fromIndex - Index of the record to be retrieved from. First record has index 0

numberPerPage - Number of result we want to get. Maximum number of result returned

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

getNumberOfArchivedDocuments

public long getNumberOfArchivedDocuments(QueryOptions queryOptions)
                                  throws SBonitaReadException

Description copied from interface: DocumentService

Get total number of archived documents according to the query criteria

Specified by:

getNumberOfArchivedDocuments in interface DocumentService

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of archived documents

Throws:

SBonitaReadException

getNumberOfArchivedDocumentsSupervisedBy

public long getNumberOfArchivedDocumentsSupervisedBy(long userId,
 QueryOptions queryOptions)
                                              throws SBonitaReadException

Description copied from interface: DocumentService

Get total number of archived documents for the specific supervisor

Specified by:

getNumberOfArchivedDocumentsSupervisedBy in interface DocumentService

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of archived documents for the specific supervisor

Throws:

SBonitaReadException

getNumberOfDocuments

public long getNumberOfDocuments(QueryOptions queryOptions)
                          throws SBonitaReadException

Description copied from interface: DocumentService

Get total number of document according to the query criteria

Specified by:

getNumberOfDocuments in interface DocumentService

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of document satisfied to the query criteria

Throws:

SBonitaReadException

getNumberOfDocumentsOfProcessInstance

public long getNumberOfDocumentsOfProcessInstance(long processInstanceId)
                                           throws SBonitaReadException

Description copied from interface: DocumentService

Get total number of documents in the specific process instance

Specified by:

getNumberOfDocumentsOfProcessInstance in interface DocumentService

Parameters:

processInstanceId - identifier of process instance

Returns:

number of documents in the process instance

Throws:

SBonitaReadException

getNumberOfDocumentsSupervisedBy

public long getNumberOfDocumentsSupervisedBy(long userId,
 QueryOptions queryOptions)
                                      throws SBonitaReadException

Description copied from interface: DocumentService

Get total number of documents for the specific supervisor

Specified by:

getNumberOfDocumentsSupervisedBy in interface DocumentService

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

number of documents for the specific supervisor

Throws:

SBonitaReadException

removeCurrentVersion

public void removeCurrentVersion(AbstractSMappedDocument document)
                          throws SObjectModificationException

Description copied from interface: DocumentService

Remove this document.

This archives and deletes mapping to the process, i.e. the content of the document itself will be kept in database, use DocumentService.deleteContentOfArchivedDocument(long) to delete the content.

Specified by:

removeCurrentVersion in interface DocumentService

Parameters:

document - the document mapping to remove

Throws:

SObjectModificationException

removeCurrentVersion

public void removeCurrentVersion(long processInstanceId,
 String documentName)
                          throws SObjectNotFoundException,
SObjectModificationException

Description copied from interface: DocumentService

Remove the document with the specified process instance and name.

This archives and deletes mapping to the process, i.e. the content of the document itself will be kept in database, use DocumentService.deleteContentOfArchivedDocument(long) to delete the content.

Specified by:

removeCurrentVersion in interface DocumentService

Parameters:

processInstanceId - id of the process having the document

documentName - name of the document

Throws:

SObjectNotFoundException

SObjectModificationException

deleteDocument

public void deleteDocument(long documentId)
                    throws SObjectNotFoundException,
SBonitaReadException,
SObjectModificationException

Description copied from interface: DocumentService

Delete a document by its id. It does not delete potential mappings, which might throw an error if they are not deleted beforehand.

Specified by:

deleteDocument in interface DocumentService

Parameters:

documentId - the id of the document to delete

Throws:

SObjectNotFoundException - if the document to delete does not exist

SBonitaReadException - if an error occurred while getting the document

SObjectModificationException - if an error occurred during the deletion

deleteDocument

public void deleteDocument(SLightDocument document)
                    throws SObjectModificationException

Description copied from interface: DocumentService

Delete the given document. It does not delete potential mappings, which might throw an error if they are not deleted beforehand.

Specified by:

deleteDocument in interface DocumentService

Parameters:

document - the document to delete

Throws:

SObjectModificationException - if an error occurred during the deletion

deleteMappedDocument

public void deleteMappedDocument(AbstractSMappedDocument mappedDocument)
                          throws SObjectModificationException

Description copied from interface: DocumentService

Delete the given document mapping without removing the document content.

Specified by:

deleteMappedDocument in interface DocumentService

Parameters:

mappedDocument - the document mapping to delete

Throws:

SObjectModificationException - if an error occurred during the deletion

searchArchivedDocuments

public List<SAMappedDocument> searchArchivedDocuments(QueryOptions queryOptions)
                                               throws SBonitaReadException

Description copied from interface: DocumentService

Search all archived documents according to the query criteria.

Specified by:

searchArchivedDocuments in interface DocumentService

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SADocumentMapping objects

Throws:

SBonitaReadException

searchArchivedDocumentsSupervisedBy

public List<SAMappedDocument> searchArchivedDocumentsSupervisedBy(long userId,
 QueryOptions queryOptions)
                                                           throws SBonitaReadException

Description copied from interface: DocumentService

Search all archived documents for the specific supervisor

Specified by:

searchArchivedDocumentsSupervisedBy in interface DocumentService

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SADocumentMapping objects

Throws:

SBonitaReadException

searchDocuments

public List<SMappedDocument> searchDocuments(QueryOptions queryOptions)
                                      throws SBonitaReadException

Description copied from interface: DocumentService

Search all documents according to the query criteria

Specified by:

searchDocuments in interface DocumentService

Parameters:

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

searchDocumentsSupervisedBy

public List<SMappedDocument> searchDocumentsSupervisedBy(long userId,
 QueryOptions queryOptions)
                                                  throws SBonitaReadException

Description copied from interface: DocumentService

Search all documents for the specific supervisor

Specified by:

searchDocumentsSupervisedBy in interface DocumentService

Parameters:

userId - identifier of supervisor user

queryOptions - a QueryOptions object containing some query conditions

Returns:

a list of SDocumentMapping objects

Throws:

SBonitaReadException

deleteArchivedDocuments

public void deleteArchivedDocuments(List<Long> processInstanceIds)
                             throws SBonitaReadException,
SRecorderException

Description copied from interface: DocumentService

delete archived documents mapping and documents links to a set of processes

Specified by:

deleteArchivedDocuments in interface DocumentService

Parameters:

processInstanceIds - ids of the source process instances

Throws:

SBonitaReadException

SRecorderException

archive

public void archive(AbstractSDocumentMapping docMapping,
 long archiveDate)
             throws SObjectModificationException

Description copied from interface: DocumentService

archive the specific document mapping in the archive date

Specified by:

archive in interface DocumentService

Parameters:

docMapping - document mapping will be archived

archiveDate - the archive time

Throws:

SObjectModificationException

getDocumentList

public List<SMappedDocument> getDocumentList(String documentName,
 long processInstanceId,
 int fromIndex,
 int numberOfResult)
                                      throws SBonitaReadException

Description copied from interface: DocumentService

Get a list of document. if there is no document in the list returns an empty list

Specified by:

getDocumentList in interface DocumentService

Parameters:

documentName - the name of the document list

processInstanceId - the id of the process instance that contains the list

fromIndex - pagination parameter

numberOfResult - pagination parameter

Returns:

the list of document

Throws:

SBonitaReadException

deleteContentOfArchivedDocument

public void deleteContentOfArchivedDocument(long archivedDocumentId)
                                     throws SObjectNotFoundException,
SBonitaReadException,
SRecorderException

Description copied from interface: DocumentService

Remove the content of an archived document while keeping it's metadata.

After calling this method you will not be able to retrieve the content of the document since it will be erased from the database. This method can be useful for keeping history of a document without overloading the database.

Specified by:

deleteContentOfArchivedDocument in interface DocumentService

Parameters:

archivedDocumentId - the id of the archived document to remove content on

Throws:

SObjectNotFoundException - if the document to delete does not exist

SBonitaReadException

SRecorderException

updateDocument

public SMappedDocument updateDocument(long documentId,
 SDocument sDocument)
                               throws SBonitaReadException,
SObjectNotFoundException,
SObjectModificationException

Description copied from interface: DocumentService

update the document having the documentId with this new version

Specified by:

updateDocument in interface DocumentService

Parameters:

documentId - the id of the document to update

sDocument - the new version of the document @return

Throws:

SBonitaReadException

SObjectNotFoundException

SObjectModificationException

updateDocument

public SMappedDocument updateDocument(AbstractSDocumentMapping documentToUpdate,
 SDocument sDocument)
                               throws SObjectModificationException

Specified by:

updateDocument in interface DocumentService

Parameters:

documentToUpdate - the document mapping to udpate

sDocument - the value to set th emapping with

Returns:

the updated document mapping

Throws:

SObjectModificationException

getDocumentList

public List<AbstractSMappedDocument> getDocumentList(String documentName,
 long processInstanceId,
 long time)
                                              throws SBonitaReadException

Description copied from interface: DocumentService

Get a list of document at a given time. if there is no document in the list returns an empty list.

elements are taken from archive and from non archived mapping if the process is still running

Specified by:

getDocumentList in interface DocumentService

Parameters:

documentName - the name of the document list

processInstanceId - the id of the process instance that contains the list

time - time when the list was like that

Returns:

the list of document

Throws:

SBonitaReadException