org.ametys.plugins.workspaces.documents

Class WorkspaceExplorerResourceDAO

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.explorer.resources.actions.ExplorerResourcesDAO

org.ametys.plugins.workspaces.documents.WorkspaceExplorerResourceDAO

All Implemented Interfaces:

LogEnabled, PluginAware, Component, Contextualizable, Serviceable

public class WorkspaceExplorerResourceDAO
extends ExplorerResourcesDAO
implements PluginAware

DAO for resources of a project

Field Summary

Fields

Modifier and Type	Field and Description
private static Pattern	__IMAGE_FILE_PATTERN Pattern to test images
protected AddOrUpdateResourceHelper	_addOrUpdateResourceHelper resource operation helper
private HTMLTransformer	_htmlTransformer
private WorkspaceModuleExtensionPoint	_moduleEP
private String	_pluginName
private ProjectManager	_projectManager The project manager
private ProjectRightHelper	_projectRightHelper
private SearcherFactory	_searcherFactory
private SourceResolver	_sourceResolver
private UserManager	_userManager
static String	FILE Constant for resource
static String	FOLDER Constant for resource collection
static String	ROLE Avalon Role

Fields inherited from class org.ametys.plugins.explorer.resources.actions.ExplorerResourcesDAO

_cocoonContext, _context, _currentUserProvider, _explorerApplicationEP, _i18nUtils, _metadataPopulatorEP, _observationManager, _resolver, _rightManager, _threadDAO, _tikaProvider, _userHelper, RIGHTS_COLLECTION_ADD, RIGHTS_COLLECTION_DELETE, RIGHTS_COLLECTION_EDIT, RIGHTS_RESOURCE_ADD, RIGHTS_RESOURCE_COMMENT, RIGHTS_RESOURCE_DELETE, RIGHTS_RESOURCE_EDIT_DC, RIGHTS_RESOURCE_MODERATE_COMMENT, RIGHTS_RESOURCE_RENAME, RIGHTS_RESOURCE_UNLOCK_ALL

Constructor Summary

Constructors

Constructor and Description
WorkspaceExplorerResourceDAO()

Method Summary

