Class WorkspaceExplorerResourceDAO

All Implemented Interfaces:
LogEnabled, PluginAware, Component, Contextualizable, Serviceable

DAO for resources of a project
  • Field Details

  • Constructor Details

  • Method Details

    • 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) 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
      Returns:
      The created folder or an error if a folder with same name already exists.
      Throws:
      IllegalAccessException - If the user has no sufficient rights
    • addFolder

      public Map<String,Object> addFolder(String parentId, String inputName, String description, Boolean renameIfExists)
      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
    • moveObjects

      public Map<String,Object> moveObjects(List<String> objectIds, String parentFolderId) throws javax.jcr.RepositoryException
      Move objects to parent folder
      Parameters:
      objectIds - the object ids to move
      parentFolderId - the parent folder id
      Returns:
      the results map
      Throws:
      javax.jcr.RepositoryException - if a repository exception occurred
    • renameFolder

      public Map<String,Object> renameFolder(String id, String name)
      Rename a folder
      Parameters:
      id - Identifier of the folder to edit
      name - The new name
      Returns:
      The result map with id and name keys
    • editFolder

      public Map<String,Object> editFolder(String id, String inputName, String description)
      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
    • deleteFolder

      Delete a folder
      Parameters:
      id - Identifier of the folder to delete
      Returns:
      The result map with the parent id key
    • lockResources

      Lock resources
      Parameters:
      ids - The id of resources to lock
      Returns:
      the result.
    • unlockResources

      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
    • renameFile

      public Map<String,Object> renameFile(String id, String name)
      Rename a folder
      Parameters:
      id - Identifier of the folder to edit
      name - The new name
      Returns:
      The result map with id and name keys
    • editFile

      public Map<String,Object> editFile(String id, String inputName, String description, Collection<String> tags)
      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
    • setTags

      public Map<String,Object> setTags(String resourceId, List<Object> tags)
      Set tags to resource
      Parameters:
      resourceId - the id of resources
      tags - the file tags to set
      Returns:
      the file tags
    • copyFiles

      public Map<String,Object> copyFiles(List<String> ids, String targetId) throws javax.jcr.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:
      javax.jcr.RepositoryException - If there is a repository error
    • moveDocuments

      public Map<String,Object> moveDocuments(List<String> ids, String targetId) throws javax.jcr.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:
      javax.jcr.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
    • searchFilesByType

      Search for files by their type
      Parameters:
      type - The file type
      Returns:
      A result map containing a resources entry which is a list of the files data
      Throws:
      Exception - if an exception occurs
    • getRootFolder

      Get the root folder
      Returns:
      the root folder as JSON object
    • getFolder

      public Map<String,Object> getFolder(String folderId)
      Get folder
      Parameters:
      folderId - the folder id
      Returns:
      the folder as JSON object
    • getFile

      public Map<String,Object> getFile(String resourceId)
      Get file
      Parameters:
      resourceId - the resource id
      Returns:
      the file as JSON object
    • getFolders

      public List<Map<String,Object>> getFolders(String parentId)
      Get the child folders
      Parameters:
      parentId - the parent id. Can be null to get root folders
      Returns:
      the sub folders
    • getFiles

      public List<Map<String,Object>> getFiles(String parentId)
      Get the child files
      Parameters:
      parentId - the parent id. Can be null to get root files
      Returns:
      the child files
    • getFileParentInfo

      Get the children folders and files of the folder owning the given file
      Parameters:
      fileId - the file id
      Returns:
      the children folders and files
    • getFoldersAndFiles

      Get the child folders and files
      Parameters:
      folderId - the parent id. Can be null to get root folders and files
      Returns:
      the child folders and files
    • getChildDocumentsData

      public List<Map<String,Object>> getChildDocumentsData(String parentId, boolean excludeFolders, boolean excludeFiles)
      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
      Returns:
      The map of information
    • getChildDocumentsData

      public List<Map<String,Object>> getChildDocumentsData(ResourceCollection document, boolean excludeFolders, boolean excludeFiles)
      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
      Returns:
      The map of information
    • getDocumentData

      @Deprecated public Map<String,Object> getDocumentData(String id, boolean excludeFilesInFolderHierarchy)
      Deprecated.
      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
    • _extractDocumentData

      protected Map<String,Object> _extractDocumentData(AmetysObject document, boolean excludeFolders, boolean excludeFiles)
      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
      Returns:
      the valuable document data
    • _extractFolderData

      Internal method to extract the valuable data of a folder
      Parameters:
      folder - The folder
      Returns:
      the valuable folder data
    • _hasChildren

      protected boolean _hasChildren(ResourceCollection folder, boolean ignoreFiles)
      Internal method to detect if a document has child
      Parameters:
      folder - The folder
      ignoreFiles - Should child files be taken into account to compute the 'hasChildDocuments' data.
      Returns:
      the valuable folder data
    • _extractFolderRightData

      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)
      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
    • addFile

      public Map<String,Object> addFile(InputStream inputStream, String fileName, String parentId, boolean unarchive, boolean allowRename, boolean allowUpdate)
      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
    • _extractFileData

      Internal method to extract the valuable data of a file
      Parameters:
      file - The file
      Returns:
      the valuable file data
    • _extractFileRightData

      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

      Internal method to extract the data relative to the lock state of a file
      Parameters:
      file - The file
      Returns:
      The image specific data
    • _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

      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

      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

      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, String mountPoint, 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
      mountPoint - The mount point in the server
      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, String mountPoint) throws javax.jcr.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
      mountPoint - The mount point to use for the repository
      Returns:
      the result map with id of edited node
      Throws:
      javax.jcr.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
    • createFile

      public Map<String,Object> createFile(String folderId, String type) throws Exception
      Create a file
      Parameters:
      folderId - the folder parent id
      type - the type of file (word, excel, powerpoint, ...)
      Returns:
      the new file properties
      Throws:
      Exception - if an error occurred
    • _comment2json

      protected Map<String,Object> _comment2json(JCRPost comment, boolean isEdition)
      Description copied from class: ExplorerResourcesDAO
      Get JSOn representation of a comment
      Overrides:
      _comment2json in class ExplorerResourcesDAO
      Parameters:
      comment - The comment
      isEdition - true to get the comment in edit mode
      Returns:
      the comment as JSON