fr.gouv.vitam.metadata.api

Interface MetaData

All Known Implementing Classes:

MetaDataImpl

public interface MetaData

MetaData interface for database operations

Method Summary

Modifier and Type	Method and Description
List<org.bson.Document>	createAccessionRegisterSymbolic(Integer tenant) Creates the AccessionRegisterSymbolics from ElasticSearch aggregations and nested aggregation request.
void	deleteObjectGroups(List<String> idsList) delete objectsGroups
void	deleteUnits(List<String> idsList) delete units
void	insertObjectGroup(com.fasterxml.jackson.databind.JsonNode objectRequest) Insert an objectGroup
void	insertObjectGroups(List<com.fasterxml.jackson.databind.JsonNode> objectGroupRequest)
void	insertUnit(com.fasterxml.jackson.databind.JsonNode insertRequest) insert Unit
void	insertUnits(List<com.fasterxml.jackson.databind.JsonNode> jsonNodes)
void	refreshObjectGroup() Flush ObjectGroup Index
void	refreshUnit() Flush Unit Index
IndexationResult	reindex(IndexParameters indexParam) Reindex one or more collections
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	selectObjectGroupById(com.fasterxml.jackson.databind.JsonNode selectQuery, String objectGroupId) Search ObjectGroups by its Id and a Select Query for this method, the roots will be filled for example request :{
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	selectObjectGroupsByQuery(com.fasterxml.jackson.databind.JsonNode selectQuery) Search ObjectGroups by Select SelectQuery
List<ObjectGroupPerOriginatingAgency>	selectOwnAccessionRegisterOnObjectGroupByOperationId(String operationId) Select an Accession Register linked to an Operation
List<FacetBucket>	selectOwnAccessionRegisterOnUnitByOperationId(String operationId) find the number of archive unit per originating agency for a operationId
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	selectUnitsById(com.fasterxml.jackson.databind.JsonNode selectQuery, String unitId) Search UNITs by Id SelectQuery for this method, the roots will be filled for example request :{
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	selectUnitsByQuery(com.fasterxml.jackson.databind.JsonNode selectQuery) Search UNITs by Select SelectQuery
void	switchIndex(String alias, String newIndexName) Switch indexes for one or more collections
void	updateObjectGroupId(com.fasterxml.jackson.databind.JsonNode updateRequest, String objectId) Update an object group
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	updateUnitbyId(com.fasterxml.jackson.databind.JsonNode updateQuery, String unitId) Update UNITs by Id UpdateMultiQueryQuery for this method, the roots will be filled for example request :{
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	updateUnits(com.fasterxml.jackson.databind.JsonNode updateQuery) Update UNITs by Ids UpdateMultiQueryQuery for this method, the roots will be filled for example request :{
RequestResponse<com.fasterxml.jackson.databind.JsonNode>	updateUnitsRules(com.fasterxml.jackson.databind.JsonNode updateQuery, Map<String,DurationData> bindRuleToDuration) Update UNITs Rules by Ids UpdateMultiQueryQuery for this method, the roots will be filled for example request : { "dslRequest": {"$roots":[{id:"id1"},{id:"id2"}],"$query":[]}, "ruleActions": {"add":[{"AppraisalRule":{"Rules":[{"Rule":"APP-00001","StartDate":"1982-09-01"}],"FinalAction":"Keep"}} ] } }

Method Detail

insertUnit

void insertUnit(com.fasterxml.jackson.databind.JsonNode insertRequest)
         throws InvalidParseOperationException,
                IllegalArgumentException,
                MetaDataNotFoundException,
                MetaDataAlreadyExistException,
                MetaDataExecutionException,
                MetaDataDocumentSizeException,
                VitamDBException

insert Unit

Parameters:

insertRequest - as String { $roots: roots, $query : query, $filter : multi, $data : data}

Throws:

InvalidParseOperationException - Throw if json format is not correct

IllegalArgumentException - Throw if arguments of insert query is invalid

MetaDataNotFoundException - Throw if parent of this unit is not found

MetaDataAlreadyExistException - Throw if Unit id already exists

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

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

selectOwnAccessionRegisterOnObjectGroupByOperationId

List<ObjectGroupPerOriginatingAgency> selectOwnAccessionRegisterOnObjectGroupByOperationId(String operationId)

Select an Accession Register linked to an Operation

Parameters:

operationId - the operation identifier

Returns:

the list of documents

selectUnitsByQuery

RequestResponse<com.fasterxml.jackson.databind.JsonNode> selectUnitsByQuery(com.fasterxml.jackson.databind.JsonNode selectQuery)
                                                                     throws InvalidParseOperationException,
                                                                            MetaDataExecutionException,
                                                                            MetaDataDocumentSizeException,
                                                                            MetaDataNotFoundException,
                                                                            BadRequestException,
                                                                            VitamDBException

Search UNITs by Select SelectQuery

Parameters:

selectQuery - the query of type JsonNode

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

MetaDataNotFoundException - Throw if unit by id not found

BadRequestException - if a bad request is being used

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

selectObjectGroupsByQuery

RequestResponse<com.fasterxml.jackson.databind.JsonNode> selectObjectGroupsByQuery(com.fasterxml.jackson.databind.JsonNode selectQuery)
                                                                            throws MetaDataExecutionException,
                                                                                   InvalidParseOperationException,
                                                                                   MetaDataDocumentSizeException,
                                                                                   MetaDataNotFoundException,
                                                                                   BadRequestException,
                                                                                   VitamDBException

Search ObjectGroups by Select SelectQuery

Parameters:

selectQuery - the query of type JsonNode

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

MetaDataNotFoundException - Throw if unit by id not found

BadRequestException - if a bad request is being used

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

selectUnitsById

RequestResponse<com.fasterxml.jackson.databind.JsonNode> selectUnitsById(com.fasterxml.jackson.databind.JsonNode selectQuery,
                                                                         String unitId)
                                                                  throws InvalidParseOperationException,
                                                                         MetaDataExecutionException,
                                                                         MetaDataDocumentSizeException,
                                                                         MetaDataNotFoundException,
                                                                         BadRequestException,
                                                                         VitamDBException

Search UNITs by Id SelectQuery
for this method, the roots will be filled
for example request :{

$roots:[{id:"id"}]

,
$query{}, ..}

Parameters:

selectQuery - the select query of type JsonNode

unitId - the unit id for query

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

MetaDataNotFoundException - Throw if unit by id not found

BadRequestException - if a bad request is being used

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

selectObjectGroupById

RequestResponse<com.fasterxml.jackson.databind.JsonNode> selectObjectGroupById(com.fasterxml.jackson.databind.JsonNode selectQuery,
                                                                               String objectGroupId)
                                                                        throws InvalidParseOperationException,
                                                                               MetaDataDocumentSizeException,
                                                                               MetaDataExecutionException,
                                                                               MetaDataNotFoundException,
                                                                               BadRequestException,
                                                                               VitamDBException

Search ObjectGroups by its Id and a Select Query
for this method, the roots will be filled
for example request :{

$roots:[{id:"id"}]

,
$query{}, ..}

Parameters:

selectQuery - the query to filter results and make projections

objectGroupId - the objectgroup id

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of objectgroups(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

MetaDataNotFoundException - Thrown if no objectGroup is found

BadRequestException - if a bad request is being used

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

updateUnits

RequestResponse<com.fasterxml.jackson.databind.JsonNode> updateUnits(com.fasterxml.jackson.databind.JsonNode updateQuery)
                                                              throws InvalidParseOperationException

Update UNITs by Ids UpdateMultiQueryQuery
for this method, the roots will be filled
for example request :{

$roots:[{id:"id1"}, {id:"id2"}]

,
$query{}, ..}

Parameters:

updateQuery - the update query as JsonNode containing unitIds in root parts

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

updateUnitsRules

RequestResponse<com.fasterxml.jackson.databind.JsonNode> updateUnitsRules(com.fasterxml.jackson.databind.JsonNode updateQuery,
                                                                          Map<String,DurationData> bindRuleToDuration)
                                                                   throws InvalidParseOperationException

Update UNITs Rules by Ids UpdateMultiQueryQuery
for this method, the roots will be filled
for example request : {
"dslRequest": {"$roots":[{id:"id1"},{id:"id2"}],"$query":[]},
"ruleActions": {"add":[{"AppraisalRule":{"Rules":[{"Rule":"APP-00001","StartDate":"1982-09-01"}],"FinalAction":"Keep"}} ] }
}

Parameters:

updateQuery - the update query as JsonNode containing unitIds in root parts and updates in ruleActions part

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

updateUnitbyId

RequestResponse<com.fasterxml.jackson.databind.JsonNode> updateUnitbyId(com.fasterxml.jackson.databind.JsonNode updateQuery,
                                                                        String unitId)
                                                                 throws MetaDataNotFoundException,
                                                                        InvalidParseOperationException,
                                                                        MetaDataExecutionException,
                                                                        MetaDataDocumentSizeException,
                                                                        VitamDBException

Update UNITs by Id UpdateMultiQueryQuery
for this method, the roots will be filled
for example request :{

$roots:[{id:"id"}]

,
$query{}, ..}

Parameters:

updateQuery - the update query as JsonNode

unitId - the id of Unit for query

Returns:

JsonNode {$hits{},$context{},$result:[{}....{}],}
$context will be added later (Access)
$result array of units(can be empty)

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

MetaDataNotFoundException - Throw if unit does not exist

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

insertObjectGroup

void insertObjectGroup(com.fasterxml.jackson.databind.JsonNode objectRequest)
                throws InvalidParseOperationException,
                       MetaDataAlreadyExistException,
                       MetaDataExecutionException,
                       MetaDataDocumentSizeException

Insert an objectGroup

Parameters:

objectRequest - as JsonNode { $roots: roots, $query : query, $filter : multi, $data : data}

Throws:

InvalidParseOperationException - Throw if json format is not correct

MetaDataAlreadyExistException - Throw if Unit id already exists

MetaDataExecutionException - Throw if error occurs when send Unit to database

MetaDataDocumentSizeException - Throw if Unit size is too big

insertObjectGroups

void insertObjectGroups(List<com.fasterxml.jackson.databind.JsonNode> objectGroupRequest)
                 throws InvalidParseOperationException,
                        MetaDataExecutionException,
                        MetaDataAlreadyExistException,
                        MetaDataDocumentSizeException

Throws:

InvalidParseOperationException

MetaDataExecutionException

MetaDataAlreadyExistException

MetaDataDocumentSizeException

createAccessionRegisterSymbolic

List<org.bson.Document> createAccessionRegisterSymbolic(Integer tenant)

Creates the AccessionRegisterSymbolics from ElasticSearch aggregations and nested aggregation request. Because the AccessionRegisterSymbolic is not available from this package, it is a list of Document which is returned.

Parameters:

tenant - on related to the symbolic accession register to create

Returns:

a list of AccessionRegisterSymbolic

selectOwnAccessionRegisterOnUnitByOperationId

List<FacetBucket> selectOwnAccessionRegisterOnUnitByOperationId(String operationId)
                                                         throws MetaDataExecutionException

find the number of archive unit per originating agency for a operationId

Parameters:

operationId - operation id

Returns:

the list of documents

Throws:

MetaDataExecutionException

updateObjectGroupId

void updateObjectGroupId(com.fasterxml.jackson.databind.JsonNode updateRequest,
                         String objectId)
                  throws InvalidParseOperationException,
                         MetaDataExecutionException,
                         VitamDBException

Update an object group

Parameters:

updateRequest - the request as a json

objectId - the id of the object to be updated

Throws:

InvalidParseOperationException - Thrown when json format is not correct

MetaDataExecutionException - Thrown if error occurs when send Unit to database

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

refreshUnit

void refreshUnit()
          throws IllegalArgumentException,
                 VitamThreadAccessException

Flush Unit Index

Throws:

IllegalArgumentException - if tenant is wrong

VitamThreadAccessException - if tenant is wrong

refreshObjectGroup

void refreshObjectGroup()
                 throws IllegalArgumentException,
                        VitamThreadAccessException

Flush ObjectGroup Index

Throws:

IllegalArgumentException - if tenant is wrong

VitamThreadAccessException - if tenant is wrong

reindex

IndexationResult reindex(IndexParameters indexParam)

Reindex one or more collections

Parameters:

indexParam - 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

insertUnits

void insertUnits(List<com.fasterxml.jackson.databind.JsonNode> jsonNodes)
          throws InvalidParseOperationException,
                 IllegalArgumentException,
                 MetaDataNotFoundException,
                 MetaDataAlreadyExistException,
                 MetaDataExecutionException,
                 MetaDataDocumentSizeException,
                 VitamDBException

Throws:

InvalidParseOperationException

IllegalArgumentException

MetaDataNotFoundException

MetaDataAlreadyExistException

MetaDataExecutionException

MetaDataDocumentSizeException

VitamDBException

deleteUnits

void deleteUnits(List<String> idsList)
          throws IllegalArgumentException,
                 MetaDataExecutionException

delete units

Parameters:

idsList - idsList

Throws:

IllegalArgumentException

MetaDataExecutionException

deleteObjectGroups

void deleteObjectGroups(List<String> idsList)
                 throws IllegalArgumentException,
                        MetaDataExecutionException

delete objectsGroups

Parameters:

idsList - idsList

Throws:

IllegalArgumentException

MetaDataExecutionException