Modifier and Type	Method and Description
protected boolean	_canView(Resource file) Indicates if the current user can view the file
protected boolean	_canView(ResourceCollection folder) Indicates if the current user can view the folder
protected Map<String,Object>	_extractDocumentData(AmetysObject document, boolean excludeFolders, boolean excludeFiles, boolean excludeFilesInFolderHierarchy) Internal method to extract the valuable data of a document
protected Map<String,Object>	_extractFileData(Resource file) Internal method to extract the valuable data of a file
protected Map<String,Object>	_extractFileImageData(Resource file) Internal method to extract image specific data of a file
protected Map<String,Object>	_extractFileLockData(Resource file) Internal method to extract the data relative to the lock state of a file
protected Map<String,Object>	_extractFileRightData(Resource file) Internal method to extract the data concerning the right of the current user for file
protected Map<String,Object>	_extractFolderData(ResourceCollection folder, boolean excludeFilesInFolderHierarchy) Internal method to extract the valuable data of a folder
protected Map<String,Object>	_extractFolderRightData(ResourceCollection folder) Internal method to extract the data concerning the right of the current user for a folder
private Long	_getChildDocumentsCount(ResourceCollection collection)
protected String	_getComment(JCRPost post) Get the content of a comment as a String
protected String	_getCommentForEditing(JCRPost post) Get the content of a comment to edit as a String
private String	_getFilePath(Resource file)
private String	_getFolderPath(ResourceCollection folder)
private Project	_getProjectFomObject(AmetysObject ametysObject)
private Project	_getProjectFromRequest()
private ResourceCollection	_getRootFromObject(AmetysObject ametysObject)
private ResourceCollection	_getRootFromProject(Project project)
private ResourceCollection	_getRootFromRequest()
private ResourceCollection	_getRootIfNull(ResourceCollection document)
private ResourceCollection	_getRootIfNull(String documentId)
protected boolean	_hasChildDocuments(ResourceCollection folder, boolean excludeFilesInFolderHierarchy) Internal method to detect if a document has child
private List<String>	_sanitizeFileTags(Collection<String> tags)
protected void	_setComment(JCRPost comment, String content) Update the content of a comment
Map<String,Object>	addCMISCollection(String parentId, String originalName, String url, String login, String password, String repoId, boolean renameIfExists) Creates a new CMIS folder (see CMISRootResourcesCollection)
Map<String,Object>	addFile(InputStream inputStream, String fileName, String parentId, boolean unarchive, boolean allowRename, boolean allowUpdate) Add a file
Map<String,Object>	addFile(Part part, String parentId, boolean unarchive, boolean allowRename, boolean allowUpdate) Add a file
Map<String,Object>	addFolder(String parentId, String inputName, String description, Boolean renameIfExists) Add a folder
Map<String,Object>	copyFiles(List<String> ids, String targetId) Copy file resources
Map<String,Object>	deleteFolder(String id) Delete a folder
Map<String,Object>	editCMISCollection(String id, String name, String url, String login, String password, String repoId) Edits a CMIS folder (see CMISRootResourcesCollection)
Map<String,Object>	editFile(String id, String inputName, String description, Collection<String> tags) Edit a file
Map<String,Object>	editFolder(String id, String inputName, String description) Edit a folder
private Map<String,Object>	generateActionResult(ResourceCollection folder, AddOrUpdateResourceHelper.ResourceOperationResult operationResult)
String	generateWebdavUri(String documentId) Generates an uri to open a document through webdav
List<Map<String,Object>>	getChildDocumentsData(ResourceCollection document, boolean excludeFilesInFolderHierarchy) Retrieves the children of a document and extracts its data.
List<Map<String,Object>>	getChildDocumentsData(ResourceCollection document, boolean excludeFolders, boolean excludeFiles, boolean excludeFilesInFolderHierarchy) Retrieves the children of a document and extracts its data.
List<Map<String,Object>>	getChildDocumentsData(String parentId, boolean excludeFilesInFolderHierarchy) Retrieves the children of a document and extracts its data.
List<Map<String,Object>>	getChildDocumentsData(String parentId, boolean excludeFolders, boolean excludeFiles, boolean excludeFilesInFolderHierarchy) Retrieves the children of a document and extracts its data.
Map<String,String>	getCMISProperties(String id) Get the CMIS properties of collection
Map<String,Object>	getDocumentData(String id, boolean excludeFilesInFolderHierarchy) Retrieves the set of standard data for a document (folder or resource)
Long	getDocumentsCount(Project project) Count the total of documents in the project
List<Map<String,Object>>	getDocumentsData(List<String> ids, boolean excludeFilesInFolderHierarchy) Retrieves the set of standard data for a list of documents
private ModifiableResourceCollection	getModifiableResourceCollection(String ametysId) get a ModifiableResourceCollection for an ID, or the root folder;
private AddOrUpdateResourceHelper.ResourceOperationMode	getOperationMode(boolean unarchive, boolean allowRename, boolean allowUpdate) returns the AddOrUpdateResourceHelper.ResourceOperationMode according to parameters
boolean	isCMISCollection(String id) Determines if a object is a CMISRootResourcesCollection
Map<String,Object>	lockResources(List<String> ids) Lock resources
Map<String,Object>	moveDocuments(List<String> ids, String targetId) Move documents (files or folders)
boolean	resourceExists(String parentId, String name) Determines if a resource with given name already exists
Map<String,Object>	searchFiles(String query, String lang) Search for files in the document module
void	service(ServiceManager manager)
void	setPluginInfo(String pluginName, String featureName, String id) Sets the plugin info relative to the current component. Note : The feature name may be null if the targeted component in declared at plugin level.
Map<String,Object>	unlockResources(List<String> ids) Unlock resources

Methods inherited from class org.ametys.plugins.explorer.resources.actions.ExplorerResourcesDAO

