Class DLAppServiceWrapper

Object
com.liferay.document.library.kernel.service.DLAppServiceWrapper
All Implemented Interfaces:
DLAppService, BaseService, ServiceWrapper<DLAppService>

public class DLAppServiceWrapper extends Object implements DLAppService, ServiceWrapper<DLAppService>
Provides a wrapper for DLAppService.
Author:
Brian Wing Shun Chan
See Also:
{$generated.description}
  • Constructor Details

    • DLAppServiceWrapper

      public DLAppServiceWrapper()
    • DLAppServiceWrapper

      public DLAppServiceWrapper(DLAppService dlAppService)
  • Method Details

    • addFileEntry

      @Deprecated public FileEntry addFileEntry(long repositoryId, long folderId, String sourceFileName, String mimeType, String title, String description, String changeLog, File file, ServiceContext serviceContext) throws PortalException
      Adds a file entry and associated metadata. It is created based on a File object.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal. If it is null, the sourceFileName will be used.

      Specified by:
      addFileEntry in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the file entry's parent folder
      sourceFileName - the original file's name
      mimeType - the file's MIME type
      title - the name to be assigned to the file (optionally null )
      description - the file's description
      changeLog - the file's version change log
      file - the file's data (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addFileEntry

      public FileEntry addFileEntry(String externalReferenceCode, long repositoryId, long folderId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, byte[] bytes, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Adds a file entry and associated metadata. It is created based on a byte array.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal. If it is null, the sourceFileName will be used.

      Specified by:
      addFileEntry in interface DLAppService
      Parameters:
      externalReferenceCode - the file entry's external reference code
      repositoryId - the primary key of the repository
      folderId - the primary key of the file entry's parent folder
      sourceFileName - the original file's name
      mimeType - the file's MIME type
      title - the name to be assigned to the file (optionally null )
      urlTitle - the url title
      description - the file's description
      changeLog - the file's version change log
      bytes - the file's data (optionally null)
      displayDate - the file's display date (optionally null)
      expirationDate - the file's expiration date (optionally null )
      reviewDate - the file's review Date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addFileEntry

      public FileEntry addFileEntry(String externalReferenceCode, long repositoryId, long folderId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, File file, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Adds a file entry and associated metadata. It is created based on a File object.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal. If it is null, the sourceFileName will be used.

      Specified by:
      addFileEntry in interface DLAppService
      Parameters:
      externalReferenceCode - the file entry's external reference code.
      repositoryId - the primary key of the repository
      folderId - the primary key of the file entry's parent folder
      sourceFileName - the original file's name
      mimeType - the file's MIME type
      title - the name to be assigned to the file (optionally null )
      description - the file's description
      changeLog - the file's version change log
      file - the file's data (optionally null)
      displayDate - the file's display date (optionally null)
      expirationDate - the file's expiration date (optionally null )
      reviewDate - the file's review Date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addFileEntry

      public FileEntry addFileEntry(String externalReferenceCode, long repositoryId, long folderId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, InputStream inputStream, long size, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Adds a file entry and associated metadata. It is created based on a InputStream object.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal. If it is null, the sourceFileName will be used.

      Specified by:
      addFileEntry in interface DLAppService
      Parameters:
      externalReferenceCode - the file entry's external reference code.
      repositoryId - the primary key of the repository
      folderId - the primary key of the file entry's parent folder
      sourceFileName - the original file's name
      mimeType - the file's MIME type
      title - the name to be assigned to the file (optionally null )
      description - the file's description
      changeLog - the file's version change log
      inputStream - the file's data (optionally null)
      size - the file's size (optionally 0)
      displayDate - the file's display date (optionally null)
      expirationDate - the file's expiration date (optionally null)
      reviewDate - the file's review Date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addFileShortcut

      public FileShortcut addFileShortcut(String externalReferenceCode, long repositoryId, long folderId, long toFileEntryId, ServiceContext serviceContext) throws PortalException
      Adds a file shortcut to the existing file entry. This method is only supported by the Liferay repository.
      Specified by:
      addFileShortcut in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the file shortcut's parent folder
      toFileEntryId - the primary key of the file shortcut's file entry
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry.
      Returns:
      the file shortcut
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addFolder

      public Folder addFolder(String externalReferenceCode, long repositoryId, long parentFolderId, String name, String description, ServiceContext serviceContext) throws PortalException
      Adds a folder.
      Specified by:
      addFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      parentFolderId - the primary key of the folder's parent folder
      name - the folder's name
      description - the folder's description
      serviceContext - the service context to be applied. In a Liferay repository, it may include boolean mountPoint specifying whether folder is a facade for mounting a third-party repository
      Returns:
      the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • addTempFileEntry

      public FileEntry addTempFileEntry(long groupId, long folderId, String folderName, String fileName, File file, String mimeType) throws PortalException
      Adds a temporary file entry.

      This allows a client to upload a file into a temporary location and manipulate its metadata prior to making it available for public usage. This is different from checking in and checking out a file entry.

      Specified by:
      addTempFileEntry in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      folderId - the primary key of the folder where the file entry will eventually reside
      folderName - the temporary folder's name
      fileName - the file's original name
      file - the file's data (optionally null)
      mimeType - the file's MIME type
      Returns:
      the temporary file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
      • TempFileEntryUtil
    • addTempFileEntry

      public FileEntry addTempFileEntry(long groupId, long folderId, String folderName, String fileName, InputStream inputStream, String mimeType) throws PortalException
      Adds a temporary file entry. It is created based on the InputStream object.

      This allows a client to upload a file into a temporary location and manipulate its metadata prior to making it available for public usage. This is different from checking in and checking out a file entry.

      Specified by:
      addTempFileEntry in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      folderId - the primary key of the folder where the file entry will eventually reside
      folderName - the temporary folder's name
      fileName - the file's original name
      inputStream - the file's data
      mimeType - the file's MIME type
      Returns:
      the temporary file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
      • TempFileEntryUtil
    • cancelCheckOut

      public void cancelCheckOut(long fileEntryId) throws PortalException
      Cancels the check out of the file entry. If a user has not checked out the specified file entry, invoking this method will result in no changes.

      When a file entry is checked out, a PWC (private working copy) is created and the original file entry is locked. A client can make as many changes to the PWC as he desires without those changes being visible to other users. If the user is satisfied with the changes, he may elect to check in his changes, resulting in a new file version based on the PWC; the PWC will be removed and the file entry will be unlocked. If the user is not satisfied with the changes, he may elect to cancel his check out; this results in the deletion of the PWC and unlocking of the file entry.

      Specified by:
      cancelCheckOut in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry to cancel the checkout
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • checkInFileEntry

      public void checkInFileEntry(long fileEntryId, DLVersionNumberIncrease dlVersionNumberIncrease, String changeLog, ServiceContext serviceContext) throws PortalException
      Checks in the file entry. If a user has not checked out the specified file entry, invoking this method will result in no changes.

      When a file entry is checked out, a PWC (private working copy) is created and the original file entry is locked. A client can make as many changes to the PWC as he desires without those changes being visible to other users. If the user is satisfied with the changes, he may elect to check in his changes, resulting in a new file version based on the PWC; the PWC will be removed and the file entry will be unlocked. If the user is not satisfied with the changes, he may elect to cancel his check out; this results in the deletion of the PWC and unlocking of the file entry.

      Specified by:
      checkInFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry to check in
      dlVersionNumberIncrease - the kind of version number increase to apply for these changes.
      changeLog - the file's version change log
      serviceContext - the service context to be applied
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • checkInFileEntry

      public void checkInFileEntry(long fileEntryId, String lockUuid, ServiceContext serviceContext) throws PortalException
      Checks in the file entry using the lock's UUID. If a user has not checked out the specified file entry, invoking this method will result in no changes. This method is primarily used by WebDAV.

      When a file entry is checked out, a PWC (private working copy) is created and the original file entry is locked. A client can make as many changes to the PWC as he desires without those changes being visible to other users. If the user is satisfied with the changes, he may elect to check in his changes, resulting in a new file version based on the PWC; the PWC will be removed and the file entry will be unlocked. If the user is not satisfied with the changes, he may elect to cancel his check out; this results in the deletion of the PWC and unlocking of the file entry.

      Specified by:
      checkInFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry to check in
      lockUuid - the lock's UUID
      serviceContext - the service context to be applied
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • checkOutFileEntry

      public void checkOutFileEntry(long fileEntryId, ServiceContext serviceContext) throws PortalException
      Check out a file entry.

      When a file entry is checked out, a PWC (private working copy) is created and the original file entry is locked. A client can make as many changes to the PWC as he desires without those changes being visible to other users. If the user is satisfied with the changes, he may elect to check in his changes, resulting in a new file version based on the PWC; the PWC will be removed and the file entry will be unlocked. If the user is not satisfied with the changes, he may elect to cancel his check out; this results in the deletion of the PWC and unlocking of the file entry.

      Specified by:
      checkOutFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the file entry to check out
      serviceContext - the service context to be applied
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • checkOutFileEntry

      public FileEntry checkOutFileEntry(long fileEntryId, String owner, long expirationTime, ServiceContext serviceContext) throws PortalException
      Checks out the file entry. This method is primarily used by WebDAV.

      When a file entry is checked out, a PWC (private working copy) is created and the original file entry is locked. A client can make as many changes to the PWC as he desires without those changes being visible to other users. If the user is satisfied with the changes, he may elect to check in his changes, resulting in a new file version based on the PWC; the PWC will be removed and the file entry will be unlocked. If the user is not satisfied with the changes, he may elect to cancel his check out; this results in the deletion of the PWC and unlocking of the file entry.

      Specified by:
      checkOutFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the file entry to check out
      owner - the owner string for the checkout (optionally null)
      expirationTime - the time in milliseconds before the lock expires. If the value is 0, the default expiration time will be used from portal.properties.
      serviceContext - the service context to be applied
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • copyFileEntry

      public FileEntry copyFileEntry(long fileEntryId, long destinationFolderId, long destinationRepositoryId, long fileEntryTypeId, long[] groupIds, ServiceContext serviceContext) throws PortalException
      Specified by:
      copyFileEntry in interface DLAppService
      Throws:
      PortalException
    • copyFileShortcut

      public FileShortcut copyFileShortcut(long fileShortcutId, long destinationFolderId, long destinationRepositoryId, ServiceContext serviceContext) throws PortalException
      Specified by:
      copyFileShortcut in interface DLAppService
      Throws:
      PortalException
    • copyFolder

      public Folder copyFolder(long sourceRepositoryId, long sourceFolderId, long destinationRepositoryId, long destinationParentFolderId, Map<Long,Long> fileEntryTypeIds, long[] groupIds, ServiceContext serviceContext) throws PortalException
      Specified by:
      copyFolder in interface DLAppService
      Throws:
      PortalException
    • copyFolder

      public Folder copyFolder(long repositoryId, long sourceFolderId, long parentFolderId, String name, String description, ServiceContext serviceContext) throws PortalException
      Performs a deep copy of the folder.
      Specified by:
      copyFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      sourceFolderId - the primary key of the folder to copy
      parentFolderId - the primary key of the new folder's parent folder
      name - the new folder's name
      description - the new folder's description
      serviceContext - the service context to be applied
      Returns:
      the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFileEntry

      public void deleteFileEntry(long fileEntryId) throws PortalException
      Deletes the file entry with the primary key.
      Specified by:
      deleteFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFileEntryByExternalReferenceCode

      public void deleteFileEntryByExternalReferenceCode(String externalReferenceCode, long groupId) throws PortalException
      Specified by:
      deleteFileEntryByExternalReferenceCode in interface DLAppService
      Throws:
      PortalException
    • deleteFileEntryByTitle

      public void deleteFileEntryByTitle(long repositoryId, long folderId, String title) throws PortalException
      Deletes the file entry with the title in the folder.
      Specified by:
      deleteFileEntryByTitle in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the file entry's parent folder
      title - the file entry's title
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFileShortcut

      public void deleteFileShortcut(long fileShortcutId) throws PortalException
      Deletes the file shortcut with the primary key. This method is only supported by the Liferay repository.
      Specified by:
      deleteFileShortcut in interface DLAppService
      Parameters:
      fileShortcutId - the primary key of the file shortcut
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFileShortcutByExternalReferenceCode

      public void deleteFileShortcutByExternalReferenceCode(String externalReferenceCode, long groupId) throws PortalException
      Specified by:
      deleteFileShortcutByExternalReferenceCode in interface DLAppService
      Throws:
      PortalException
    • deleteFileVersion

      public void deleteFileVersion(long fileVersionId) throws PortalException
      Deletes the file version. File versions can only be deleted if it is approved and there are other approved file versions available.
      Specified by:
      deleteFileVersion in interface DLAppService
      Parameters:
      fileVersionId - the primary key of the file version
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFileVersion

      public void deleteFileVersion(long fileEntryId, String version) throws PortalException
      Deletes the file version. File versions can only be deleted if it is approved and there are other approved file versions available. This method is only supported by the Liferay repository.
      Specified by:
      deleteFileVersion in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      version - the version label of the file version
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFolder

      public void deleteFolder(long folderId) throws PortalException
      Deletes the folder with the primary key and all of its subfolders and file entries.
      Specified by:
      deleteFolder in interface DLAppService
      Parameters:
      folderId - the primary key of the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteFolder

      public void deleteFolder(long repositoryId, long parentFolderId, String name) throws PortalException
      Deletes the folder with the name in the parent folder and all of its subfolders and file entries.
      Specified by:
      deleteFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      parentFolderId - the primary key of the folder's parent folder
      name - the folder's name
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • deleteTempFileEntry

      public void deleteTempFileEntry(long groupId, long folderId, String folderName, String fileName) throws PortalException
      Deletes the temporary file entry.
      Specified by:
      deleteTempFileEntry in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      folderId - the primary key of the folder where the file entry was eventually to reside
      folderName - the temporary folder's name
      fileName - the file's original name
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
      • TempFileEntryUtil
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId) throws PortalException
      Returns all the file entries in the folder.
      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      Returns:
      the file entries in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, int start, int end) throws PortalException
      Returns a name-ordered range of all the file entries in the folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of file entries in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Returns an ordered range of all the file entries in the folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the file entries (optionally null)
      Returns:
      the range of file entries in the folder ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, long fileEntryTypeId) throws PortalException
      Returns the file entries with the file entry type in the folder.
      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      fileEntryTypeId - the primary key of the file entry type
      Returns:
      the file entries with the file entry type in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, long fileEntryTypeId, int start, int end) throws PortalException
      Returns a name-ordered range of all the file entries with the file entry type in the folder.
      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      fileEntryTypeId - the primary key of the file entry type
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of the file entries in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, long fileEntryTypeId, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Returns an ordered range of all the file entries with the file entry type in the folder.
      Specified by:
      getFileEntries in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      fileEntryTypeId - the primary key of the file entry type
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the results by (optionally null)
      Returns:
      the range of file entries with the file entry type in the folder ordered by null
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, String[] mimeTypes) throws PortalException
      Specified by:
      getFileEntries in interface DLAppService
      Throws:
      PortalException
    • getFileEntries

      public List<FileEntry> getFileEntries(long repositoryId, long folderId, String[] mimeTypes, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Specified by:
      getFileEntries in interface DLAppService
      Throws:
      PortalException
    • getFileEntriesAndFileShortcuts

      public List<Object> getFileEntriesAndFileShortcuts(long repositoryId, long folderId, int status, int start, int end) throws PortalException
      Returns a range of all the file entries and shortcuts in the folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFileEntriesAndFileShortcuts in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      status - the workflow status
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the range of file entries and shortcuts in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntriesAndFileShortcutsCount

      public int getFileEntriesAndFileShortcutsCount(long repositoryId, long folderId, int status) throws PortalException
      Returns the number of file entries and shortcuts in the folder.
      Specified by:
      getFileEntriesAndFileShortcutsCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      status - the workflow status
      Returns:
      the number of file entries and shortcuts in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntriesAndFileShortcutsCount

      public int getFileEntriesAndFileShortcutsCount(long repositoryId, long folderId, int status, String[] mimeTypes) throws PortalException
      Returns the number of file entries and shortcuts in the folder.
      Specified by:
      getFileEntriesAndFileShortcutsCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      status - the workflow status
      mimeTypes - allowed media types
      Returns:
      the number of file entries and shortcuts in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntriesCount

      public int getFileEntriesCount(long repositoryId, long folderId) throws PortalException
      Returns the number of file entries in the folder.
      Specified by:
      getFileEntriesCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      Returns:
      the number of file entries in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntriesCount

      public int getFileEntriesCount(long repositoryId, long folderId, long fileEntryTypeId) throws PortalException
      Returns the number of file entries with the file entry type in the folder.
      Specified by:
      getFileEntriesCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the file entry's repository
      folderId - the primary key of the file entry's folder
      fileEntryTypeId - the primary key of the file entry type
      Returns:
      the number of file entries with the file entry type in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntriesCount

      public int getFileEntriesCount(long repositoryId, long folderId, String[] mimeTypes) throws PortalException
      Specified by:
      getFileEntriesCount in interface DLAppService
      Throws:
      PortalException
    • getFileEntry

      public FileEntry getFileEntry(long fileEntryId) throws PortalException
      Returns the file entry with the primary key.
      Specified by:
      getFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      Returns:
      the file entry with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntry

      public FileEntry getFileEntry(long groupId, long folderId, String title) throws PortalException
      Returns the file entry with the title in the folder.
      Specified by:
      getFileEntry in interface DLAppService
      Parameters:
      groupId - the primary key of the file entry's group
      folderId - the primary key of the file entry's folder
      title - the file entry's title
      Returns:
      the file entry with the title in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntryByExternalReferenceCode

      public FileEntry getFileEntryByExternalReferenceCode(String externalReferenceCode, long groupId) throws PortalException
      Returns the file entry with the external reference code.
      Specified by:
      getFileEntryByExternalReferenceCode in interface DLAppService
      Parameters:
      groupId - the primary key of the file entry's group
      externalReferenceCode - the file entry's external reference code
      Returns:
      the file entry with the external reference code
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntryByFileName

      public FileEntry getFileEntryByFileName(long groupId, long folderId, String fileName) throws PortalException
      Returns the file entry with the file name in the folder.
      Specified by:
      getFileEntryByFileName in interface DLAppService
      Parameters:
      groupId - the primary key of the file entry's group
      folderId - the primary key of the file entry's folder
      fileName - the file entry's file name
      Returns:
      the file entry with the file name in the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileEntryByUuidAndGroupId

      public FileEntry getFileEntryByUuidAndGroupId(String uuid, long groupId) throws PortalException
      Returns the file entry with the UUID and group.
      Specified by:
      getFileEntryByUuidAndGroupId in interface DLAppService
      Parameters:
      uuid - the file entry's UUID
      groupId - the primary key of the file entry's group
      Returns:
      the file entry with the UUID and group
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileShortcut

      public FileShortcut getFileShortcut(long fileShortcutId) throws PortalException
      Returns the file shortcut with the primary key. This method is only supported by the Liferay repository.
      Specified by:
      getFileShortcut in interface DLAppService
      Parameters:
      fileShortcutId - the primary key of the file shortcut
      Returns:
      the file shortcut with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFileShortcutByExternalReferenceCode

      public FileShortcut getFileShortcutByExternalReferenceCode(String externalReferenceCode, long groupId) throws PortalException
      Specified by:
      getFileShortcutByExternalReferenceCode in interface DLAppService
      Throws:
      PortalException
    • getFileVersion

      public FileVersion getFileVersion(long fileVersionId) throws PortalException
      Returns the file version with the primary key.
      Specified by:
      getFileVersion in interface DLAppService
      Parameters:
      fileVersionId - the primary key of the file version
      Returns:
      the file version with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolder

      public Folder getFolder(long folderId) throws PortalException
      Returns the folder with the primary key.
      Specified by:
      getFolder in interface DLAppService
      Parameters:
      folderId - the primary key of the folder
      Returns:
      the folder with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolder

      public Folder getFolder(long repositoryId, long parentFolderId, String name) throws PortalException
      Returns the folder with the name in the parent folder.
      Specified by:
      getFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      name - the folder's name
      Returns:
      the folder with the name in the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolderByExternalReferenceCode

      public Folder getFolderByExternalReferenceCode(String externalReferenceCode, long groupId) throws PortalException
      Specified by:
      getFolderByExternalReferenceCode in interface DLAppService
      Throws:
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId) throws PortalException
      Returns all immediate subfolders of the parent folder.
      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      Returns:
      the immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, boolean includeMountFolders) throws PortalException
      Returns all immediate subfolders of the parent folder, optionally including mount folders for third-party repositories.
      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      includeMountFolders - whether to include mount folders for third-party repositories
      Returns:
      the immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, boolean includeMountFolders, int start, int end) throws PortalException
      Returns a name-ordered range of all the immediate subfolders of the parent folder, optionally including mount folders for third-party repositories.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      includeMountFolders - whether to include mount folders for third-party repositories
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, boolean includeMountFolders, int start, int end, OrderByComparator<Folder> orderByComparator) throws PortalException
      Returns an ordered range of all the immediate subfolders of the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      includeMountFolders - whether to include mount folders for third-party repositories
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the folders (optionally null)
      Returns:
      the range of immediate subfolders of the parent folder ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, int status, boolean includeMountFolders, int start, int end, OrderByComparator<Folder> orderByComparator) throws PortalException
      Returns an ordered range of all the immediate subfolders of the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      status - the workflow status
      includeMountFolders - whether to include mount folders for third-party repositories
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the folders (optionally null)
      Returns:
      the range of immediate subfolders of the parent folder ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, int start, int end) throws PortalException
      Returns a name-ordered range of all the immediate subfolders of the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFolders

      public List<Folder> getFolders(long repositoryId, long parentFolderId, int start, int end, OrderByComparator<Folder> orderByComparator) throws PortalException
      Returns an ordered range of all the immediate subfolders of the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the folders (optionally null)
      Returns:
      the range of immediate subfolders of the parent folder ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersAndFileEntriesAndFileShortcuts

      public List<Object> getFoldersAndFileEntriesAndFileShortcuts(long repositoryId, long folderId, int status, boolean includeMountFolders, int start, int end) throws PortalException
      Returns a name-ordered range of all the immediate subfolders, file entries, and file shortcuts in the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFoldersAndFileEntriesAndFileShortcuts in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the parent folder
      status - the workflow status
      includeMountFolders - whether to include mount folders for third-party repositories
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of immediate subfolders, file entries, and file shortcuts in the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersAndFileEntriesAndFileShortcuts

      public List<Object> getFoldersAndFileEntriesAndFileShortcuts(long repositoryId, long folderId, int status, boolean includeMountFolders, int start, int end, OrderByComparator<?> orderByComparator) throws PortalException
      Returns an ordered range of all the immediate subfolders, file entries, and file shortcuts in the parent folder.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getFoldersAndFileEntriesAndFileShortcuts in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the parent folder
      status - the workflow status
      includeMountFolders - whether to include mount folders for third-party repositories
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the results (optionally null)
      Returns:
      the range of immediate subfolders, file entries, and file shortcuts in the parent folder ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersAndFileEntriesAndFileShortcuts

      public List<Object> getFoldersAndFileEntriesAndFileShortcuts(long repositoryId, long folderId, int status, String[] mimeTypes, boolean includeMountFolders, boolean includeOwner, int start, int end, OrderByComparator<?> orderByComparator) throws PortalException
      Specified by:
      getFoldersAndFileEntriesAndFileShortcuts in interface DLAppService
      Throws:
      PortalException
    • getFoldersAndFileEntriesAndFileShortcuts

      public List<Object> getFoldersAndFileEntriesAndFileShortcuts(long repositoryId, long folderId, int status, String[] mimeTypes, boolean includeMountFolders, int start, int end, OrderByComparator<?> orderByComparator) throws PortalException
      Specified by:
      getFoldersAndFileEntriesAndFileShortcuts in interface DLAppService
      Throws:
      PortalException
    • getFoldersAndFileEntriesAndFileShortcutsCount

      public int getFoldersAndFileEntriesAndFileShortcutsCount(long repositoryId, long folderId, int status, boolean includeMountFolders) throws PortalException
      Returns the number of immediate subfolders, file entries, and file shortcuts in the parent folder.
      Specified by:
      getFoldersAndFileEntriesAndFileShortcutsCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the parent folder
      status - the workflow status
      includeMountFolders - whether to include mount folders for third-party repositories
      Returns:
      the number of immediate subfolders, file entries, and file shortcuts in the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersAndFileEntriesAndFileShortcutsCount

      public int getFoldersAndFileEntriesAndFileShortcutsCount(long repositoryId, long folderId, int status, String[] mimeTypes, boolean includeMountFolders) throws PortalException
      Specified by:
      getFoldersAndFileEntriesAndFileShortcutsCount in interface DLAppService
      Throws:
      PortalException
    • getFoldersAndFileEntriesAndFileShortcutsCount

      public int getFoldersAndFileEntriesAndFileShortcutsCount(long repositoryId, long folderId, int status, String[] mimeTypes, boolean includeMountFolders, boolean includeOwner) throws PortalException
      Specified by:
      getFoldersAndFileEntriesAndFileShortcutsCount in interface DLAppService
      Throws:
      PortalException
    • getFoldersCount

      public int getFoldersCount(long repositoryId, long parentFolderId) throws PortalException
      Returns the number of immediate subfolders of the parent folder.
      Specified by:
      getFoldersCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      Returns:
      the number of immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersCount

      public int getFoldersCount(long repositoryId, long parentFolderId, boolean includeMountFolders) throws PortalException
      Returns the number of immediate subfolders of the parent folder, optionally including mount folders for third-party repositories.
      Specified by:
      getFoldersCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      includeMountFolders - whether to include mount folders for third-party repositories
      Returns:
      the number of immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersCount

      public int getFoldersCount(long repositoryId, long parentFolderId, int status, boolean includeMountFolders) throws PortalException
      Returns the number of immediate subfolders of the parent folder, optionally including mount folders for third-party repositories.
      Specified by:
      getFoldersCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      status - the workflow status
      includeMountFolders - whether to include mount folders for third-party repositories
      Returns:
      the number of immediate subfolders of the parent folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getFoldersFileEntriesCount

      public int getFoldersFileEntriesCount(long repositoryId, List<Long> folderIds, int status) throws PortalException
      Returns the number of immediate subfolders and file entries across the folders.
      Specified by:
      getFoldersFileEntriesCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderIds - the primary keys of folders from which to count immediate subfolders and file entries
      status - the workflow status
      Returns:
      the number of immediate subfolders and file entries across the folders
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntries

      public List<FileEntry> getGroupFileEntries(long groupId, long userId, int start, int end) throws PortalException
      Returns an ordered range of all the file entries in the group starting at the repository default parent folder that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getGroupFileEntries in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the range of matching file entries ordered by date modified
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntries

      public List<FileEntry> getGroupFileEntries(long groupId, long userId, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Returns an ordered range of all the file entries in the group that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getGroupFileEntries in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the file entries (optionally null)
      Returns:
      the range of matching file entries ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntries

      public List<FileEntry> getGroupFileEntries(long groupId, long userId, long rootFolderId, int start, int end) throws PortalException
      Returns an ordered range of all the file entries in the group starting at the root folder that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getGroupFileEntries in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      rootFolderId - the primary key of the root folder to begin the search
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the range of matching file entries ordered by date modified
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntries

      public List<FileEntry> getGroupFileEntries(long groupId, long userId, long rootFolderId, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Returns an ordered range of all the file entries in the group starting at the root folder that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getGroupFileEntries in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      rootFolderId - the primary key of the root folder to begin the search
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the file entries (optionally null)
      Returns:
      the range of matching file entries ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntries

      public List<FileEntry> getGroupFileEntries(long groupId, long userId, long rootFolderId, String[] mimeTypes, int status, int start, int end, OrderByComparator<FileEntry> orderByComparator) throws PortalException
      Specified by:
      getGroupFileEntries in interface DLAppService
      Throws:
      PortalException
    • getGroupFileEntriesCount

      public int getGroupFileEntriesCount(long groupId, long userId) throws PortalException
      Returns the number of file entries in a group starting at the repository default parent folder that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.
      Specified by:
      getGroupFileEntriesCount in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      Returns:
      the number of matching file entries
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntriesCount

      public int getGroupFileEntriesCount(long groupId, long userId, long rootFolderId) throws PortalException
      Returns the number of file entries in a group starting at the root folder that are stored within the Liferay repository. This method is primarily used to search for recently modified file entries. It can be limited to the file entries modified by a given user.
      Specified by:
      getGroupFileEntriesCount in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      userId - the primary key of the user who created the file (optionally 0)
      rootFolderId - the primary key of the root folder to begin the search
      Returns:
      the number of matching file entries
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getGroupFileEntriesCount

      public int getGroupFileEntriesCount(long groupId, long userId, long rootFolderId, String[] mimeTypes, int status) throws PortalException
      Specified by:
      getGroupFileEntriesCount in interface DLAppService
      Throws:
      PortalException
    • getGroupFileShortcuts

      public List<FileShortcut> getGroupFileShortcuts(long groupId) throws PortalException
      Specified by:
      getGroupFileShortcuts in interface DLAppService
      Throws:
      PortalException
    • getMountFolders

      public List<Folder> getMountFolders(long repositoryId, long parentFolderId) throws PortalException
      Returns all immediate subfolders of the parent folder that are used for mounting third-party repositories. This method is only supported by the Liferay repository.
      Specified by:
      getMountFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      Returns:
      the immediate subfolders of the parent folder that are used for mounting third-party repositories
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getMountFolders

      public List<Folder> getMountFolders(long repositoryId, long parentFolderId, int start, int end) throws PortalException
      Returns a name-ordered range of all the immediate subfolders of the parent folder that are used for mounting third-party repositories. This method is only supported by the Liferay repository.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getMountFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      parentFolderId - the primary key of the parent folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      Returns:
      the name-ordered range of immediate subfolders of the parent folder that are used for mounting third-party repositories
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getMountFolders

      public List<Folder> getMountFolders(long repositoryId, long parentFolderId, int start, int end, OrderByComparator<Folder> orderByComparator) throws PortalException
      Returns an ordered range of all the immediate subfolders of the parent folder that are used for mounting third-party repositories. This method is only supported by the Liferay repository.

      Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil#ALL_POS will return the full result set.

      Specified by:
      getMountFolders in interface DLAppService
      Parameters:
      repositoryId - the primary key of the folder's repository
      parentFolderId - the primary key of the folder's parent folder
      start - the lower bound of the range of results
      end - the upper bound of the range of results (not inclusive)
      orderByComparator - the comparator to order the folders (optionally null)
      Returns:
      the range of immediate subfolders of the parent folder that are used for mounting third-party repositories ordered by comparator orderByComparator
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getMountFoldersCount

      public int getMountFoldersCount(long repositoryId, long parentFolderId) throws PortalException
      Returns the number of immediate subfolders of the parent folder that are used for mounting third-party repositories. This method is only supported by the Liferay repository.
      Specified by:
      getMountFoldersCount in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      parentFolderId - the primary key of the parent folder
      Returns:
      the number of folders of the parent folder that are used for mounting third-party repositories
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getOSGiServiceIdentifier

      public String getOSGiServiceIdentifier()
      Returns the OSGi service identifier.
      Specified by:
      getOSGiServiceIdentifier in interface DLAppService
      Returns:
      the OSGi service identifier
    • getSubfolderIds

      public void getSubfolderIds(long repositoryId, List<Long> folderIds, long folderId) throws PortalException
      Specified by:
      getSubfolderIds in interface DLAppService
      Throws:
      PortalException
    • getSubfolderIds

      public List<Long> getSubfolderIds(long repositoryId, long folderId) throws PortalException
      Returns all the descendant folders of the folder with the primary key.
      Specified by:
      getSubfolderIds in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      Returns:
      the descendant folders of the folder with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getSubfolderIds

      public List<Long> getSubfolderIds(long repositoryId, long folderId, boolean recurse) throws PortalException
      Returns descendant folders of the folder with the primary key, optionally limiting to one level deep.
      Specified by:
      getSubfolderIds in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      recurse - whether to recurse through each subfolder
      Returns:
      the descendant folders of the folder with the primary key
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getTempFileNames

      public String[] getTempFileNames(long groupId, long folderId, String folderName) throws PortalException
      Returns all the temporary file entry names.
      Specified by:
      getTempFileNames in interface DLAppService
      Parameters:
      groupId - the primary key of the group
      folderId - the primary key of the folder where the file entry will eventually reside
      folderName - the temporary folder's name
      Returns:
      the temporary file entry names
      Throws:
      PortalException - if a portal exception occurred
      PortalException
      See Also:
    • lockFolder

      public Lock lockFolder(long repositoryId, long folderId) throws PortalException
      Locks the folder. This method is primarily used by WebDAV.
      Specified by:
      lockFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      Returns:
      the lock object
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • lockFolder

      public Lock lockFolder(long repositoryId, long folderId, String owner, boolean inheritable, long expirationTime) throws PortalException
      Locks the folder. This method is primarily used by WebDAV.
      Specified by:
      lockFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      owner - the owner string for the checkout (optionally null)
      inheritable - whether the lock must propagate to descendants
      expirationTime - the time in milliseconds before the lock expires. If the value is 0, the default expiration time will be used from portal.properties.
      Returns:
      the lock object
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • moveFileEntry

      public FileEntry moveFileEntry(long fileEntryId, long newFolderId, ServiceContext serviceContext) throws PortalException
      Moves the file entry to the new folder.
      Specified by:
      moveFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      newFolderId - the primary key of the new folder
      serviceContext - the service context to be applied
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • moveFolder

      public Folder moveFolder(long folderId, long parentFolderId, ServiceContext serviceContext) throws PortalException
      Moves the folder to the new parent folder with the primary key.
      Specified by:
      moveFolder in interface DLAppService
      Parameters:
      folderId - the primary key of the folder
      parentFolderId - the primary key of the new parent folder
      serviceContext - the service context to be applied
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • refreshFileEntryLock

      public Lock refreshFileEntryLock(String lockUuid, long companyId, long expirationTime) throws PortalException
      Refreshes the lock for the file entry. This method is primarily used by WebDAV.
      Specified by:
      refreshFileEntryLock in interface DLAppService
      Parameters:
      lockUuid - the lock's UUID
      companyId - the primary key of the file entry's company
      expirationTime - the time in milliseconds before the lock expires. If the value is 0, the default expiration time will be used from portal.properties.
      Returns:
      the lock object
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • refreshFolderLock

      public Lock refreshFolderLock(String lockUuid, long companyId, long expirationTime) throws PortalException
      Refreshes the lock for the folder. This method is primarily used by WebDAV.
      Specified by:
      refreshFolderLock in interface DLAppService
      Parameters:
      lockUuid - the lock's UUID
      companyId - the primary key of the file entry's company
      expirationTime - the time in milliseconds before the lock expires. If the value is 0, the default expiration time will be used from portal.properties.
      Returns:
      the lock object
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • revertFileEntry

      public void revertFileEntry(long fileEntryId, String version, ServiceContext serviceContext) throws PortalException
      Reverts the file entry to a previous version. A new version will be created based on the previous version and metadata.
      Specified by:
      revertFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      version - the version to revert back to
      serviceContext - the service context to be applied
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • search

      public Hits search(long repositoryId, long creatorUserId, int status, int start, int end) throws PortalException
      Specified by:
      search in interface DLAppService
      Throws:
      PortalException
    • search

      public Hits search(long repositoryId, long creatorUserId, long folderId, String[] mimeTypes, int status, int start, int end) throws PortalException
      Specified by:
      search in interface DLAppService
      Throws:
      PortalException
    • search

      public Hits search(long repositoryId, SearchContext searchContext) throws SearchException
      Specified by:
      search in interface DLAppService
      Throws:
      SearchException
    • search

      public Hits search(long repositoryId, SearchContext searchContext, Query query) throws SearchException
      Specified by:
      search in interface DLAppService
      Throws:
      SearchException
    • subscribeFileEntry

      public void subscribeFileEntry(long groupId, long fileEntryId) throws PortalException
      Specified by:
      subscribeFileEntry in interface DLAppService
      Throws:
      PortalException
    • subscribeFileEntryType

      public void subscribeFileEntryType(long groupId, long fileEntryTypeId) throws PortalException
      Subscribe the user to changes in documents of the file entry type. This method is only supported by the Liferay repository.
      Specified by:
      subscribeFileEntryType in interface DLAppService
      Parameters:
      groupId - the primary key of the file entry type's group
      fileEntryTypeId - the primary key of the file entry type
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • subscribeFolder

      public void subscribeFolder(long groupId, long folderId) throws PortalException
      Subscribe the user to document changes in the folder. This method is only supported by the Liferay repository.
      Specified by:
      subscribeFolder in interface DLAppService
      Parameters:
      groupId - the primary key of the folder's group
      folderId - the primary key of the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • unlockFolder

      public void unlockFolder(long repositoryId, long folderId, String lockUuid) throws PortalException
      Unlocks the folder. This method is primarily used by WebDAV.
      Specified by:
      unlockFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      folderId - the primary key of the folder
      lockUuid - the lock's UUID
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • unlockFolder

      public void unlockFolder(long repositoryId, long parentFolderId, String name, String lockUuid) throws PortalException
      Unlocks the folder. This method is primarily used by WebDAV.
      Specified by:
      unlockFolder in interface DLAppService
      Parameters:
      repositoryId - the primary key of the repository
      parentFolderId - the primary key of the parent folder
      name - the folder's name
      lockUuid - the lock's UUID
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • unsubscribeFileEntry

      public void unsubscribeFileEntry(long groupId, long fileEntryId) throws PortalException
      Specified by:
      unsubscribeFileEntry in interface DLAppService
      Throws:
      PortalException
    • unsubscribeFileEntryType

      public void unsubscribeFileEntryType(long groupId, long fileEntryTypeId) throws PortalException
      Unsubscribe the user from changes in documents of the file entry type. This method is only supported by the Liferay repository.
      Specified by:
      unsubscribeFileEntryType in interface DLAppService
      Parameters:
      groupId - the primary key of the file entry type's group
      fileEntryTypeId - the primary key of the file entry type
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • unsubscribeFolder

      public void unsubscribeFolder(long groupId, long folderId) throws PortalException
      Unsubscribe the user from document changes in the folder. This method is only supported by the Liferay repository.
      Specified by:
      unsubscribeFolder in interface DLAppService
      Parameters:
      groupId - the primary key of the folder's group
      folderId - the primary key of the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • updateFileEntry

      public FileEntry updateFileEntry(long fileEntryId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, DLVersionNumberIncrease dlVersionNumberIncrease, byte[] bytes, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Updates a file entry and associated metadata based on a byte array object. If the file data is null, then only the associated metadata (i.e., title, description, and parameters in the serviceContext) will be updated.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal.

      Specified by:
      updateFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      sourceFileName - the original file's name (optionally null)
      mimeType - the file's MIME type (optionally null)
      title - the new name to be assigned to the file (optionally null)
      description - the file's new description
      changeLog - the file's version change log (optionally null)
      dlVersionNumberIncrease - the kind of version number increase to apply for these changes.
      bytes - the file's data (optionally null)
      displayDate - the file's display date (optionally null )
      expirationDate - the file's expiration date (optionally null )
      reviewDate - the file's review date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • updateFileEntry

      public FileEntry updateFileEntry(long fileEntryId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, DLVersionNumberIncrease dlVersionNumberIncrease, File file, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Updates a file entry and associated metadata based on a File object. If the file data is null, then only the associated metadata (i.e., title, description, and parameters in the serviceContext) will be updated.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal.

      Specified by:
      updateFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      sourceFileName - the original file's name (optionally null)
      mimeType - the file's MIME type (optionally null)
      title - the new name to be assigned to the file (optionally null)
      description - the file's new description
      changeLog - the file's version change log (optionally null)
      dlVersionNumberIncrease - the kind of version number increase to apply for these changes.
      file - the file's data (optionally null)
      displayDate - the file's display date (optionally null )
      expirationDate - the file's expiration date (optionally null )
      reviewDate - the file's review date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • updateFileEntry

      public FileEntry updateFileEntry(long fileEntryId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, DLVersionNumberIncrease dlVersionNumberIncrease, InputStream inputStream, long size, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Updates a file entry and associated metadata based on an InputStream object. If the file data is null, then only the associated metadata (i.e., title, description, and parameters in the serviceContext) will be updated.

      This method takes two file names, the sourceFileName and the title. The sourceFileName corresponds to the name of the actual file being uploaded. The title corresponds to a name the client wishes to assign this file after it has been uploaded to the portal.

      Specified by:
      updateFileEntry in interface DLAppService
      Parameters:
      fileEntryId - the primary key of the file entry
      sourceFileName - the original file's name (optionally null)
      mimeType - the file's MIME type (optionally null)
      title - the new name to be assigned to the file (optionally null)
      description - the file's new description
      changeLog - the file's version change log (optionally null)
      dlVersionNumberIncrease - the kind of version number increase to apply for these changes.
      inputStream - the file's data (optionally null)
      size - the file's size (optionally 0)
      displayDate - the file's display date (optionally null )
      expirationDate - the file's expiration date (optionally null )
      reviewDate - the file's review date (optionally null)
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry. In a Liferay repository, it may include:
      • fileEntryTypeId - ID for a custom file entry type
      • fieldsMap - mapping for fields associated with a custom file entry type
      Returns:
      the file entry
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • updateFileEntryAndCheckIn

      public FileEntry updateFileEntryAndCheckIn(long fileEntryId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, DLVersionNumberIncrease dlVersionNumberIncrease, File file, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Specified by:
      updateFileEntryAndCheckIn in interface DLAppService
      Throws:
      PortalException
    • updateFileEntryAndCheckIn

      public FileEntry updateFileEntryAndCheckIn(long fileEntryId, String sourceFileName, String mimeType, String title, String urlTitle, String description, String changeLog, DLVersionNumberIncrease dlVersionNumberIncrease, InputStream inputStream, long size, Date displayDate, Date expirationDate, Date reviewDate, ServiceContext serviceContext) throws PortalException
      Specified by:
      updateFileEntryAndCheckIn in interface DLAppService
      Throws:
      PortalException
    • updateFileShortcut

      public FileShortcut updateFileShortcut(long fileShortcutId, long folderId, long toFileEntryId, ServiceContext serviceContext) throws PortalException
      Updates a file shortcut to the existing file entry. This method is only supported by the Liferay repository.
      Specified by:
      updateFileShortcut in interface DLAppService
      Parameters:
      fileShortcutId - the primary key of the file shortcut
      folderId - the primary key of the file shortcut's parent folder
      toFileEntryId - the primary key of the file shortcut's file entry
      serviceContext - the service context to be applied. Can set the asset category IDs, asset tag names, and expando bridge attributes for the file entry.
      Returns:
      the file shortcut
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • updateFolder

      public Folder updateFolder(long folderId, String name, String description, ServiceContext serviceContext) throws PortalException
      Updates the folder.
      Specified by:
      updateFolder in interface DLAppService
      Parameters:
      folderId - the primary key of the folder
      name - the folder's new name
      description - the folder's new description
      serviceContext - the service context to be applied. In a Liferay repository, it may include:
      • defaultFileEntryTypeId - the file entry type to default all Liferay file entries to
      • dlFileEntryTypesSearchContainerPrimaryKeys - a comma-delimited list of file entry type primary keys allowed in the given folder and all descendants
      • restrictionType - specifying restriction type of file entry types allowed
      • workflowDefinitionXYZ - the workflow definition name specified per file entry type. The parameter name must be the string workflowDefinition appended by the fileEntryTypeId (optionally 0).
      Returns:
      the folder
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • verifyFileEntryCheckOut

      public boolean verifyFileEntryCheckOut(long repositoryId, long fileEntryId, String lockUuid) throws PortalException
      Returns true if the file entry is checked out. This method is primarily used by WebDAV.
      Specified by:
      verifyFileEntryCheckOut in interface DLAppService
      Parameters:
      repositoryId - the primary key for the repository
      fileEntryId - the primary key for the file entry
      lockUuid - the lock's UUID
      Returns:
      true if the file entry is checked out; false otherwise
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • verifyFileEntryLock

      public boolean verifyFileEntryLock(long repositoryId, long fileEntryId, String lockUuid) throws PortalException
      Specified by:
      verifyFileEntryLock in interface DLAppService
      Throws:
      PortalException
    • verifyInheritableLock

      public boolean verifyInheritableLock(long repositoryId, long folderId, String lockUuid) throws PortalException
      Returns true if the inheritable lock exists. This method is primarily used by WebDAV.
      Specified by:
      verifyInheritableLock in interface DLAppService
      Parameters:
      repositoryId - the primary key for the repository
      folderId - the primary key for the folder
      lockUuid - the lock's UUID
      Returns:
      true if the inheritable lock exists; false otherwise
      Throws:
      PortalException - if a portal exception occurred
      PortalException
    • getWrappedService

      public DLAppService getWrappedService()
      Specified by:
      getWrappedService in interface ServiceWrapper<DLAppService>
    • setWrappedService

      public void setWrappedService(DLAppService dlAppService)
      Specified by:
      setWrappedService in interface ServiceWrapper<DLAppService>