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 and Description
DocumentServiceImpl(Recorder recorder, ReadPersistenceService persistenceService, SDocumentDownloadURLProvider urlProvider, ArchiveService archiveService)

Method Summary

Modifier and Type	Method and Description
void	archive(SDocumentMapping 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(SLightDocument document)
void	deleteDocumentsFromProcessInstance(Long processInstanceId) Delete documents from a specified process instance
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<SMappedDocument>	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
SMappedDocument	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(SMappedDocument document) Remove this document.
void	removeDocument(SMappedDocument mappedDocument)
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(SDocumentMapping documentToUpdate, SDocument sDocument)
void	updateDocumentIndex(SMappedDocument mappedDocument, int index) update the index of a document inside the list
void	updateDocumentOfList(SMappedDocument mappedDocument, SDocument document, int index)

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentServiceImpl

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

Method Detail

attachDocumentToProcessInstance

public SMappedDocument attachDocumentToProcessInstance(SDocument document,
                                                       long processInstanceId,
                                                       String name,
                                                       String description)
                                                throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when the storage has failed

attachDocumentToProcessInstance

public SMappedDocument attachDocumentToProcessInstance(SDocument document,
                                                       long processInstanceId,
                                                       String name,
                                                       String description,
                                                       int index)
                                                throws org.bonitasoft.engine.commons.exceptions.SObjectCreationException,
                                                       org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when the storage has failed

org.bonitasoft.engine.commons.exceptions.SObjectAlreadyExistsException

updateDocumentOfList

public void updateDocumentOfList(SMappedDocument mappedDocument,
                                 SDocument document,
                                 int index)
                          throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Specified by:

updateDocumentOfList in interface DocumentService

Parameters:

mappedDocument - the document to update

document - the new content

index - the new index

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

updateDocumentIndex

public void updateDocumentIndex(SMappedDocument mappedDocument,
                                int index)
                         throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

deleteDocumentsFromProcessInstance

public void deleteDocumentsFromProcessInstance(Long processInstanceId)
                                        throws SBonitaReadException,
                                               org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Description copied from interface: DocumentService

Delete documents from a specified process instance

Specified by:

deleteDocumentsFromProcessInstance in interface DocumentService

Throws:

SBonitaReadException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

generateDocumentURL

public String generateDocumentURL(String name,
                                  String contentStorageId)

Specified by:

generateDocumentURL in interface DocumentService

getArchivedDocument

public SAMappedDocument getArchivedDocument(long archivedProcessDocumentId)
                                     throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException - when the archive does not exist

getArchivedVersionOfProcessDocument

public SAMappedDocument getArchivedVersionOfProcessDocument(long documentId)
                                                     throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException - when the document does not exist

getDocument

public SLightDocument getDocument(long documentId)
                           throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getMappedDocument

public SMappedDocument getMappedDocument(long processInstanceId,
                                         String documentName)
                                  throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getMappedDocument

public SMappedDocument getMappedDocument(long processInstanceId,
                                         String documentName,
                                         long time)
                                  throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

getDocumentContent

public byte[] getDocumentContent(String documentId)
                          throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

getMappedDocument

public SMappedDocument getMappedDocument(long mappingId)
                                  throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.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(SMappedDocument document)
                          throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Description copied from interface: DocumentService

Remove this document.

this archive and delete mapping on 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:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

removeCurrentVersion

public void removeCurrentVersion(long processInstanceId,
                                 String documentName)
                          throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                 org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Description copied from interface: DocumentService

Remove the document with the specified process instance and name

this archive and delete mapping on 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:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

deleteDocument

public void deleteDocument(SLightDocument document)
                    throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Specified by:

deleteDocument in interface DocumentService

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

removeDocument

public void removeDocument(SMappedDocument mappedDocument)
                    throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Specified by:

removeDocument in interface DocumentService

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

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(SDocumentMapping docMapping,
                    long archiveDate)
             throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.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 org.bonitasoft.engine.commons.exceptions.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

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

SBonitaReadException

SRecorderException

updateDocument

public SMappedDocument updateDocument(long documentId,
                                      SDocument sDocument)
                               throws SBonitaReadException,
                                      org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                                      org.bonitasoft.engine.commons.exceptions.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

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

updateDocument

public SMappedDocument updateDocument(SDocumentMapping documentToUpdate,
                                      SDocument sDocument)
                               throws org.bonitasoft.engine.commons.exceptions.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:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

getDocumentList

public List<SMappedDocument> 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