_canAddComment, _canDeleteComment, _canEditComment, addComment, addResourceCollection, addResourceCollection, checkLock, checkpoint, checkUserRight, contextualize, copyResource, copyResource, createResource, deleteComment, deleteObject, deleteObject, editCMISCollection, editComment, extractResourceMetadata, filterResourcesByRegExp, getComment, getComments, getDCMetadata, getDefaultInfoAsRootNode, getDefaultInfoAsRootNode, getExplorerNodeProperties, getNodesInfo, getResourceCollectionType, getResourceProperties, getResourcesRootNodes, getRootNodesInfo, getUserRight, getUserRights, hasRight, moveObject, moveObject, renameObject, renameObject, renameResource, renameResource, resourceExists, resourceHistory, restoreResource, setDCMetadata, setDCMetadata, updateResource

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

Avalon Role

FOLDER

public static final String FOLDER

Constant for resource collection

See Also:

Constant Field Values

FILE

public static final String FILE

Constant for resource

See Also:

Constant Field Values

__IMAGE_FILE_PATTERN

private static final Pattern __IMAGE_FILE_PATTERN

Pattern to test images

_addOrUpdateResourceHelper

protected AddOrUpdateResourceHelper _addOrUpdateResourceHelper

resource operation helper

_projectManager

private ProjectManager _projectManager

The project manager

_htmlTransformer

private HTMLTransformer _htmlTransformer

_sourceResolver

private SourceResolver _sourceResolver

_pluginName

private String _pluginName

_searcherFactory

private SearcherFactory _searcherFactory

_userManager

private UserManager _userManager

_projectRightHelper

private ProjectRightHelper _projectRightHelper

_moduleEP

private WorkspaceModuleExtensionPoint _moduleEP

Constructor Detail

WorkspaceExplorerResourceDAO

public WorkspaceExplorerResourceDAO()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class ExplorerResourcesDAO

Throws:

ServiceException

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

Description copied from interface: PluginAware

Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.

Specified by:

setPluginInfo in interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

addFolder

public Map<String,Object> addFolder(String parentId,
                                    String inputName,
                                    String description,
                                    Boolean renameIfExists)
                             throws IllegalAccessException

Add a folder

Parameters:

parentId - Identifier of the parent collection. Can be null to add folder to root folder.

inputName - The desired name

description - The folder description

renameIfExists - True to rename if existing

Returns:

The result map with id, parentId and name keys

Throws:

IllegalAccessException - If the user has no sufficient rights

editFolder

public Map<String,Object> editFolder(String id,
                                     String inputName,
                                     String description)
                              throws IllegalAccessException

Edit a folder

Parameters:

id - Identifier of the folder to edit

inputName - The desired name

description - The folder description

Returns:

The result map with id and name keys

Throws:

IllegalAccessException - If the user has no sufficient rights

deleteFolder

public Map<String,Object> deleteFolder(String id)
                                throws IllegalAccessException

Delete a folder

Parameters:

id - Identifier of the folder to delete

Returns:

The result map with the parent id key

Throws:

IllegalAccessException - If the user has no sufficient rights

lockResources

public Map<String,Object> lockResources(List<String> ids)

Lock resources

Parameters:

ids - The id of resources to lock

Returns:

the result.

unlockResources

public Map<String,Object> unlockResources(List<String> ids)

Unlock resources

Parameters:

ids - The id of resources to lock

Returns:

the result.

resourceExists

public boolean resourceExists(String parentId,
                              String name)

Determines if a resource with given name already exists

Overrides:

resourceExists in class ExplorerResourcesDAO

Parameters:

parentId - the id of parent collection. Can be null.

name - the name of resource

Returns:

true if a resource with same name exists

editFile

public Map<String,Object> editFile(String id,
                                   String inputName,
                                   String description,
                                   Collection<String> tags)
                            throws IllegalAccessException

Edit a file

Parameters:

id - Identifier of the file to edit

inputName - The desired name

description - The file description

tags - The file tags

Returns:

The result map with id and name keys

Throws:

IllegalAccessException - If the user has no sufficient rights

copyFiles

public Map<String,Object> copyFiles(List<String> ids,
                                    String targetId)
                             throws RepositoryException

