fr.gouv.vitam.logbook.operations.api

Interface LogbookOperations

All Known Implementing Classes:

AlertLogbookOperationsDecorator, LogbookOperationsDecorator, LogbookOperationsImpl

public interface LogbookOperations

Logbook operations interface for database operations

Method Summary

Modifier and Type	Method and Description
void	create(LogbookOperationParameters parameters) Create and insert logbook operation entries
void	createBulkLogbookOperation(LogbookOperationParameters[] operationArray) Create one Logbook Operation with already multiple sub-events
LogbookOperation	findFirstTraceabilityOperationOKAfterDate(LocalDateTime date) Find One logbook TraceabilityOperation after a given date
LogbookOperation	findLastTraceabilityOperationOK() Find last successful traceability operation
LogbookOperation	getById(String IdProcess) Select logbook operation by the operation's ID
IndexationResult	reindex(IndexParameters indexParameters) Reindex one or more collections
List<LogbookOperation>	select(com.fasterxml.jackson.databind.JsonNode select) Select logbook operation entries
List<LogbookOperation>	select(com.fasterxml.jackson.databind.JsonNode select, boolean sliced) Select logbook operation entries
com.mongodb.client.MongoCursor<LogbookOperation>	selectOperationsPersistedAfterDate(LocalDateTime date) Select all logbook operations entries after a given date
void	switchIndex(String alias, String newIndexName) Switch indexes for one or more collections
void	update(LogbookOperationParameters parameters) Update and insert logbook operation entries
void	updateBulkLogbookOperation(LogbookOperationParameters[] operationArray) Update one Logbook Operation with multiple sub-events It adds this new entry within the very same Logbook Operaton entry in "events" array.

Method Detail

create

void create(LogbookOperationParameters parameters)
     throws LogbookAlreadyExistsException,
            LogbookDatabaseException

Create and insert logbook operation entries

Parameters:

parameters - the entry parameters

Throws:

LogbookAlreadyExistsException - if an operation with the same eventIdentifierProcess and outcome="Started" already exists

LogbookDatabaseException - if errors occur while connecting or writing to the database

update

void update(LogbookOperationParameters parameters)
     throws LogbookNotFoundException,
            LogbookDatabaseException

Update and insert logbook operation entries

Parameters:

parameters - the entry parameters

Throws:

LogbookNotFoundException - if no operation with the same eventIdentifierProcess exists

LogbookDatabaseException - if errors occur while connecting or writing to the database

select

List<LogbookOperation> select(com.fasterxml.jackson.databind.JsonNode select)
                       throws LogbookDatabaseException,
                              LogbookNotFoundException,
                              InvalidParseOperationException,
                              VitamDBException

Select logbook operation entries

Parameters:

select - the select request in format of JsonNode

Returns:

List of the logbook operation

Throws:

LogbookNotFoundException - if no operation selected cannot be found

LogbookDatabaseException - if errors occur while connecting or writing to the database

InvalidParseOperationException - if invalid parse for selecting the operation

VitamDBException - in case a desynchro is recorded between Mongo and ES

select

List<LogbookOperation> select(com.fasterxml.jackson.databind.JsonNode select,
                              boolean sliced)
                       throws LogbookDatabaseException,
                              LogbookNotFoundException,
                              InvalidParseOperationException,
                              VitamDBException

Select logbook operation entries

Parameters:

select - the select request in format of JsonNode

sliced - the boolean sliced to filter events or not

Returns:

List of the logbook operation

Throws:

LogbookNotFoundException - if no operation selected cannot be found

LogbookDatabaseException - if errors occur while connecting or writing to the database

InvalidParseOperationException - if invalid parse for selecting the operation

VitamDBException - in case a desynchro is recorded between Mongo and ES

getById

LogbookOperation getById(String IdProcess)
                  throws LogbookDatabaseException,
                         LogbookNotFoundException

Select logbook operation by the operation's ID

Parameters:

IdProcess - the operation identifier

Returns:

the logbook operation found by the ID

Throws:

LogbookDatabaseException - if errors occur while connecting or writing to the database

LogbookNotFoundException - if no operation selected cannot be found

createBulkLogbookOperation

void createBulkLogbookOperation(LogbookOperationParameters[] operationArray)
                         throws LogbookDatabaseException,
                                LogbookAlreadyExistsException

Create one Logbook Operation with already multiple sub-events

Parameters:

operationArray - with first and next events to add/update

Throws:

IllegalArgumentException - if first argument is null or null mandatory parameters for all

LogbookDatabaseException - if errors occur while connecting or writing to the database

LogbookAlreadyExistsException - if logbook already exists

updateBulkLogbookOperation

void updateBulkLogbookOperation(LogbookOperationParameters[] operationArray)
                         throws LogbookDatabaseException,
                                LogbookNotFoundException

Update one Logbook Operation with multiple sub-events

It adds this new entry within the very same Logbook Operaton entry in "events" array.

Parameters:

operationArray - containing all operations Logbook in order

Throws:

IllegalArgumentException - if parameter has null or empty mandatory values

LogbookDatabaseException - if errors occur while connecting or writing to the database

LogbookNotFoundException - if no operation selected cannot be found

selectOperationsPersistedAfterDate

com.mongodb.client.MongoCursor<LogbookOperation> selectOperationsPersistedAfterDate(LocalDateTime date)
                                                                             throws LogbookDatabaseException,
                                                                                    LogbookNotFoundException,
                                                                                    InvalidParseOperationException,
                                                                                    InvalidCreateOperationException

Select all logbook operations entries after a given date

Parameters:

date - the select request in format of JsonNode

Returns:

the Closeable MongoCursor of LogbookOperation

Throws:

LogbookNotFoundException - if no operation selected cannot be found

LogbookDatabaseException - if errors occur while connecting or writing to the database

InvalidParseOperationException - if invalid parse for selecting the operation

InvalidCreateOperationException - if the query could not be created

findFirstTraceabilityOperationOKAfterDate

LogbookOperation findFirstTraceabilityOperationOKAfterDate(LocalDateTime date)
                                                    throws InvalidCreateOperationException,
                                                           LogbookNotFoundException,
                                                           LogbookDatabaseException

Find One logbook TraceabilityOperation after a given date

Parameters:

date - the select request in format of JsonNode

Returns:

the LogbookOperation

Throws:

LogbookNotFoundException - if no operation selected cannot be found

LogbookDatabaseException - if errors occur while connecting or writing to the database

InvalidParseOperationException - if invalid parse for selecting the operation

InvalidCreateOperationException - if the query could not be created

findLastTraceabilityOperationOK

LogbookOperation findLastTraceabilityOperationOK()
                                          throws InvalidCreateOperationException,
                                                 LogbookNotFoundException,
                                                 LogbookDatabaseException,
                                                 InvalidParseOperationException

Find last successful traceability operation

Returns:

the last valid traceability operation

Throws:

InvalidCreateOperationException - if the query could not be created

LogbookNotFoundException - if no operation selected cannot be found

LogbookDatabaseException - if errors occur while connecting or writing to the database

InvalidParseOperationException - if the query could not be created

reindex

IndexationResult reindex(IndexParameters indexParameters)

Reindex one or more collections

Parameters:

indexParameters - the parameters specifying what to reindex

Returns:

the reindexation result as a IndexationResult Object

switchIndex

void switchIndex(String alias,
                 String newIndexName)
          throws DatabaseException

Switch indexes for one or more collections

Parameters:

alias - the alias name

newIndexName - the new index to be pointed on

Throws:

DatabaseException - in case error with database occurs