org.nuxeo.ecm.collections.api

Interface CollectionManager

All Known Implementing Classes:

CollectionManagerImpl

public interface CollectionManager

Since:

5.9.3

Method Summary

Methods

Modifier and Type	Method and Description
void	addToCollection(DocumentModel collection, DocumentModel documentToBeAdded, CoreSession session) Add a document to a collection.
void	addToCollection(DocumentModel collection, List<DocumentModel> documentListToBeAdded, CoreSession session) Add a list of document to a collection.
void	addToNewCollection(String newTitle, String newDescription, DocumentModel documentToBeAdded, CoreSession session) Add a document to a new collection.
void	addToNewCollection(String newTitle, String newDescription, List<DocumentModel> documentListToBeAdded, CoreSession documentManager) Add a list of document to a new collection.
boolean	canAddToCollection(DocumentModel collection, CoreSession session) Check that a document is a collection and that the given core session has permission to add document inside.
boolean	canManage(DocumentModel collection, CoreSession session) Check that the given core session has permission to manage the collection.
DocumentModel	createCollection(CoreSession session, String title, String description, String path) Create a collection with a given name, description and path.
void	doRemoveFromCollection(DocumentModel documentToBeRemoved, String collectionId, CoreSession session)
DocumentModel	getUserDefaultCollections(DocumentModel context, CoreSession session) Get user collections root document.
List<DocumentModel>	getVisibleCollection(DocumentModel collectionMember, CoreSession session) Get the list of collection of a document.
List<DocumentModel>	getVisibleCollection(DocumentModel collectionMember, int maxResult, CoreSession session) Get the list of collection of a document.
boolean	hasVisibleCollection(DocumentModel collectionMember, CoreSession session) Check that the given core session has READ permission on at least one collection of the given document.
boolean	isCollectable(DocumentModel document) Check that a document can be added to a collection.
boolean	isCollected(DocumentModel document) Check that a document has already been added to a collection.
boolean	isCollection(DocumentModel document) Check that a document is a collection.
boolean	isInCollection(DocumentModel collection, DocumentModel document, CoreSession session) Check whether a document is in a given collection.
void	processCopiedCollection(DocumentModel collection) Update all documents referenced by a collection to add a reference back the collection.
void	processRemovedCollection(DocumentModel collection) Update all documents referenced by a collection to remove the reference to the collection.
void	processRemovedCollectionMember(DocumentModel collectionMember) Update all collections referenced by a document.
void	removeAllFromCollection(DocumentModel collection, List<DocumentModel> documentListToBeRemoved, CoreSession session) Remove a list of document from a given collection.
void	removeFromCollection(DocumentModel collection, DocumentModel documentToBeRemoved, CoreSession session) Remove a document from a collection.

Method Detail

addToCollection

void addToCollection(DocumentModel collection,
                   DocumentModel documentToBeAdded,
                   CoreSession session)
                     throws ClientException

Add a document to a collection.

Parameters:

collection - the collection

documentToBeAdded - the document to be added

session - the core session

Throws:

ClientException

addToCollection

void addToCollection(DocumentModel collection,
                   List<DocumentModel> documentListToBeAdded,
                   CoreSession session)
                     throws ClientException

Add a list of document to a collection.

Parameters:

collection - the collection

documentListToBeAdded - the list of document to be added

session - the core session

Throws:

ClientException

addToNewCollection

void addToNewCollection(String newTitle,
                      String newDescription,
                      DocumentModel documentToBeAdded,
                      CoreSession session)
                        throws ClientException

Add a document to a new collection.

Parameters:

newTitle - the title of the new collection

newDescription - the description of the new collection

documentToBeAdded - the document to be added

session - the core session

Throws:

ClientException

addToNewCollection

void addToNewCollection(String newTitle,
                      String newDescription,
                      List<DocumentModel> documentListToBeAdded,
                      CoreSession documentManager)
                        throws ClientException

Add a list of document to a new collection.

Parameters:

newTitle - the title of the new collection

newDescription - the description of the new collection

documentListToBeAdded - the list of document to be added

session - the core session

Throws:

ClientException

canAddToCollection

boolean canAddToCollection(DocumentModel collection,
                         CoreSession session)
                           throws ClientException

Check that a document is a collection and that the given core session has permission to add document inside.

Parameters:

collection - the collection

session - the core session

Returns:

true if the given document is a Collection and the core session has permission to add document inside, false otherwise

Throws:

ClientException

canManage