Copy file resources

Parameters:

ids - The list of identifiers for the resources to copy

targetId - The id of target to copy into. Can be null to copy into root folder.

Returns:

The result map with a message key in case of an error or with the list of uncopied/copied resources

Throws:

RepositoryException - If there is a repository error

moveDocuments

public Map<String,Object> moveDocuments(List<String> ids,
                                        String targetId)
                                 throws RepositoryException

Move documents (files or folders)

Parameters:

ids - The list of identifiers for the objects to move

targetId - The id of target to move into. Can be null to move documents to root folder.

Returns:

The result map with a message key in case of an error or with the list of unmoved/moved objects

Throws:

RepositoryException - If there is a repository error

searchFiles

public Map<String,Object> searchFiles(String query,
                                      String lang)
                               throws Exception

Search for files in the document module

Parameters:

query - The search query

lang - The search language

Returns:

A result map containing a resources entry which is a list of the files data

Throws:

Exception - if an exception occurs

getChildDocumentsData

public List<Map<String,Object>> getChildDocumentsData(String parentId,
                                                      boolean excludeFilesInFolderHierarchy)

Retrieves the children of a document and extracts its data.

Parameters:

parentId - Identifier of the parent collection

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of information

getChildDocumentsData

public List<Map<String,Object>> getChildDocumentsData(String parentId,
                                                      boolean excludeFolders,
                                                      boolean excludeFiles,
                                                      boolean excludeFilesInFolderHierarchy)

Retrieves the children of a document and extracts its data.

Parameters:

parentId - Identifier of the parent collection. Can be null to get children of root folder.

excludeFolders - Folders will be excluded if true

excludeFiles - Files will be excluded if true

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of information

getChildDocumentsData

public List<Map<String,Object>> getChildDocumentsData(ResourceCollection document,
                                                      boolean excludeFilesInFolderHierarchy)

Retrieves the children of a document and extracts its data.

Parameters:

document - the document

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of information

getChildDocumentsData

public List<Map<String,Object>> getChildDocumentsData(ResourceCollection document,
                                                      boolean excludeFolders,
                                                      boolean excludeFiles,
                                                      boolean excludeFilesInFolderHierarchy)

Retrieves the children of a document and extracts its data.

Parameters:

document - the document

excludeFolders - Folders will be excluded if true

excludeFiles - Files will be excluded if true

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of information

getDocumentData

public Map<String,Object> getDocumentData(String id,
                                          boolean excludeFilesInFolderHierarchy)

Retrieves the set of standard data for a document (folder or resource)

Parameters:

id - the document id or null to get root document

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of data

getDocumentsData

public List<Map<String,Object>> getDocumentsData(List<String> ids,
                                                 boolean excludeFilesInFolderHierarchy)

Retrieves the set of standard data for a list of documents

Parameters:

ids - The list of document identifiers

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

The map of data

generateWebdavUri

public String generateWebdavUri(String documentId)

Generates an uri to open a document through webdav

Parameters:

documentId - The document identifier

Returns:

The generated uri

_getRootIfNull

private ResourceCollection _getRootIfNull(ResourceCollection document)

_getRootIfNull

private ResourceCollection _getRootIfNull(String documentId)

_getRootFromRequest

private ResourceCollection _getRootFromRequest()

_getRootFromObject

private ResourceCollection _getRootFromObject(AmetysObject ametysObject)

_getRootFromProject

private ResourceCollection _getRootFromProject(Project project)

_getProjectFromRequest

private Project _getProjectFromRequest()

_getProjectFomObject

private Project _getProjectFomObject(AmetysObject ametysObject)

_extractDocumentData

protected Map<String,Object> _extractDocumentData(AmetysObject document,
                                                  boolean excludeFolders,
                                                  boolean excludeFiles,
                                                  boolean excludeFilesInFolderHierarchy)

Internal method to extract the valuable data of a document

Parameters:

document - The document (file or folder)

excludeFolders - Folders will be excluded if true

excludeFiles - Files will be excluded if true