boolean canManage(DocumentModel collection,
                CoreSession session)
                  throws ClientException

Check that the given core session has permission to manage the collection.

Parameters:

collection - the collection

session - the core session

Returns:

true if the core session has permission to manage the collection

Throws:

ClientException

getVisibleCollection

List<DocumentModel> getVisibleCollection(DocumentModel collectionMember,
                                       CoreSession session)
                                         throws ClientException

Get the list of collection of a document. The resulting list will only contain the collections visible by the given core session (i.e. the collections on which the given core session has at least READ permission).

Parameters:

collectionMember - the document

session - the core session

Returns:

the list of visible collections the collectionMember belong to

Throws:

ClientException

getVisibleCollection

List<DocumentModel> getVisibleCollection(DocumentModel collectionMember,
                                       int maxResult,
                                       CoreSession session)
                                         throws ClientException

Get the list of collection of a document. The resulting list will only contain the collections visible by the given core session (i.e. the collections on which the given core session has at least READ permission). The resulting list's size will be limited to masResult.

Parameters:

collectionMember - the document

maxResult - the limit

session - the core session

Returns:

the list of maxResult first visible collections the collectionMember belong to

Throws:

ClientException

hasVisibleCollection

boolean hasVisibleCollection(DocumentModel collectionMember,
                           CoreSession session)
                             throws ClientException

Check that the given core session has READ permission on at least one collection of the given document.

Parameters:

collectionMember - the document

session - the core session

Returns:

true if collectionMember has at least one collection on which the session has READ permission

Throws:

ClientException

isCollectable

boolean isCollectable(DocumentModel document)

Check that a document can be added to a collection.

Parameters:

document - the document

Returns:

true if the document can be added to the collection

isCollected

boolean isCollected(DocumentModel document)

Check that a document has already been added to a collection.

Parameters:

document - the document

Returns:

true if the document has already been added to a collection

isCollection

boolean isCollection(DocumentModel document)

Check that a document is a collection.

Parameters:

document - the document

Returns:

true if the document is a collection

isInCollection

boolean isInCollection(DocumentModel collection,
                     DocumentModel document,
                     CoreSession session)
                       throws ClientException

Check whether a document is in a given collection.

Parameters:

collection - the collection

document - the document to check

session - the session

Throws:

ClientException

Since:

5.9.4

processCopiedCollection

void processCopiedCollection(DocumentModel collection)
                             throws ClientException

Update all documents referenced by a collection to add a reference back the collection. This is used when a creation is created by copy in order to tell the members of a copied collection that they also belongs to the newly created collection.

Parameters:

collection - the collection

Throws:

ClientException

processRemovedCollection

void processRemovedCollection(DocumentModel collection)

Update all documents referenced by a collection to remove the reference to the collection. This is used after the complete deletion of a collection.

Parameters:

collection - the collection

processRemovedCollectionMember

void processRemovedCollectionMember(DocumentModel collectionMember)

Update all collections referenced by a document. This is used after the complete deletion of a document to remove its reference from all collections it belongs to.

Parameters:

collectionMember - the document

removeAllFromCollection

void removeAllFromCollection(DocumentModel collection,
                           List<DocumentModel> documentListToBeRemoved,
                           CoreSession session)
                             throws ClientException

Remove a list of document from a given collection.

Parameters:

collection - the collection

documentListToBeRemoved - the document to be removed

session - the core session

Throws:

ClientException

removeFromCollection

void removeFromCollection(DocumentModel collection,
                        DocumentModel documentToBeRemoved,
                        CoreSession session)
                          throws ClientException

Remove a document from a collection.

Parameters:

collection - the collection

documentToBeRemoved - the document to be removed

session - the core session

Throws:

ClientException

createCollection

DocumentModel createCollection(CoreSession session,
                             String title,
                             String description,
                             String path)
                               throws ClientException

Create a collection with a given name, description and path.

Parameters:

session -

title -

description -

path -

Returns:

Throws:

ClientException

Since:

5.9.4

getUserDefaultCollections

DocumentModel getUserDefaultCollections(DocumentModel context,
                                      CoreSession session)
                                        throws ClientException

Get user collections root document.

Parameters:

context - contextual document

session - the core session

Returns:

the user collections root document

Throws:

ClientException

Since:

6.0

doRemoveFromCollection

void doRemoveFromCollection(DocumentModel documentToBeRemoved,
                          String collectionId,
                          CoreSession session)

Parameters:

documentToBeRemoved -

collectionId -

session -

Since:

6.0