excludeFilesInFolderHierarchy - Should child files be taken into account when extracting data of a folder

Returns:

the valuable document data

_extractFolderData

protected Map<String,Object> _extractFolderData(ResourceCollection folder,
                                                boolean excludeFilesInFolderHierarchy)

Internal method to extract the valuable data of a folder

Parameters:

folder - The folder

excludeFilesInFolderHierarchy - Should child files be taken into account to compute the 'hasChildDocuments' data.

Returns:

the valuable folder data

_getFolderPath

private String _getFolderPath(ResourceCollection folder)

_hasChildDocuments

protected boolean _hasChildDocuments(ResourceCollection folder,
                                     boolean excludeFilesInFolderHierarchy)

Internal method to detect if a document has child

Parameters:

folder - The folder

excludeFilesInFolderHierarchy - Should child files be taken into account to compute the 'hasChildDocuments' data.

Returns:

the valuable folder data

_extractFolderRightData

protected Map<String,Object> _extractFolderRightData(ResourceCollection folder)

Internal method to extract the data concerning the right of the current user for a folder

Parameters:

folder - The folder

Returns:

The map of right data. Keys are the rights id, and values indicates whether the current user has the right or not.

addFile

public Map<String,Object> addFile(Part part,
                                  String parentId,
                                  boolean unarchive,
                                  boolean allowRename,
                                  boolean allowUpdate)
                           throws IllegalAccessException

Add a file

Parameters:

part - The uploaded part corresponding to the file

parentId - Identifier of the parent collection

unarchive - True if the file is an archive that should be unarchived (only available for ZIP file)

allowRename - True if the file can be renamed if it already exists

allowUpdate - True if the file can be updated if it already exists (and allowRename is false)

Returns:

The result map with id, parentId and name keys

Throws:

IllegalAccessException - If the user has no sufficient rights

addFile

public Map<String,Object> addFile(InputStream inputStream,
                                  String fileName,
                                  String parentId,
                                  boolean unarchive,
                                  boolean allowRename,
                                  boolean allowUpdate)
                           throws IllegalAccessException

Add a file

Parameters:

inputStream - The uploaded input stream

fileName - desired file name

parentId - Identifier of the parent collection

unarchive - True if the file is an archive that should be unarchived (only available for ZIP file)

allowRename - True if the file can be renamed if it already exists

allowUpdate - True if the file can be updated if it already exists (and allowRename is false)

Returns:

The result map with id, parentId and name keys

Throws:

IllegalAccessException - If the user has no sufficient rights

getModifiableResourceCollection

private ModifiableResourceCollection getModifiableResourceCollection(String ametysId)

get a ModifiableResourceCollection for an ID, or the root folder;

Parameters:

ametysId - id of the resource. Can be null to get root folder.

Returns:

ModifiableResourceCollection

Throws:

IllegalClassException - if id links to a node which is not a ModifiableResourceCollection

getOperationMode

private AddOrUpdateResourceHelper.ResourceOperationMode getOperationMode(boolean unarchive,
                                                                         boolean allowRename,
                                                                         boolean allowUpdate)

returns the AddOrUpdateResourceHelper.ResourceOperationMode according to parameters

Parameters:

unarchive - unarchive

allowRename - allowRename

allowUpdate - allowUpdate

Returns:

ADD, ADD_UNZIP, ADD_RENAME, ADD_UPDATE

generateActionResult

private Map<String,Object> generateActionResult(ResourceCollection folder,
                                                AddOrUpdateResourceHelper.ResourceOperationResult operationResult)

_extractFileData

protected Map<String,Object> _extractFileData(Resource file)

Internal method to extract the valuable data of a file

Parameters:

file - The file

Returns:

the valuable file data

_getFilePath

private String _getFilePath(Resource file)

_extractFileImageData

protected Map<String,Object> _extractFileImageData(Resource file)

Internal method to extract image specific data of a file

Parameters:

file - The file

Returns:

The image specific data

_extractFileRightData

protected Map<String,Object> _extractFileRightData(Resource file)

Internal method to extract the data concerning the right of the current user for file

Parameters:

file - The file

Returns:

The map of right data. Keys are the rights id, and values indicates whether the current user has the right or not.

_extractFileLockData

protected Map<String,Object> _extractFileLockData(Resource file)

Internal method to extract the data relative to the lock state of a file

Parameters:

file - The file

Returns:

The image specific data

_sanitizeFileTags

private List<String> _sanitizeFileTags(Collection<String> tags)
                                throws AmetysRepositoryException

Throws:

AmetysRepositoryException

_setComment

protected void _setComment(JCRPost comment,
                           String content)

Description copied from class: ExplorerResourcesDAO

Update the content of a comment

Overrides:

_setComment in class ExplorerResourcesDAO

Parameters:

comment - The comment to update

content - The content as string

_getComment

protected String _getComment(JCRPost post)
                      throws AmetysRepositoryException

Description copied from class: ExplorerResourcesDAO

Get the content of a comment as a String

Overrides:

_getComment in class ExplorerResourcesDAO

Parameters:

post - the post

Returns:

The content as String

Throws:

AmetysRepositoryException - if failed to parse comment

_getCommentForEditing

protected String _getCommentForEditing(JCRPost post)
                                throws AmetysRepositoryException

Description copied from class: ExplorerResourcesDAO

Get the content of a comment to edit as a String

Overrides:

_getCommentForEditing in class ExplorerResourcesDAO

Parameters:

post - the post

Returns:

The content as String

Throws:

AmetysRepositoryException - if failed to parse comment

_canView

protected boolean _canView(ResourceCollection folder)

Indicates if the current user can view the folder

Parameters:

folder - The folder to test

Returns:

true if the folder can be viewed

_canView

protected boolean _canView(Resource file)

Indicates if the current user can view the file

Parameters:

file - The file to test

Returns:

true if the file can be viewed

getCMISProperties

public Map<String,String> getCMISProperties(String id)

Description copied from class: ExplorerResourcesDAO

Get the CMIS properties of collection

Overrides:

getCMISProperties in class ExplorerResourcesDAO

Parameters:

id - The id of CMIS collection

Returns:

the CMIS properties to access CMIS repository

addCMISCollection

public Map<String,Object> addCMISCollection(String parentId,
                                            String originalName,
                                            String url,
                                            String login,
                                            String password,
                                            String repoId,
                                            boolean renameIfExists)

Description copied from class: ExplorerResourcesDAO

Creates a new CMIS folder (see CMISRootResourcesCollection)

Overrides:

addCMISCollection in class ExplorerResourcesDAO

Parameters:

parentId - the id of parent folder

originalName - the original name if CMIS folder

url - The url of CMIS repository

login - The user's login to access CMIS repository

password - The user's password to access CMIS repository

repoId - The id of CMIS repository

renameIfExists - true to automatically renamed CMIS folder if requested name already exists

Returns:

the result map with id of created node

editCMISCollection

public Map<String,Object> editCMISCollection(String id,
                                             String name,
                                             String url,
                                             String login,
                                             String password,
                                             String repoId)
                                      throws RepositoryException

Edits a CMIS folder (see CMISRootResourcesCollection)

Parameters:

id - the id of CMIS folder

name - The name of the CMIS folder

url - The url of CMIS repository

login - The user's login to access CMIS repository

password - The user's password to access CMIS repository

repoId - The id of CMIS repository

Returns:

the result map with id of edited node

Throws:

RepositoryException - If an error occurred

isCMISCollection

public boolean isCMISCollection(String id)

Description copied from class: ExplorerResourcesDAO

Determines if a object is a CMISRootResourcesCollection

Overrides:

isCMISCollection in class ExplorerResourcesDAO

Parameters:

id - The id of object

Returns:

true if it is a CMIS root folder

getDocumentsCount

public Long getDocumentsCount(Project project)

Count the total of documents in the project

Parameters:

project - The project

Returns:

The total of documents, or null if the module is not activated

_getChildDocumentsCount

private Long _getChildDocumentsCount(ResourceCollection collection)