001    /**
002     * Copyright (c) 2000-2013 Liferay, Inc. All rights reserved.
003     *
004     * This library is free software; you can redistribute it and/or modify it under
005     * the terms of the GNU Lesser General Public License as published by the Free
006     * Software Foundation; either version 2.1 of the License, or (at your option)
007     * any later version.
008     *
009     * This library is distributed in the hope that it will be useful, but WITHOUT
010     * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
011     * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
012     * details.
013     */
014    
015    package com.liferay.portlet.documentlibrary.service;
016    
017    import com.liferay.portal.kernel.exception.PortalException;
018    import com.liferay.portal.kernel.exception.SystemException;
019    import com.liferay.portal.kernel.jsonwebservice.JSONWebService;
020    import com.liferay.portal.kernel.transaction.Isolation;
021    import com.liferay.portal.kernel.transaction.Propagation;
022    import com.liferay.portal.kernel.transaction.Transactional;
023    import com.liferay.portal.security.ac.AccessControlled;
024    import com.liferay.portal.service.BaseService;
025    
026    /**
027     * Provides the remote service interface for DLApp. Methods of this
028     * service are expected to have security checks based on the propagated JAAS
029     * credentials because this service can be accessed remotely.
030     *
031     * @author Brian Wing Shun Chan
032     * @see DLAppServiceUtil
033     * @see com.liferay.portlet.documentlibrary.service.base.DLAppServiceBaseImpl
034     * @see com.liferay.portlet.documentlibrary.service.impl.DLAppServiceImpl
035     * @generated
036     */
037    @AccessControlled
038    @JSONWebService
039    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
040            PortalException.class, SystemException.class})
041    public interface DLAppService extends BaseService {
042            /*
043             * NOTE FOR DEVELOPERS:
044             *
045             * Never modify or reference this interface directly. Always use {@link DLAppServiceUtil} to access the d l app remote service. Add custom service methods to {@link com.liferay.portlet.documentlibrary.service.impl.DLAppServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface.
046             */
047    
048            /**
049            * Returns the Spring bean ID for this bean.
050            *
051            * @return the Spring bean ID for this bean
052            */
053            public java.lang.String getBeanIdentifier();
054    
055            /**
056            * Sets the Spring bean ID for this bean.
057            *
058            * @param beanIdentifier the Spring bean ID for this bean
059            */
060            public void setBeanIdentifier(java.lang.String beanIdentifier);
061    
062            /**
063            * Adds a file entry and associated metadata. It is created based on a byte
064            * array.
065            *
066            * <p>
067            * This method takes two file names, the <code>sourceFileName</code> and the
068            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
069            * name of the actual file being uploaded. The <code>title</code>
070            * corresponds to a name the client wishes to assign this file after it has
071            * been uploaded to the portal. If it is <code>null</code>, the <code>
072            * sourceFileName</code> will be used.
073            * </p>
074            *
075            * @param repositoryId the primary key of the repository
076            * @param folderId the primary key of the file entry's parent folder
077            * @param sourceFileName the original file's name
078            * @param mimeType the file's MIME type
079            * @param title the name to be assigned to the file (optionally <code>null
080            </code>)
081            * @param description the file's description
082            * @param changeLog the file's version change log
083            * @param bytes the file's data (optionally <code>null</code>)
084            * @param serviceContext the service context to be applied. Can set the
085            asset category IDs, asset tag names, and expando bridge
086            attributes for the file entry. In a Liferay repository, it may
087            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
088            type </li> <li> fieldsMap - mapping for fields associated with a
089            custom file entry type </li> </ul>
090            * @return the file entry
091            * @throws PortalException if the parent folder could not be found or if the
092            file entry's information was invalid
093            * @throws SystemException if a system exception occurred
094            */
095            public com.liferay.portal.kernel.repository.model.FileEntry addFileEntry(
096                    long repositoryId, long folderId, java.lang.String sourceFileName,
097                    java.lang.String mimeType, java.lang.String title,
098                    java.lang.String description, java.lang.String changeLog, byte[] bytes,
099                    com.liferay.portal.service.ServiceContext serviceContext)
100                    throws com.liferay.portal.kernel.exception.PortalException,
101                            com.liferay.portal.kernel.exception.SystemException;
102    
103            /**
104            * Adds a file entry and associated metadata. It is created based on a
105            * {@link java.io.File} object.
106            *
107            * <p>
108            * This method takes two file names, the <code>sourceFileName</code> and the
109            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
110            * name of the actual file being uploaded. The <code>title</code>
111            * corresponds to a name the client wishes to assign this file after it has
112            * been uploaded to the portal. If it is <code>null</code>, the <code>
113            * sourceFileName</code> will be used.
114            * </p>
115            *
116            * @param repositoryId the primary key of the repository
117            * @param folderId the primary key of the file entry's parent folder
118            * @param sourceFileName the original file's name
119            * @param mimeType the file's MIME type
120            * @param title the name to be assigned to the file (optionally <code>null
121            </code>)
122            * @param description the file's description
123            * @param changeLog the file's version change log
124            * @param file the file's data (optionally <code>null</code>)
125            * @param serviceContext the service context to be applied. Can set the
126            asset category IDs, asset tag names, and expando bridge
127            attributes for the file entry. In a Liferay repository, it may
128            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
129            type </li> <li> fieldsMap - mapping for fields associated with a
130            custom file entry type </li> </ul>
131            * @return the file entry
132            * @throws PortalException if the parent folder could not be found or if the
133            file entry's information was invalid
134            * @throws SystemException if a system exception occurred
135            */
136            public com.liferay.portal.kernel.repository.model.FileEntry addFileEntry(
137                    long repositoryId, long folderId, java.lang.String sourceFileName,
138                    java.lang.String mimeType, java.lang.String title,
139                    java.lang.String description, java.lang.String changeLog,
140                    java.io.File file,
141                    com.liferay.portal.service.ServiceContext serviceContext)
142                    throws com.liferay.portal.kernel.exception.PortalException,
143                            com.liferay.portal.kernel.exception.SystemException;
144    
145            /**
146            * Adds a file entry and associated metadata. It is created based on a
147            * {@link java.io.InputStream} object.
148            *
149            * <p>
150            * This method takes two file names, the <code>sourceFileName</code> and the
151            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
152            * name of the actual file being uploaded. The <code>title</code>
153            * corresponds to a name the client wishes to assign this file after it has
154            * been uploaded to the portal. If it is <code>null</code>, the <code>
155            * sourceFileName</code> will be used.
156            * </p>
157            *
158            * @param repositoryId the primary key of the repository
159            * @param folderId the primary key of the file entry's parent folder
160            * @param sourceFileName the original file's name
161            * @param mimeType the file's MIME type
162            * @param title the name to be assigned to the file (optionally <code>null
163            </code>)
164            * @param description the file's description
165            * @param changeLog the file's version change log
166            * @param is the file's data (optionally <code>null</code>)
167            * @param size the file's size (optionally <code>0</code>)
168            * @param serviceContext the service context to be applied. Can set the
169            asset category IDs, asset tag names, and expando bridge
170            attributes for the file entry. In a Liferay repository, it may
171            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
172            type </li> <li> fieldsMap - mapping for fields associated with a
173            custom file entry type </li> </ul>
174            * @return the file entry
175            * @throws PortalException if the parent folder could not be found or if the
176            file entry's information was invalid
177            * @throws SystemException if a system exception occurred
178            */
179            public com.liferay.portal.kernel.repository.model.FileEntry addFileEntry(
180                    long repositoryId, long folderId, java.lang.String sourceFileName,
181                    java.lang.String mimeType, java.lang.String title,
182                    java.lang.String description, java.lang.String changeLog,
183                    java.io.InputStream is, long size,
184                    com.liferay.portal.service.ServiceContext serviceContext)
185                    throws com.liferay.portal.kernel.exception.PortalException,
186                            com.liferay.portal.kernel.exception.SystemException;
187    
188            /**
189            * Adds a file shortcut to the existing file entry. This method is only
190            * supported by the Liferay repository.
191            *
192            * @param repositoryId the primary key of the repository
193            * @param folderId the primary key of the file shortcut's parent folder
194            * @param toFileEntryId the primary key of the file shortcut's file entry
195            * @param serviceContext the service context to be applied. Can set the
196            asset category IDs, asset tag names, and expando bridge
197            attributes for the file entry.
198            * @return the file shortcut
199            * @throws PortalException if the parent folder or file entry could not be
200            found, or if the file shortcut's information was invalid
201            * @throws SystemException if a system exception occurred
202            */
203            public com.liferay.portlet.documentlibrary.model.DLFileShortcut addFileShortcut(
204                    long repositoryId, long folderId, long toFileEntryId,
205                    com.liferay.portal.service.ServiceContext serviceContext)
206                    throws com.liferay.portal.kernel.exception.PortalException,
207                            com.liferay.portal.kernel.exception.SystemException;
208    
209            /**
210            * Adds a folder.
211            *
212            * @param repositoryId the primary key of the repository
213            * @param parentFolderId the primary key of the folder's parent folder
214            * @param name the folder's name
215            * @param description the folder's description
216            * @param serviceContext the service context to be applied. In a Liferay
217            repository, it may include boolean mountPoint specifying whether
218            folder is a facade for mounting a third-party repository
219            * @return the folder
220            * @throws PortalException if the parent folder could not be found or if the
221            new folder's information was invalid
222            * @throws SystemException if a system exception occurred
223            */
224            public com.liferay.portal.kernel.repository.model.Folder addFolder(
225                    long repositoryId, long parentFolderId, java.lang.String name,
226                    java.lang.String description,
227                    com.liferay.portal.service.ServiceContext serviceContext)
228                    throws com.liferay.portal.kernel.exception.PortalException,
229                            com.liferay.portal.kernel.exception.SystemException;
230    
231            /**
232            * Adds a temporary file entry.
233            *
234            * <p>
235            * This allows a client to upload a file into a temporary location and
236            * manipulate its metadata prior to making it available for public usage.
237            * This is different from checking in and checking out a file entry.
238            * </p>
239            *
240            * @param groupId the primary key of the group
241            * @param folderId the primary key of the folder where the file entry will
242            eventually reside
243            * @param fileName the file's original name
244            * @param tempFolderName the temporary folder's name
245            * @param file Name the file's original name
246            * @param mimeType the file's MIME type
247            * @return the file's name
248            * @throws PortalException if the file name was invalid
249            * @throws SystemException if a system exception occurred
250            * @see com.liferay.portal.kernel.util.TempFileUtil
251            */
252            public com.liferay.portal.kernel.repository.model.FileEntry addTempFileEntry(
253                    long groupId, long folderId, java.lang.String fileName,
254                    java.lang.String tempFolderName, java.io.File file,
255                    java.lang.String mimeType)
256                    throws com.liferay.portal.kernel.exception.PortalException,
257                            com.liferay.portal.kernel.exception.SystemException;
258    
259            public com.liferay.portal.kernel.repository.model.FileEntry addTempFileEntry(
260                    long groupId, long folderId, java.lang.String fileName,
261                    java.lang.String tempFolderName, java.io.InputStream inputStream,
262                    java.lang.String mimeType)
263                    throws com.liferay.portal.kernel.exception.PortalException,
264                            com.liferay.portal.kernel.exception.SystemException;
265    
266            /**
267            * Cancels the check out of the file entry. If a user has not checked out
268            * the specified file entry, invoking this method will result in no changes.
269            *
270            * <p>
271            * When a file entry is checked out, a PWC (private working copy) is created
272            * and the original file entry is locked. A client can make as many changes
273            * to the PWC as he desires without those changes being visible to other
274            * users. If the user is satisfied with the changes, he may elect to check
275            * in his changes, resulting in a new file version based on the PWC; the PWC
276            * will be removed and the file entry will be unlocked. If the user is not
277            * satisfied with the changes, he may elect to cancel his check out; this
278            * results in the deletion of the PWC and unlocking of the file entry.
279            * </p>
280            *
281            * @param fileEntryId the primary key of the file entry to cancel the
282            checkout
283            * @throws PortalException if the file entry could not be found
284            * @throws SystemException if a system exception occurred
285            * @see #checkInFileEntry(long, boolean, String, ServiceContext)
286            * @see #checkOutFileEntry(long, ServiceContext)
287            */
288            public void cancelCheckOut(long fileEntryId)
289                    throws com.liferay.portal.kernel.exception.PortalException,
290                            com.liferay.portal.kernel.exception.SystemException;
291    
292            /**
293            * Checks in the file entry. If a user has not checked out the specified
294            * file entry, invoking this method will result in no changes.
295            *
296            * <p>
297            * When a file entry is checked out, a PWC (private working copy) is created
298            * and the original file entry is locked. A client can make as many changes
299            * to the PWC as he desires without those changes being visible to other
300            * users. If the user is satisfied with the changes, he may elect to check
301            * in his changes, resulting in a new file version based on the PWC; the PWC
302            * will be removed and the file entry will be unlocked. If the user is not
303            * satisfied with the changes, he may elect to cancel his check out; this
304            * results in the deletion of the PWC and unlocking of the file entry.
305            * </p>
306            *
307            * @param fileEntryId the primary key of the file entry to check in
308            * @param majorVersion whether the new file version is a major version
309            * @param changeLog the file's version change log
310            * @param serviceContext the service context to be applied
311            * @throws PortalException if the file entry could not be found
312            * @throws SystemException if a system exception occurred
313            * @see #cancelCheckOut(long)
314            * @see #checkOutFileEntry(long, ServiceContext)
315            */
316            public void checkInFileEntry(long fileEntryId, boolean majorVersion,
317                    java.lang.String changeLog,
318                    com.liferay.portal.service.ServiceContext serviceContext)
319                    throws com.liferay.portal.kernel.exception.PortalException,
320                            com.liferay.portal.kernel.exception.SystemException;
321    
322            /**
323            * @deprecated As of 6.2.0, replaced by {@link #checkInFileEntry(long,
324            String, ServiceContext)}
325            */
326            public void checkInFileEntry(long fileEntryId, java.lang.String lockUuid)
327                    throws com.liferay.portal.kernel.exception.PortalException,
328                            com.liferay.portal.kernel.exception.SystemException;
329    
330            /**
331            * Checks in the file entry using the lock's UUID. If a user has not checked
332            * out the specified file entry, invoking this method will result in no
333            * changes. This method is primarily used by WebDAV.
334            *
335            * <p>
336            * When a file entry is checked out, a PWC (private working copy) is created
337            * and the original file entry is locked. A client can make as many changes
338            * to the PWC as he desires without those changes being visible to other
339            * users. If the user is satisfied with the changes, he may elect to check
340            * in his changes, resulting in a new file version based on the PWC; the PWC
341            * will be removed and the file entry will be unlocked. If the user is not
342            * satisfied with the changes, he may elect to cancel his check out; this
343            * results in the deletion of the PWC and unlocking of the file entry.
344            * </p>
345            *
346            * @param fileEntryId the primary key of the file entry to check in
347            * @param lockUuid the lock's UUID
348            * @param serviceContext the service context to be applied
349            * @throws PortalException if the file entry could not be found
350            * @throws SystemException if a system exception occurred
351            * @see #cancelCheckOut(long)
352            * @see #checkOutFileEntry(long, String, long, ServiceContext)
353            */
354            public void checkInFileEntry(long fileEntryId, java.lang.String lockUuid,
355                    com.liferay.portal.service.ServiceContext serviceContext)
356                    throws com.liferay.portal.kernel.exception.PortalException,
357                            com.liferay.portal.kernel.exception.SystemException;
358    
359            /**
360            * Check out a file entry.
361            *
362            * <p>
363            * When a file entry is checked out, a PWC (private working copy) is created
364            * and the original file entry is locked. A client can make as many changes
365            * to the PWC as he desires without those changes being visible to other
366            * users. If the user is satisfied with the changes, he may elect to check
367            * in his changes, resulting in a new file version based on the PWC; the PWC
368            * will be removed and the file entry will be unlocked. If the user is not
369            * satisfied with the changes, he may elect to cancel his check out; this
370            * results in the deletion of the PWC and unlocking of the file entry.
371            * </p>
372            *
373            * @param fileEntryId the file entry to check out
374            * @param serviceContext the service context to be applied
375            * @throws PortalException if the file entry could not be found
376            * @throws SystemException if a system exception occurred
377            * @see #cancelCheckOut(long)
378            * @see #checkInFileEntry(long, boolean, String, ServiceContext)
379            */
380            public void checkOutFileEntry(long fileEntryId,
381                    com.liferay.portal.service.ServiceContext serviceContext)
382                    throws com.liferay.portal.kernel.exception.PortalException,
383                            com.liferay.portal.kernel.exception.SystemException;
384    
385            /**
386            * Checks out the file entry. This method is primarily used by WebDAV.
387            *
388            * <p>
389            * When a file entry is checked out, a PWC (private working copy) is created
390            * and the original file entry is locked. A client can make as many changes
391            * to the PWC as he desires without those changes being visible to other
392            * users. If the user is satisfied with the changes, he may elect to check
393            * in his changes, resulting in a new file version based on the PWC; the PWC
394            * will be removed and the file entry will be unlocked. If the user is not
395            * satisfied with the changes, he may elect to cancel his check out; this
396            * results in the deletion of the PWC and unlocking of the file entry.
397            * </p>
398            *
399            * @param fileEntryId the file entry to check out
400            * @param owner the owner string for the checkout (optionally
401            <code>null</code>)
402            * @param expirationTime the time in milliseconds before the lock expires.
403            If the value is <code>0</code>, the default expiration time will
404            be used from <code>portal.properties>.
405            * @param serviceContext the service context to be applied
406            * @return the file entry
407            * @throws PortalException if the file entry could not be found
408            * @throws SystemException if a system exception occurred
409            * @see #cancelCheckOut(long)
410            * @see #checkInFileEntry(long, String)
411            */
412            public com.liferay.portal.kernel.repository.model.FileEntry checkOutFileEntry(
413                    long fileEntryId, java.lang.String owner, long expirationTime,
414                    com.liferay.portal.service.ServiceContext serviceContext)
415                    throws com.liferay.portal.kernel.exception.PortalException,
416                            com.liferay.portal.kernel.exception.SystemException;
417    
418            /**
419            * Performs a deep copy of the folder.
420            *
421            * @param repositoryId the primary key of the repository
422            * @param sourceFolderId the primary key of the folder to copy
423            * @param parentFolderId the primary key of the new folder's parent folder
424            * @param name the new folder's name
425            * @param description the new folder's description
426            * @param serviceContext the service context to be applied
427            * @return the folder
428            * @throws PortalException if the source folder or the new parent folder
429            could not be found or if the new folder's information was invalid
430            * @throws SystemException if a system exception occurred
431            */
432            public com.liferay.portal.kernel.repository.model.Folder copyFolder(
433                    long repositoryId, long sourceFolderId, long parentFolderId,
434                    java.lang.String name, java.lang.String description,
435                    com.liferay.portal.service.ServiceContext serviceContext)
436                    throws com.liferay.portal.kernel.exception.PortalException,
437                            com.liferay.portal.kernel.exception.SystemException;
438    
439            /**
440            * Deletes the file entry with the primary key.
441            *
442            * @param fileEntryId the primary key of the file entry
443            * @throws PortalException if the file entry could not be found
444            * @throws SystemException if a system exception occurred
445            */
446            public void deleteFileEntry(long fileEntryId)
447                    throws com.liferay.portal.kernel.exception.PortalException,
448                            com.liferay.portal.kernel.exception.SystemException;
449    
450            /**
451            * Deletes the file entry with the title in the folder.
452            *
453            * @param repositoryId the primary key of the repository
454            * @param folderId the primary key of the file entry's parent folder
455            * @param title the file entry's title
456            * @throws PortalException if the file entry could not be found
457            * @throws SystemException if a system exception occurred
458            */
459            public void deleteFileEntryByTitle(long repositoryId, long folderId,
460                    java.lang.String title)
461                    throws com.liferay.portal.kernel.exception.PortalException,
462                            com.liferay.portal.kernel.exception.SystemException;
463    
464            /**
465            * Deletes the file shortcut with the primary key. This method is only
466            * supported by the Liferay repository.
467            *
468            * @param fileShortcutId the primary key of the file shortcut
469            * @throws PortalException if the file shortcut could not be found
470            * @throws SystemException if a system exception occurred
471            */
472            public void deleteFileShortcut(long fileShortcutId)
473                    throws com.liferay.portal.kernel.exception.PortalException,
474                            com.liferay.portal.kernel.exception.SystemException;
475    
476            /**
477            * Deletes the file version. File versions can only be deleted if it is
478            * approved and there are other approved file versions available. This
479            * method is only supported by the Liferay repository.
480            *
481            * @param fileEntryId the primary key of the file entry
482            * @param version the version label of the file version
483            * @throws PortalException if the file version could not be found or invalid
484            * @throws SystemException if a system exception occurred
485            */
486            public void deleteFileVersion(long fileEntryId, java.lang.String version)
487                    throws com.liferay.portal.kernel.exception.PortalException,
488                            com.liferay.portal.kernel.exception.SystemException;
489    
490            /**
491            * Deletes the folder with the primary key and all of its subfolders and
492            * file entries.
493            *
494            * @param folderId the primary key of the folder
495            * @throws PortalException if the folder could not be found
496            * @throws SystemException if a system exception occurred
497            */
498            public void deleteFolder(long folderId)
499                    throws com.liferay.portal.kernel.exception.PortalException,
500                            com.liferay.portal.kernel.exception.SystemException;
501    
502            /**
503            * Deletes the folder with the name in the parent folder and all of its
504            * subfolders and file entries.
505            *
506            * @param repositoryId the primary key of the repository
507            * @param parentFolderId the primary key of the folder's parent folder
508            * @param name the folder's name
509            * @throws PortalException if the folder could not be found
510            * @throws SystemException if a system exception occurred
511            */
512            public void deleteFolder(long repositoryId, long parentFolderId,
513                    java.lang.String name)
514                    throws com.liferay.portal.kernel.exception.PortalException,
515                            com.liferay.portal.kernel.exception.SystemException;
516    
517            /**
518            * Deletes the temporary file entry.
519            *
520            * @param groupId the primary key of the group
521            * @param folderId the primary key of the folder where the file entry was
522            eventually to reside
523            * @param fileName the file's original name
524            * @param tempFolderName the temporary folder's name
525            * @throws PortalException if the file name was invalid
526            * @throws SystemException if a system exception occurred
527            * @see com.liferay.portal.kernel.util.TempFileUtil
528            */
529            public void deleteTempFileEntry(long groupId, long folderId,
530                    java.lang.String fileName, java.lang.String tempFolderName)
531                    throws com.liferay.portal.kernel.exception.PortalException,
532                            com.liferay.portal.kernel.exception.SystemException;
533    
534            /**
535            * Returns all the file entries in the folder.
536            *
537            * @param repositoryId the primary key of the file entry's repository
538            * @param folderId the primary key of the file entry's folder
539            * @return the file entries in the folder
540            * @throws PortalException if the folder could not be found
541            * @throws SystemException if a system exception occurred
542            */
543            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
544            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
545                    long repositoryId, long folderId)
546                    throws com.liferay.portal.kernel.exception.PortalException,
547                            com.liferay.portal.kernel.exception.SystemException;
548    
549            /**
550            * Returns a range of all the file entries in the folder.
551            *
552            * <p>
553            * Useful when paginating results. Returns a maximum of <code>end -
554            * start</code> instances. <code>start</code> and <code>end</code> are not
555            * primary keys, they are indexes in the result set. Thus, <code>0</code>
556            * refers to the first result in the set. Setting both <code>start</code>
557            * and <code>end</code> to {@link
558            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
559            * result set.
560            * </p>
561            *
562            * @param repositoryId the primary key of the file entry's repository
563            * @param folderId the primary key of the file entry's folder
564            * @param start the lower bound of the range of results
565            * @param end the upper bound of the range of results (not inclusive)
566            * @return the range of file entries in the folder
567            * @throws PortalException if the folder could not be found
568            * @throws SystemException if a system exception occurred
569            */
570            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
571            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
572                    long repositoryId, long folderId, int start, int end)
573                    throws com.liferay.portal.kernel.exception.PortalException,
574                            com.liferay.portal.kernel.exception.SystemException;
575    
576            /**
577            * Returns an ordered range of all the file entries in the folder.
578            *
579            * <p>
580            * Useful when paginating results. Returns a maximum of <code>end -
581            * start</code> instances. <code>start</code> and <code>end</code> are not
582            * primary keys, they are indexes in the result set. Thus, <code>0</code>
583            * refers to the first result in the set. Setting both <code>start</code>
584            * and <code>end</code> to {@link
585            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
586            * result set.
587            * </p>
588            *
589            * @param repositoryId the primary key of the file entry's repository
590            * @param folderId the primary key of the file entry's folder
591            * @param start the lower bound of the range of results
592            * @param end the upper bound of the range of results (not inclusive)
593            * @param obc the comparator to order the file entries (optionally
594            <code>null</code>)
595            * @return the range of file entries in the folder ordered by comparator
596            <code>obc</code>
597            * @throws PortalException if the folder could not be found
598            * @throws SystemException if a system exception occurred
599            */
600            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
601            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
602                    long repositoryId, long folderId, int start, int end,
603                    com.liferay.portal.kernel.util.OrderByComparator obc)
604                    throws com.liferay.portal.kernel.exception.PortalException,
605                            com.liferay.portal.kernel.exception.SystemException;
606    
607            /**
608            * Returns the file entries with the file entry type in the folder.
609            *
610            * @param repositoryId the primary key of the file entry's repository
611            * @param folderId the primary key of the file entry's folder
612            * @param fileEntryTypeId the primary key of the file entry type
613            * @return the file entries with the file entry type in the folder
614            * @throws PortalException if the folder could not be found
615            * @throws SystemException if a system exception occurred
616            */
617            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
618            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
619                    long repositoryId, long folderId, long fileEntryTypeId)
620                    throws com.liferay.portal.kernel.exception.PortalException,
621                            com.liferay.portal.kernel.exception.SystemException;
622    
623            /**
624            * Returns a range of all the file entries with the file entry type in the
625            * folder.
626            *
627            * @param repositoryId the primary key of the file entry's repository
628            * @param folderId the primary key of the file entry's folder
629            * @param fileEntryTypeId the primary key of the file entry type
630            * @param start the lower bound of the range of results
631            * @param end the upper bound of the range of results (not inclusive)
632            * @return the file entries in the folder
633            * @throws PortalException if the folder could not be found
634            * @throws SystemException if a system exception occurred
635            */
636            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
637            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
638                    long repositoryId, long folderId, long fileEntryTypeId, int start,
639                    int end)
640                    throws com.liferay.portal.kernel.exception.PortalException,
641                            com.liferay.portal.kernel.exception.SystemException;
642    
643            /**
644            * Returns an ordered range of all the file entries with the file entry type
645            * in the folder.
646            *
647            * @param repositoryId the primary key of the repository
648            * @param folderId the primary key of the folder
649            * @param fileEntryTypeId the primary key of the file entry type
650            * @param start the lower bound of the range of results
651            * @param end the upper bound of the range of results (not inclusive)
652            * @param obc the comparator to order the results by (optionally
653            <code>null</code>)
654            * @return the range of file entries with the file entry type in the folder
655            ordered by <code>null</code>
656            * @throws PortalException if the folder could not be found
657            * @throws SystemException if a system exception occurred
658            */
659            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
660            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getFileEntries(
661                    long repositoryId, long folderId, long fileEntryTypeId, int start,
662                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
663                    throws com.liferay.portal.kernel.exception.PortalException,
664                            com.liferay.portal.kernel.exception.SystemException;
665    
666            /**
667            * Returns a range of all the file entries and shortcuts in the folder.
668            *
669            * <p>
670            * Useful when paginating results. Returns a maximum of <code>end -
671            * start</code> instances. <code>start</code> and <code>end</code> are not
672            * primary keys, they are indexes in the result set. Thus, <code>0</code>
673            * refers to the first result in the set. Setting both <code>start</code>
674            * and <code>end</code> to {@link
675            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
676            * result set.
677            * </p>
678            *
679            * @param repositoryId the primary key of the repository
680            * @param folderId the primary key of the folder
681            * @param status the workflow status
682            * @param start the lower bound of the range of results
683            * @param end the upper bound of the range of results (not inclusive)
684            * @return the range of file entries and shortcuts in the folder
685            * @throws PortalException if the folder could not be found
686            * @throws SystemException if a system exception occurred
687            */
688            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
689            public java.util.List<java.lang.Object> getFileEntriesAndFileShortcuts(
690                    long repositoryId, long folderId, int status, int start, int end)
691                    throws com.liferay.portal.kernel.exception.PortalException,
692                            com.liferay.portal.kernel.exception.SystemException;
693    
694            /**
695            * Returns the number of file entries and shortcuts in the folder.
696            *
697            * @param repositoryId the primary key of the repository
698            * @param folderId the primary key of the folder
699            * @param status the workflow status
700            * @return the number of file entries and shortcuts in the folder
701            * @throws PortalException if the folder ould not be found
702            * @throws SystemException if a system exception occurred
703            */
704            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
705            public int getFileEntriesAndFileShortcutsCount(long repositoryId,
706                    long folderId, int status)
707                    throws com.liferay.portal.kernel.exception.PortalException,
708                            com.liferay.portal.kernel.exception.SystemException;
709    
710            /**
711            * Returns the number of file entries and shortcuts in the folder.
712            *
713            * @param repositoryId the primary key of the repository
714            * @param folderId the primary key of the folder
715            * @param status the workflow status
716            * @param mimeTypes allowed media types
717            * @return the number of file entries and shortcuts in the folder
718            * @throws PortalException if the folder ould not be found
719            * @throws SystemException if a system exception occurred
720            */
721            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
722            public int getFileEntriesAndFileShortcutsCount(long repositoryId,
723                    long folderId, int status, java.lang.String[] mimeTypes)
724                    throws com.liferay.portal.kernel.exception.PortalException,
725                            com.liferay.portal.kernel.exception.SystemException;
726    
727            /**
728            * Returns the number of file entries in the folder.
729            *
730            * @param repositoryId the primary key of the file entry's repository
731            * @param folderId the primary key of the file entry's folder
732            * @return the number of file entries in the folder
733            * @throws PortalException if the folder could not be found
734            * @throws SystemException if a system exception occurred
735            */
736            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
737            public int getFileEntriesCount(long repositoryId, long folderId)
738                    throws com.liferay.portal.kernel.exception.PortalException,
739                            com.liferay.portal.kernel.exception.SystemException;
740    
741            /**
742            * Returns the number of file entries with the file entry type in the
743            * folder.
744            *
745            * @param repositoryId the primary key of the file entry's repository
746            * @param folderId the primary key of the file entry's folder
747            * @param fileEntryTypeId the primary key of the file entry type
748            * @return the number of file entries with the file entry type in the folder
749            * @throws PortalException if the folder could not be found
750            * @throws SystemException if a system exception occurred
751            */
752            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
753            public int getFileEntriesCount(long repositoryId, long folderId,
754                    long fileEntryTypeId)
755                    throws com.liferay.portal.kernel.exception.PortalException,
756                            com.liferay.portal.kernel.exception.SystemException;
757    
758            /**
759            * Returns the file entry with the primary key.
760            *
761            * @param fileEntryId the primary key of the file entry
762            * @return the file entry with the primary key
763            * @throws PortalException if the file entry could not be found
764            * @throws SystemException if a system exception occurred
765            */
766            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
767            public com.liferay.portal.kernel.repository.model.FileEntry getFileEntry(
768                    long fileEntryId)
769                    throws com.liferay.portal.kernel.exception.PortalException,
770                            com.liferay.portal.kernel.exception.SystemException;
771    
772            /**
773            * Returns the file entry with the title in the folder.
774            *
775            * @param groupId the primary key of the file entry's group
776            * @param folderId the primary key of the file entry's folder
777            * @param title the file entry's title
778            * @return the file entry with the title in the folder
779            * @throws PortalException if the file entry could not be found
780            * @throws SystemException if a system exception occurred
781            */
782            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
783            public com.liferay.portal.kernel.repository.model.FileEntry getFileEntry(
784                    long groupId, long folderId, java.lang.String title)
785                    throws com.liferay.portal.kernel.exception.PortalException,
786                            com.liferay.portal.kernel.exception.SystemException;
787    
788            /**
789            * Returns the file entry with the UUID and group.
790            *
791            * @param uuid the file entry's UUID
792            * @param groupId the primary key of the file entry's group
793            * @return the file entry with the UUID and group
794            * @throws PortalException if the file entry could not be found
795            * @throws SystemException if a system exception occurred
796            */
797            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
798            public com.liferay.portal.kernel.repository.model.FileEntry getFileEntryByUuidAndGroupId(
799                    java.lang.String uuid, long groupId)
800                    throws com.liferay.portal.kernel.exception.PortalException,
801                            com.liferay.portal.kernel.exception.SystemException;
802    
803            /**
804            * Returns the file shortcut with the primary key. This method is only
805            * supported by the Liferay repository.
806            *
807            * @param fileShortcutId the primary key of the file shortcut
808            * @return the file shortcut with the primary key
809            * @throws PortalException if the file shortcut could not be found
810            * @throws SystemException if a system exception occurred
811            */
812            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
813            public com.liferay.portlet.documentlibrary.model.DLFileShortcut getFileShortcut(
814                    long fileShortcutId)
815                    throws com.liferay.portal.kernel.exception.PortalException,
816                            com.liferay.portal.kernel.exception.SystemException;
817    
818            /**
819            * Returns the folder with the primary key.
820            *
821            * @param folderId the primary key of the folder
822            * @return the folder with the primary key
823            * @throws PortalException if the folder could not be found
824            * @throws SystemException if a system exception occurred
825            */
826            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
827            public com.liferay.portal.kernel.repository.model.Folder getFolder(
828                    long folderId)
829                    throws com.liferay.portal.kernel.exception.PortalException,
830                            com.liferay.portal.kernel.exception.SystemException;
831    
832            /**
833            * Returns the folder with the name in the parent folder.
834            *
835            * @param repositoryId the primary key of the folder's repository
836            * @param parentFolderId the primary key of the folder's parent folder
837            * @param name the folder's name
838            * @return the folder with the name in the parent folder
839            * @throws PortalException if the folder could not be found
840            * @throws SystemException if a system exception occurred
841            */
842            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
843            public com.liferay.portal.kernel.repository.model.Folder getFolder(
844                    long repositoryId, long parentFolderId, java.lang.String name)
845                    throws com.liferay.portal.kernel.exception.PortalException,
846                            com.liferay.portal.kernel.exception.SystemException;
847    
848            /**
849            * Returns all immediate subfolders of the parent folder.
850            *
851            * @param repositoryId the primary key of the folder's repository
852            * @param parentFolderId the primary key of the folder's parent folder
853            * @return the immediate subfolders of the parent folder
854            * @throws PortalException if the parent folder could not be found
855            * @throws SystemException if a system exception occurred
856            */
857            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
858            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
859                    long repositoryId, long parentFolderId)
860                    throws com.liferay.portal.kernel.exception.PortalException,
861                            com.liferay.portal.kernel.exception.SystemException;
862    
863            /**
864            * Returns all immediate subfolders of the parent folder, optionally
865            * including mount folders for third-party repositories.
866            *
867            * @param repositoryId the primary key of the folder's repository
868            * @param parentFolderId the primary key of the folder's parent folder
869            * @param includeMountFolders whether to include mount folders for
870            third-party repositories
871            * @return the immediate subfolders of the parent folder
872            * @throws PortalException if the parent folder could not be found
873            * @throws SystemException if a system exception occurred
874            */
875            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
876            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
877                    long repositoryId, long parentFolderId, boolean includeMountFolders)
878                    throws com.liferay.portal.kernel.exception.PortalException,
879                            com.liferay.portal.kernel.exception.SystemException;
880    
881            /**
882            * Returns a range of all the immediate subfolders of the parent folder,
883            * optionally including mount folders for third-party repositories.
884            *
885            * <p>
886            * Useful when paginating results. Returns a maximum of <code>end -
887            * start</code> instances. <code>start</code> and <code>end</code> are not
888            * primary keys, they are indexes in the result set. Thus, <code>0</code>
889            * refers to the first result in the set. Setting both <code>start</code>
890            * and <code>end</code> to {@link
891            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
892            * result set.
893            * </p>
894            *
895            * @param repositoryId the primary key of the folder's repository
896            * @param parentFolderId the primary key of the folder's parent folder
897            * @param includeMountFolders whether to include mount folders for
898            third-party repositories
899            * @param start the lower bound of the range of results
900            * @param end the upper bound of the range of results (not inclusive)
901            * @return the range of immediate subfolders of the parent folder
902            * @throws PortalException if the parent folder could not be found
903            * @throws SystemException if a system exception occurred
904            */
905            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
906            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
907                    long repositoryId, long parentFolderId, boolean includeMountFolders,
908                    int start, int end)
909                    throws com.liferay.portal.kernel.exception.PortalException,
910                            com.liferay.portal.kernel.exception.SystemException;
911    
912            /**
913            * Returns an ordered range of all the immediate subfolders of the parent
914            * folder.
915            *
916            * <p>
917            * Useful when paginating results. Returns a maximum of <code>end -
918            * start</code> instances. <code>start</code> and <code>end</code> are not
919            * primary keys, they are indexes in the result set. Thus, <code>0</code>
920            * refers to the first result in the set. Setting both <code>start</code>
921            * and <code>end</code> to {@link
922            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
923            * result set.
924            * </p>
925            *
926            * @param repositoryId the primary key of the folder's repository
927            * @param parentFolderId the primary key of the folder's parent folder
928            * @param includeMountFolders whether to include mount folders for
929            third-party repositories
930            * @param start the lower bound of the range of results
931            * @param end the upper bound of the range of results (not inclusive)
932            * @param obc the comparator to order the folders (optionally
933            <code>null</code>)
934            * @return the range of immediate subfolders of the parent folder ordered by
935            comparator <code>obc</code>
936            * @throws PortalException if the parent folder could not be found
937            * @throws SystemException if a system exception occurred
938            */
939            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
940            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
941                    long repositoryId, long parentFolderId, boolean includeMountFolders,
942                    int start, int end, com.liferay.portal.kernel.util.OrderByComparator obc)
943                    throws com.liferay.portal.kernel.exception.PortalException,
944                            com.liferay.portal.kernel.exception.SystemException;
945    
946            /**
947            * Returns an ordered range of all the immediate subfolders of the parent
948            * folder.
949            *
950            * <p>
951            * Useful when paginating results. Returns a maximum of <code>end -
952            * start</code> instances. <code>start</code> and <code>end</code> are not
953            * primary keys, they are indexes in the result set. Thus, <code>0</code>
954            * refers to the first result in the set. Setting both <code>start</code>
955            * and <code>end</code> to {@link
956            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
957            * result set.
958            * </p>
959            *
960            * @param repositoryId the primary key of the folder's repository
961            * @param parentFolderId the primary key of the folder's parent folder
962            * @param status the workflow status
963            * @param includeMountFolders whether to include mount folders for
964            third-party repositories
965            * @param start the lower bound of the range of results
966            * @param end the upper bound of the range of results (not inclusive)
967            * @param obc the comparator to order the folders (optionally
968            <code>null</code>)
969            * @return the range of immediate subfolders of the parent folder ordered by
970            comparator <code>obc</code>
971            * @throws PortalException if the parent folder could not be found
972            * @throws SystemException if a system exception occurred
973            */
974            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
975            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
976                    long repositoryId, long parentFolderId, int status,
977                    boolean includeMountFolders, int start, int end,
978                    com.liferay.portal.kernel.util.OrderByComparator obc)
979                    throws com.liferay.portal.kernel.exception.PortalException,
980                            com.liferay.portal.kernel.exception.SystemException;
981    
982            /**
983            * Returns a range of all the immediate subfolders of the parent folder.
984            *
985            * <p>
986            * Useful when paginating results. Returns a maximum of <code>end -
987            * start</code> instances. <code>start</code> and <code>end</code> are not
988            * primary keys, they are indexes in the result set. Thus, <code>0</code>
989            * refers to the first result in the set. Setting both <code>start</code>
990            * and <code>end</code> to {@link
991            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
992            * result set.
993            * </p>
994            *
995            * @param repositoryId the primary key of the folder's repository
996            * @param parentFolderId the primary key of the folder's parent folder
997            * @param start the lower bound of the range of results
998            * @param end the upper bound of the range of results (not inclusive)
999            * @return the range of immediate subfolders of the parent folder
1000            * @throws PortalException if the parent folder could not be found
1001            * @throws SystemException if a system exception occurred
1002            */
1003            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1004            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
1005                    long repositoryId, long parentFolderId, int start, int end)
1006                    throws com.liferay.portal.kernel.exception.PortalException,
1007                            com.liferay.portal.kernel.exception.SystemException;
1008    
1009            /**
1010            * Returns an ordered range of all the immediate subfolders of the parent
1011            * folder.
1012            *
1013            * <p>
1014            * Useful when paginating results. Returns a maximum of <code>end -
1015            * start</code> instances. <code>start</code> and <code>end</code> are not
1016            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1017            * refers to the first result in the set. Setting both <code>start</code>
1018            * and <code>end</code> to {@link
1019            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1020            * result set.
1021            * </p>
1022            *
1023            * @param repositoryId the primary key of the folder's repository
1024            * @param parentFolderId the primary key of the folder's parent folder
1025            * @param start the lower bound of the range of results
1026            * @param end the upper bound of the range of results (not inclusive)
1027            * @param obc the comparator to order the folders (optionally
1028            <code>null</code>)
1029            * @return the range of immediate subfolders of the parent folder ordered by
1030            comparator <code>obc</code>
1031            * @throws PortalException if the parent folder could not be found
1032            * @throws SystemException if a system exception occurred
1033            */
1034            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1035            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getFolders(
1036                    long repositoryId, long parentFolderId, int start, int end,
1037                    com.liferay.portal.kernel.util.OrderByComparator obc)
1038                    throws com.liferay.portal.kernel.exception.PortalException,
1039                            com.liferay.portal.kernel.exception.SystemException;
1040    
1041            /**
1042            * Returns a range of all the immediate subfolders, file entries, and file
1043            * shortcuts in the parent folder.
1044            *
1045            * <p>
1046            * Useful when paginating results. Returns a maximum of <code>end -
1047            * start</code> instances. <code>start</code> and <code>end</code> are not
1048            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1049            * refers to the first result in the set. Setting both <code>start</code>
1050            * and <code>end</code> to {@link
1051            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1052            * result set.
1053            * </p>
1054            *
1055            * @param repositoryId the primary key of the repository
1056            * @param folderId the primary key of the parent folder
1057            * @param status the workflow status
1058            * @param includeMountFolders whether to include mount folders for
1059            third-party repositories
1060            * @param start the lower bound of the range of results
1061            * @param end the upper bound of the range of results (not inclusive)
1062            * @return the range of immediate subfolders, file entries, and file
1063            shortcuts in the parent folder ordered by comparator
1064            <code>obc</code>
1065            * @throws PortalException if the parent folder could not be found
1066            * @throws SystemException if a system exception occurred
1067            */
1068            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1069            public java.util.List<java.lang.Object> getFoldersAndFileEntriesAndFileShortcuts(
1070                    long repositoryId, long folderId, int status,
1071                    boolean includeMountFolders, int start, int end)
1072                    throws com.liferay.portal.kernel.exception.PortalException,
1073                            com.liferay.portal.kernel.exception.SystemException;
1074    
1075            /**
1076            * Returns an ordered range of all the immediate subfolders, file entries,
1077            * and file shortcuts in the parent folder.
1078            *
1079            * <p>
1080            * Useful when paginating results. Returns a maximum of <code>end -
1081            * start</code> instances. <code>start</code> and <code>end</code> are not
1082            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1083            * refers to the first result in the set. Setting both <code>start</code>
1084            * and <code>end</code> to {@link
1085            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1086            * result set.
1087            * </p>
1088            *
1089            * @param repositoryId the primary key of the repository
1090            * @param folderId the primary key of the parent folder
1091            * @param status the workflow status
1092            * @param includeMountFolders whether to include mount folders for
1093            third-party repositories
1094            * @param start the lower bound of the range of results
1095            * @param end the upper bound of the range of results (not inclusive)
1096            * @param obc the comparator to order the results (optionally
1097            <code>null</code>)
1098            * @return the range of immediate subfolders, file entries, and file
1099            shortcuts in the parent folder ordered by comparator
1100            <code>obc</code>
1101            * @throws PortalException if the parent folder could not be found
1102            * @throws SystemException if a system exception occurred
1103            */
1104            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1105            public java.util.List<java.lang.Object> getFoldersAndFileEntriesAndFileShortcuts(
1106                    long repositoryId, long folderId, int status,
1107                    boolean includeMountFolders, int start, int end,
1108                    com.liferay.portal.kernel.util.OrderByComparator obc)
1109                    throws com.liferay.portal.kernel.exception.PortalException,
1110                            com.liferay.portal.kernel.exception.SystemException;
1111    
1112            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1113            public java.util.List<java.lang.Object> getFoldersAndFileEntriesAndFileShortcuts(
1114                    long repositoryId, long folderId, int status,
1115                    java.lang.String[] mimeTypes, boolean includeMountFolders, int start,
1116                    int end, com.liferay.portal.kernel.util.OrderByComparator obc)
1117                    throws com.liferay.portal.kernel.exception.PortalException,
1118                            com.liferay.portal.kernel.exception.SystemException;
1119    
1120            /**
1121            * Returns the number of immediate subfolders, file entries, and file
1122            * shortcuts in the parent folder.
1123            *
1124            * @param repositoryId the primary key of the repository
1125            * @param folderId the primary key of the parent folder
1126            * @param status the workflow status
1127            * @param includeMountFolders whether to include mount folders for
1128            third-party repositories
1129            * @return the number of immediate subfolders, file entries, and file
1130            shortcuts in the parent folder
1131            * @throws PortalException if the folder could not be found
1132            * @throws SystemException if a system exception occurred
1133            */
1134            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1135            public int getFoldersAndFileEntriesAndFileShortcutsCount(
1136                    long repositoryId, long folderId, int status,
1137                    boolean includeMountFolders)
1138                    throws com.liferay.portal.kernel.exception.PortalException,
1139                            com.liferay.portal.kernel.exception.SystemException;
1140    
1141            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1142            public int getFoldersAndFileEntriesAndFileShortcutsCount(
1143                    long repositoryId, long folderId, int status,
1144                    java.lang.String[] mimeTypes, boolean includeMountFolders)
1145                    throws com.liferay.portal.kernel.exception.PortalException,
1146                            com.liferay.portal.kernel.exception.SystemException;
1147    
1148            /**
1149            * Returns the number of immediate subfolders of the parent folder.
1150            *
1151            * @param repositoryId the primary key of the folder's repository
1152            * @param parentFolderId the primary key of the folder's parent folder
1153            * @return the number of immediate subfolders of the parent folder
1154            * @throws PortalException if the parent folder could not be found
1155            * @throws SystemException if a system exception occurred
1156            */
1157            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1158            public int getFoldersCount(long repositoryId, long parentFolderId)
1159                    throws com.liferay.portal.kernel.exception.PortalException,
1160                            com.liferay.portal.kernel.exception.SystemException;
1161    
1162            /**
1163            * Returns the number of immediate subfolders of the parent folder,
1164            * optionally including mount folders for third-party repositories.
1165            *
1166            * @param repositoryId the primary key of the folder's repository
1167            * @param parentFolderId the primary key of the folder's parent folder
1168            * @param includeMountFolders whether to include mount folders for
1169            third-party repositories
1170            * @return the number of immediate subfolders of the parent folder
1171            * @throws PortalException if the parent folder could not be found
1172            * @throws SystemException if a system exception occurred
1173            */
1174            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1175            public int getFoldersCount(long repositoryId, long parentFolderId,
1176                    boolean includeMountFolders)
1177                    throws com.liferay.portal.kernel.exception.PortalException,
1178                            com.liferay.portal.kernel.exception.SystemException;
1179    
1180            /**
1181            * Returns the number of immediate subfolders of the parent folder,
1182            * optionally including mount folders for third-party repositories.
1183            *
1184            * @param repositoryId the primary key of the folder's repository
1185            * @param parentFolderId the primary key of the folder's parent folder
1186            * @param status the workflow status
1187            * @param includeMountFolders whether to include mount folders for
1188            third-party repositories
1189            * @return the number of immediate subfolders of the parent folder
1190            * @throws PortalException if the parent folder could not be found
1191            * @throws SystemException if a system exception occurred
1192            */
1193            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1194            public int getFoldersCount(long repositoryId, long parentFolderId,
1195                    int status, boolean includeMountFolders)
1196                    throws com.liferay.portal.kernel.exception.PortalException,
1197                            com.liferay.portal.kernel.exception.SystemException;
1198    
1199            /**
1200            * Returns the number of immediate subfolders and file entries across the
1201            * folders.
1202            *
1203            * @param repositoryId the primary key of the repository
1204            * @param folderIds the primary keys of folders from which to count
1205            immediate subfolders and file entries
1206            * @param status the workflow status
1207            * @return the number of immediate subfolders and file entries across the
1208            folders
1209            * @throws PortalException if the repository could not be found
1210            * @throws SystemException if a system exception occurred
1211            */
1212            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1213            public int getFoldersFileEntriesCount(long repositoryId,
1214                    java.util.List<java.lang.Long> folderIds, int status)
1215                    throws com.liferay.portal.kernel.exception.PortalException,
1216                            com.liferay.portal.kernel.exception.SystemException;
1217    
1218            /**
1219            * Returns an ordered range of all the file entries in the group starting at
1220            * the repository default parent folder that are stored within the Liferay
1221            * repository. This method is primarily used to search for recently modified
1222            * file entries. It can be limited to the file entries modified by a given
1223            * user.
1224            *
1225            * <p>
1226            * Useful when paginating results. Returns a maximum of <code>end -
1227            * start</code> instances. <code>start</code> and <code>end</code> are not
1228            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1229            * refers to the first result in the set. Setting both <code>start</code>
1230            * and <code>end</code> to {@link
1231            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1232            * result set.
1233            * </p>
1234            *
1235            * @param groupId the primary key of the group
1236            * @param userId the primary key of the user who created the file
1237            (optionally <code>0</code>)
1238            * @param start the lower bound of the range of results
1239            * @param end the upper bound of the range of results (not inclusive)
1240            * @return the range of matching file entries ordered by date modified
1241            * @throws PortalException if the group could not be found
1242            * @throws SystemException if a system exception occurred
1243            */
1244            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1245            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getGroupFileEntries(
1246                    long groupId, long userId, int start, int end)
1247                    throws com.liferay.portal.kernel.exception.PortalException,
1248                            com.liferay.portal.kernel.exception.SystemException;
1249    
1250            /**
1251            * Returns an ordered range of all the file entries in the group that are
1252            * stored within the Liferay repository. This method is primarily used to
1253            * search for recently modified file entries. It can be limited to the file
1254            * entries modified by a given user.
1255            *
1256            * <p>
1257            * Useful when paginating results. Returns a maximum of <code>end -
1258            * start</code> instances. <code>start</code> and <code>end</code> are not
1259            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1260            * refers to the first result in the set. Setting both <code>start</code>
1261            * and <code>end</code> to {@link
1262            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1263            * result set.
1264            * </p>
1265            *
1266            * @param groupId the primary key of the group
1267            * @param userId the primary key of the user who created the file
1268            (optionally <code>0</code>)
1269            * @param start the lower bound of the range of results
1270            * @param end the upper bound of the range of results (not inclusive)
1271            * @param obc the comparator to order the file entries (optionally
1272            <code>null</code>)
1273            * @return the range of matching file entries ordered by comparator
1274            <code>obc</code>
1275            * @throws PortalException if the group could not be found
1276            * @throws SystemException if a system exception occurred
1277            */
1278            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1279            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getGroupFileEntries(
1280                    long groupId, long userId, int start, int end,
1281                    com.liferay.portal.kernel.util.OrderByComparator obc)
1282                    throws com.liferay.portal.kernel.exception.PortalException,
1283                            com.liferay.portal.kernel.exception.SystemException;
1284    
1285            /**
1286            * Returns an ordered range of all the file entries in the group starting at
1287            * the root folder that are stored within the Liferay repository. This
1288            * method is primarily used to search for recently modified file entries. It
1289            * can be limited to the file entries modified by a given user.
1290            *
1291            * <p>
1292            * Useful when paginating results. Returns a maximum of <code>end -
1293            * start</code> instances. <code>start</code> and <code>end</code> are not
1294            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1295            * refers to the first result in the set. Setting both <code>start</code>
1296            * and <code>end</code> to {@link
1297            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1298            * result set.
1299            * </p>
1300            *
1301            * @param groupId the primary key of the group
1302            * @param userId the primary key of the user who created the file
1303            (optionally <code>0</code>)
1304            * @param rootFolderId the primary key of the root folder to begin the
1305            search
1306            * @param start the lower bound of the range of results
1307            * @param end the upper bound of the range of results (not inclusive)
1308            * @return the range of matching file entries ordered by date modified
1309            * @throws PortalException if the group could not be found
1310            * @throws SystemException if a system exception occurred
1311            */
1312            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1313            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getGroupFileEntries(
1314                    long groupId, long userId, long rootFolderId, int start, int end)
1315                    throws com.liferay.portal.kernel.exception.PortalException,
1316                            com.liferay.portal.kernel.exception.SystemException;
1317    
1318            /**
1319            * Returns an ordered range of all the file entries in the group starting at
1320            * the root folder that are stored within the Liferay repository. This
1321            * method is primarily used to search for recently modified file entries. It
1322            * can be limited to the file entries modified by a given user.
1323            *
1324            * <p>
1325            * Useful when paginating results. Returns a maximum of <code>end -
1326            * start</code> instances. <code>start</code> and <code>end</code> are not
1327            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1328            * refers to the first result in the set. Setting both <code>start</code>
1329            * and <code>end</code> to {@link
1330            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1331            * result set.
1332            * </p>
1333            *
1334            * @param groupId the primary key of the group
1335            * @param userId the primary key of the user who created the file
1336            (optionally <code>0</code>)
1337            * @param rootFolderId the primary key of the root folder to begin the
1338            search
1339            * @param start the lower bound of the range of results
1340            * @param end the upper bound of the range of results (not inclusive)
1341            * @param obc the comparator to order the file entries (optionally
1342            <code>null</code>)
1343            * @return the range of matching file entries ordered by comparator
1344            <code>obc</code>
1345            * @throws PortalException if the group could not be found
1346            * @throws SystemException if a system exception occurred
1347            */
1348            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1349            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getGroupFileEntries(
1350                    long groupId, long userId, long rootFolderId, int start, int end,
1351                    com.liferay.portal.kernel.util.OrderByComparator obc)
1352                    throws com.liferay.portal.kernel.exception.PortalException,
1353                            com.liferay.portal.kernel.exception.SystemException;
1354    
1355            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1356            public java.util.List<com.liferay.portal.kernel.repository.model.FileEntry> getGroupFileEntries(
1357                    long groupId, long userId, long rootFolderId,
1358                    java.lang.String[] mimeTypes, int status, int start, int end,
1359                    com.liferay.portal.kernel.util.OrderByComparator obc)
1360                    throws com.liferay.portal.kernel.exception.PortalException,
1361                            com.liferay.portal.kernel.exception.SystemException;
1362    
1363            /**
1364            * Returns the number of file entries in a group starting at the repository
1365            * default parent folder that are stored within the Liferay repository. This
1366            * method is primarily used to search for recently modified file entries. It
1367            * can be limited to the file entries modified by a given user.
1368            *
1369            * @param groupId the primary key of the group
1370            * @param userId the primary key of the user who created the file
1371            (optionally <code>0</code>)
1372            * @return the number of matching file entries
1373            * @throws PortalException if the group could not be found
1374            * @throws SystemException if a system exception occurred
1375            */
1376            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1377            public int getGroupFileEntriesCount(long groupId, long userId)
1378                    throws com.liferay.portal.kernel.exception.PortalException,
1379                            com.liferay.portal.kernel.exception.SystemException;
1380    
1381            /**
1382            * Returns the number of file entries in a group starting at the root folder
1383            * that are stored within the Liferay repository. This method is primarily
1384            * used to search for recently modified file entries. It can be limited to
1385            * the file entries modified by a given user.
1386            *
1387            * @param groupId the primary key of the group
1388            * @param userId the primary key of the user who created the file
1389            (optionally <code>0</code>)
1390            * @param rootFolderId the primary key of the root folder to begin the
1391            search
1392            * @return the number of matching file entries
1393            * @throws PortalException if the group could not be found
1394            * @throws SystemException if a system exception occurred
1395            */
1396            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1397            public int getGroupFileEntriesCount(long groupId, long userId,
1398                    long rootFolderId)
1399                    throws com.liferay.portal.kernel.exception.PortalException,
1400                            com.liferay.portal.kernel.exception.SystemException;
1401    
1402            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1403            public int getGroupFileEntriesCount(long groupId, long userId,
1404                    long rootFolderId, java.lang.String[] mimeTypes, int status)
1405                    throws com.liferay.portal.kernel.exception.PortalException,
1406                            com.liferay.portal.kernel.exception.SystemException;
1407    
1408            /**
1409            * Returns all immediate subfolders of the parent folder that are used for
1410            * mounting third-party repositories. This method is only supported by the
1411            * Liferay repository.
1412            *
1413            * @param repositoryId the primary key of the folder's repository
1414            * @param parentFolderId the primary key of the folder's parent folder
1415            * @return the immediate subfolders of the parent folder that are used for
1416            mounting third-party repositories
1417            * @throws PortalException if the repository or parent folder could not be
1418            found
1419            * @throws SystemException if a system exception occurred
1420            */
1421            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1422            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getMountFolders(
1423                    long repositoryId, long parentFolderId)
1424                    throws com.liferay.portal.kernel.exception.PortalException,
1425                            com.liferay.portal.kernel.exception.SystemException;
1426    
1427            /**
1428            * Returns a range of all the immediate subfolders of the parent folder that
1429            * are used for mounting third-party repositories. This method is only
1430            * supported by the Liferay repository.
1431            *
1432            * <p>
1433            * Useful when paginating results. Returns a maximum of <code>end -
1434            * start</code> instances. <code>start</code> and <code>end</code> are not
1435            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1436            * refers to the first result in the set. Setting both <code>start</code>
1437            * and <code>end</code> to {@link
1438            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1439            * result set.
1440            * </p>
1441            *
1442            * @param repositoryId the primary key of the repository
1443            * @param parentFolderId the primary key of the parent folder
1444            * @param start the lower bound of the range of results
1445            * @param end the upper bound of the range of results (not inclusive)
1446            * @return the range of immediate subfolders of the parent folder that are
1447            used for mounting third-party repositories
1448            * @throws PortalException if the repository or parent folder could not be
1449            found
1450            * @throws SystemException if a system exception occurred
1451            */
1452            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1453            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getMountFolders(
1454                    long repositoryId, long parentFolderId, int start, int end)
1455                    throws com.liferay.portal.kernel.exception.PortalException,
1456                            com.liferay.portal.kernel.exception.SystemException;
1457    
1458            /**
1459            * Returns an ordered range of all the immediate subfolders of the parent
1460            * folder that are used for mounting third-party repositories. This method
1461            * is only supported by the Liferay repository.
1462            *
1463            * <p>
1464            * Useful when paginating results. Returns a maximum of <code>end -
1465            * start</code> instances. <code>start</code> and <code>end</code> are not
1466            * primary keys, they are indexes in the result set. Thus, <code>0</code>
1467            * refers to the first result in the set. Setting both <code>start</code>
1468            * and <code>end</code> to {@link
1469            * com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS} will return the full
1470            * result set.
1471            * </p>
1472            *
1473            * @param repositoryId the primary key of the folder's repository
1474            * @param parentFolderId the primary key of the folder's parent folder
1475            * @param start the lower bound of the range of results
1476            * @param end the upper bound of the range of results (not inclusive)
1477            * @param obc the comparator to order the folders (optionally
1478            <code>null</code>)
1479            * @return the range of immediate subfolders of the parent folder that are
1480            used for mounting third-party repositories ordered by comparator
1481            <code>obc</code>
1482            * @throws PortalException if the repository or parent folder could not be
1483            found
1484            * @throws SystemException if a system exception occurred
1485            */
1486            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1487            public java.util.List<com.liferay.portal.kernel.repository.model.Folder> getMountFolders(
1488                    long repositoryId, long parentFolderId, int start, int end,
1489                    com.liferay.portal.kernel.util.OrderByComparator obc)
1490                    throws com.liferay.portal.kernel.exception.PortalException,
1491                            com.liferay.portal.kernel.exception.SystemException;
1492    
1493            /**
1494            * Returns the number of immediate subfolders of the parent folder that are
1495            * used for mounting third-party repositories. This method is only supported
1496            * by the Liferay repository.
1497            *
1498            * @param repositoryId the primary key of the repository
1499            * @param parentFolderId the primary key of the parent folder
1500            * @return the number of folders of the parent folder that are used for
1501            mounting third-party repositories
1502            * @throws PortalException if the repository or parent folder could not be
1503            found
1504            * @throws SystemException if a system exception occurred
1505            */
1506            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1507            public int getMountFoldersCount(long repositoryId, long parentFolderId)
1508                    throws com.liferay.portal.kernel.exception.PortalException,
1509                            com.liferay.portal.kernel.exception.SystemException;
1510    
1511            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1512            public void getSubfolderIds(long repositoryId,
1513                    java.util.List<java.lang.Long> folderIds, long folderId)
1514                    throws com.liferay.portal.kernel.exception.PortalException,
1515                            com.liferay.portal.kernel.exception.SystemException;
1516    
1517            /**
1518            * Returns all the descendant folders of the folder with the primary key.
1519            *
1520            * @param repositoryId the primary key of the repository
1521            * @param folderId the primary key of the folder
1522            * @return the descendant folders of the folder with the primary key
1523            * @throws PortalException if the repository or parent folder could not be
1524            found
1525            * @throws SystemException if a system exception occurred
1526            */
1527            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1528            public java.util.List<java.lang.Long> getSubfolderIds(long repositoryId,
1529                    long folderId)
1530                    throws com.liferay.portal.kernel.exception.PortalException,
1531                            com.liferay.portal.kernel.exception.SystemException;
1532    
1533            /**
1534            * Returns descendant folders of the folder with the primary key, optionally
1535            * limiting to one level deep.
1536            *
1537            * @param repositoryId the primary key of the repository
1538            * @param folderId the primary key of the folder
1539            * @param recurse whether to recurse through each subfolder
1540            * @return the descendant folders of the folder with the primary key
1541            * @throws PortalException if the repository or parent folder could not be
1542            found
1543            * @throws SystemException if a system exception occurred
1544            */
1545            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1546            public java.util.List<java.lang.Long> getSubfolderIds(long repositoryId,
1547                    long folderId, boolean recurse)
1548                    throws com.liferay.portal.kernel.exception.PortalException,
1549                            com.liferay.portal.kernel.exception.SystemException;
1550    
1551            /**
1552            * Returns all the temporary file entry names.
1553            *
1554            * @param groupId the primary key of the group
1555            * @param folderId the primary key of the folder where the file entry will
1556            eventually reside
1557            * @param tempFolderName the temporary folder's name
1558            * @return the temporary file entry names
1559            * @throws PortalException if the folder was invalid
1560            * @throws SystemException if a system exception occurred
1561            * @see #addTempFileEntry(long, long, String, String, File, String)
1562            * @see com.liferay.portal.kernel.util.TempFileUtil
1563            */
1564            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1565            public java.lang.String[] getTempFileEntryNames(long groupId,
1566                    long folderId, java.lang.String tempFolderName)
1567                    throws com.liferay.portal.kernel.exception.PortalException,
1568                            com.liferay.portal.kernel.exception.SystemException;
1569    
1570            /**
1571            * @deprecated As of 6.2.0, replaced by {@link #checkOutFileEntry(long,
1572            ServiceContext)}
1573            */
1574            public com.liferay.portal.model.Lock lockFileEntry(long fileEntryId)
1575                    throws com.liferay.portal.kernel.exception.PortalException,
1576                            com.liferay.portal.kernel.exception.SystemException;
1577    
1578            /**
1579            * @deprecated As of 6.2.0, replaced by {@link #checkOutFileEntry(long,
1580            String, long, ServiceContext)}
1581            */
1582            public com.liferay.portal.model.Lock lockFileEntry(long fileEntryId,
1583                    java.lang.String owner, long expirationTime)
1584                    throws com.liferay.portal.kernel.exception.PortalException,
1585                            com.liferay.portal.kernel.exception.SystemException;
1586    
1587            /**
1588            * Locks the folder. This method is primarily used by WebDAV.
1589            *
1590            * @param repositoryId the primary key of the repository
1591            * @param folderId the primary key of the folder
1592            * @return the lock object
1593            * @throws PortalException if the repository or folder could not be found
1594            * @throws SystemException if a system exception occurred
1595            */
1596            public com.liferay.portal.model.Lock lockFolder(long repositoryId,
1597                    long folderId)
1598                    throws com.liferay.portal.kernel.exception.PortalException,
1599                            com.liferay.portal.kernel.exception.SystemException;
1600    
1601            /**
1602            * Locks the folder. This method is primarily used by WebDAV.
1603            *
1604            * @param repositoryId the primary key of the repository
1605            * @param folderId the primary key of the folder
1606            * @param owner the owner string for the checkout (optionally
1607            <code>null</code>)
1608            * @param inheritable whether the lock must propagate to descendants
1609            * @param expirationTime the time in milliseconds before the lock expires.
1610            If the value is <code>0</code>, the default expiration time will
1611            be used from <code>portal.properties>.
1612            * @return the lock object
1613            * @throws PortalException if the repository or folder could not be found
1614            * @throws SystemException if a system exception occurred
1615            */
1616            public com.liferay.portal.model.Lock lockFolder(long repositoryId,
1617                    long folderId, java.lang.String owner, boolean inheritable,
1618                    long expirationTime)
1619                    throws com.liferay.portal.kernel.exception.PortalException,
1620                            com.liferay.portal.kernel.exception.SystemException;
1621    
1622            /**
1623            * Moves the file entry to the new folder.
1624            *
1625            * @param fileEntryId the primary key of the file entry
1626            * @param newFolderId the primary key of the new folder
1627            * @param serviceContext the service context to be applied
1628            * @return the file entry
1629            * @throws PortalException if the file entry or the new folder could not be
1630            found
1631            * @throws SystemException if a system exception occurred
1632            */
1633            public com.liferay.portal.kernel.repository.model.FileEntry moveFileEntry(
1634                    long fileEntryId, long newFolderId,
1635                    com.liferay.portal.service.ServiceContext serviceContext)
1636                    throws com.liferay.portal.kernel.exception.PortalException,
1637                            com.liferay.portal.kernel.exception.SystemException;
1638    
1639            /**
1640            * Moves the file entry from a trashed folder to the new folder.
1641            *
1642            * @param fileEntryId the primary key of the file entry
1643            * @param newFolderId the primary key of the new folder
1644            * @param serviceContext the service context to be applied
1645            * @return the file entry
1646            * @throws PortalException if the file entry or the new folder could not be
1647            found
1648            * @throws SystemException if a system exception occurred
1649            */
1650            public com.liferay.portal.kernel.repository.model.FileEntry moveFileEntryFromTrash(
1651                    long fileEntryId, long newFolderId,
1652                    com.liferay.portal.service.ServiceContext serviceContext)
1653                    throws com.liferay.portal.kernel.exception.PortalException,
1654                            com.liferay.portal.kernel.exception.SystemException;
1655    
1656            /**
1657            * Moves the file entry with the primary key to the trash portlet.
1658            *
1659            * @param fileEntryId the primary key of the file entry
1660            * @return the file entry
1661            * @throws PortalException if the file entry could not be found
1662            * @throws SystemException if a system exception occurred
1663            */
1664            public com.liferay.portal.kernel.repository.model.FileEntry moveFileEntryToTrash(
1665                    long fileEntryId)
1666                    throws com.liferay.portal.kernel.exception.PortalException,
1667                            com.liferay.portal.kernel.exception.SystemException;
1668    
1669            /**
1670            * Moves the file shortcut from a trashed folder to the new folder.
1671            *
1672            * @param fileShortcutId the primary key of the file shortcut
1673            * @param newFolderId the primary key of the new folder
1674            * @param serviceContext the service context to be applied
1675            * @return the file shortcut
1676            * @throws PortalException if the file entry or the new folder could not be
1677            found
1678            * @throws SystemException if a system exception occurred
1679            */
1680            public com.liferay.portlet.documentlibrary.model.DLFileShortcut moveFileShortcutFromTrash(
1681                    long fileShortcutId, long newFolderId,
1682                    com.liferay.portal.service.ServiceContext serviceContext)
1683                    throws com.liferay.portal.kernel.exception.PortalException,
1684                            com.liferay.portal.kernel.exception.SystemException;
1685    
1686            /**
1687            * Moves the file shortcut with the primary key to the trash portlet.
1688            *
1689            * @param fileShortcutId the primary key of the file shortcut
1690            * @return the file shortcut
1691            * @throws PortalException if the file shortcut could not be found
1692            * @throws SystemException if a system exception occurred
1693            */
1694            public com.liferay.portlet.documentlibrary.model.DLFileShortcut moveFileShortcutToTrash(
1695                    long fileShortcutId)
1696                    throws com.liferay.portal.kernel.exception.PortalException,
1697                            com.liferay.portal.kernel.exception.SystemException;
1698    
1699            /**
1700            * Moves the folder to the new parent folder with the primary key.
1701            *
1702            * @param folderId the primary key of the folder
1703            * @param parentFolderId the primary key of the new parent folder
1704            * @param serviceContext the service context to be applied
1705            * @return the file entry
1706            * @throws PortalException if the folder could not be found
1707            * @throws SystemException if a system exception occurred
1708            */
1709            public com.liferay.portal.kernel.repository.model.Folder moveFolder(
1710                    long folderId, long parentFolderId,
1711                    com.liferay.portal.service.ServiceContext serviceContext)
1712                    throws com.liferay.portal.kernel.exception.PortalException,
1713                            com.liferay.portal.kernel.exception.SystemException;
1714    
1715            /**
1716            * Moves the folder with the primary key from the trash portlet to the new
1717            * parent folder with the primary key.
1718            *
1719            * @param folderId the primary key of the folder
1720            * @param parentFolderId the primary key of the new parent folder
1721            * @param serviceContext the service context to be applied
1722            * @return the file entry
1723            * @throws PortalException if the folder could not be found
1724            * @throws SystemException if a system exception occurred
1725            */
1726            public com.liferay.portal.kernel.repository.model.Folder moveFolderFromTrash(
1727                    long folderId, long parentFolderId,
1728                    com.liferay.portal.service.ServiceContext serviceContext)
1729                    throws com.liferay.portal.kernel.exception.PortalException,
1730                            com.liferay.portal.kernel.exception.SystemException;
1731    
1732            /**
1733            * Moves the folder with the primary key to the trash portlet.
1734            *
1735            * @param folderId the primary key of the folder
1736            * @return the file entry
1737            * @throws PortalException if the folder could not be found
1738            * @throws SystemException if a system exception occurred
1739            */
1740            public com.liferay.portal.kernel.repository.model.Folder moveFolderToTrash(
1741                    long folderId)
1742                    throws com.liferay.portal.kernel.exception.PortalException,
1743                            com.liferay.portal.kernel.exception.SystemException;
1744    
1745            /**
1746            * Refreshes the lock for the file entry. This method is primarily used by
1747            * WebDAV.
1748            *
1749            * @param lockUuid the lock's UUID
1750            * @param companyId the primary key of the file entry's company
1751            * @param expirationTime the time in milliseconds before the lock expires.
1752            If the value is <code>0</code>, the default expiration time will
1753            be used from <code>portal.properties>.
1754            * @return the lock object
1755            * @throws PortalException if the file entry or lock could not be found
1756            * @throws SystemException if a system exception occurred
1757            */
1758            public com.liferay.portal.model.Lock refreshFileEntryLock(
1759                    java.lang.String lockUuid, long companyId, long expirationTime)
1760                    throws com.liferay.portal.kernel.exception.PortalException,
1761                            com.liferay.portal.kernel.exception.SystemException;
1762    
1763            /**
1764            * Refreshes the lock for the folder. This method is primarily used by
1765            * WebDAV.
1766            *
1767            * @param lockUuid the lock's UUID
1768            * @param companyId the primary key of the file entry's company
1769            * @param expirationTime the time in milliseconds before the lock expires.
1770            If the value is <code>0</code>, the default expiration time will
1771            be used from <code>portal.properties>.
1772            * @return the lock object
1773            * @throws PortalException if the folder or lock could not be found
1774            * @throws SystemException if a system exception occurred
1775            */
1776            public com.liferay.portal.model.Lock refreshFolderLock(
1777                    java.lang.String lockUuid, long companyId, long expirationTime)
1778                    throws com.liferay.portal.kernel.exception.PortalException,
1779                            com.liferay.portal.kernel.exception.SystemException;
1780    
1781            /**
1782            * Restores the file entry with the primary key from the trash portlet.
1783            *
1784            * @param fileEntryId the primary key of the file entry
1785            * @throws PortalException if the file entry could not be found
1786            * @throws SystemException if a system exception occurred
1787            */
1788            public void restoreFileEntryFromTrash(long fileEntryId)
1789                    throws com.liferay.portal.kernel.exception.PortalException,
1790                            com.liferay.portal.kernel.exception.SystemException;
1791    
1792            /**
1793            * Restores the file shortcut with the primary key from the trash portlet.
1794            *
1795            * @param fileShortcutId the primary key of the file shortcut
1796            * @throws PortalException if the file shortcut could not be found
1797            * @throws SystemException if a system exception occurred
1798            */
1799            public void restoreFileShortcutFromTrash(long fileShortcutId)
1800                    throws com.liferay.portal.kernel.exception.PortalException,
1801                            com.liferay.portal.kernel.exception.SystemException;
1802    
1803            /**
1804            * Restores the folder with the primary key from the trash portlet.
1805            *
1806            * @param folderId the primary key of the folder
1807            * @throws PortalException if the folder could not be found
1808            * @throws SystemException if a system exception occurred
1809            */
1810            public void restoreFolderFromTrash(long folderId)
1811                    throws com.liferay.portal.kernel.exception.PortalException,
1812                            com.liferay.portal.kernel.exception.SystemException;
1813    
1814            /**
1815            * Reverts the file entry to a previous version. A new version will be
1816            * created based on the previous version and metadata.
1817            *
1818            * @param fileEntryId the primary key of the file entry
1819            * @param version the version to revert back to
1820            * @param serviceContext the service context to be applied
1821            * @throws PortalException if the file entry or version could not be found
1822            * @throws SystemException if a system exception occurred
1823            */
1824            public void revertFileEntry(long fileEntryId, java.lang.String version,
1825                    com.liferay.portal.service.ServiceContext serviceContext)
1826                    throws com.liferay.portal.kernel.exception.PortalException,
1827                            com.liferay.portal.kernel.exception.SystemException;
1828    
1829            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1830            public com.liferay.portal.kernel.search.Hits search(long repositoryId,
1831                    long creatorUserId, int status, int start, int end)
1832                    throws com.liferay.portal.kernel.exception.PortalException,
1833                            com.liferay.portal.kernel.exception.SystemException;
1834    
1835            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1836            public com.liferay.portal.kernel.search.Hits search(long repositoryId,
1837                    long creatorUserId, long folderId, java.lang.String[] mimeTypes,
1838                    int status, int start, int end)
1839                    throws com.liferay.portal.kernel.exception.PortalException,
1840                            com.liferay.portal.kernel.exception.SystemException;
1841    
1842            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1843            public com.liferay.portal.kernel.search.Hits search(long repositoryId,
1844                    com.liferay.portal.kernel.search.SearchContext searchContext)
1845                    throws com.liferay.portal.kernel.search.SearchException;
1846    
1847            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
1848            public com.liferay.portal.kernel.search.Hits search(long repositoryId,
1849                    com.liferay.portal.kernel.search.SearchContext searchContext,
1850                    com.liferay.portal.kernel.search.Query query)
1851                    throws com.liferay.portal.kernel.search.SearchException;
1852    
1853            /**
1854            * Subscribe the user to changes in documents of the file entry type. This
1855            * method is only supported by the Liferay repository.
1856            *
1857            * @param groupId the primary key of the file entry type's group
1858            * @param fileEntryTypeId the primary key of the file entry type
1859            * @throws PortalException if the user or group could not be found, or if
1860            subscribing was not permissible
1861            * @throws SystemException if a system exception occurred
1862            */
1863            public void subscribeFileEntryType(long groupId, long fileEntryTypeId)
1864                    throws com.liferay.portal.kernel.exception.PortalException,
1865                            com.liferay.portal.kernel.exception.SystemException;
1866    
1867            /**
1868            * Subscribe the user to document changes in the folder. This method is only
1869            * supported by the Liferay repository.
1870            *
1871            * @param groupId the primary key of the folder's group
1872            * @param folderId the primary key of the folder
1873            * @throws PortalException if the user or group could not be found, or if
1874            subscribing was not permissible
1875            * @throws SystemException if a system exception occurred
1876            */
1877            public void subscribeFolder(long groupId, long folderId)
1878                    throws com.liferay.portal.kernel.exception.PortalException,
1879                            com.liferay.portal.kernel.exception.SystemException;
1880    
1881            /**
1882            * @deprecated As of 6.2.0, replaced by {@link #checkInFileEntry(long,
1883            boolean, String, ServiceContext)}.
1884            */
1885            public void unlockFileEntry(long fileEntryId)
1886                    throws com.liferay.portal.kernel.exception.PortalException,
1887                            com.liferay.portal.kernel.exception.SystemException;
1888    
1889            /**
1890            * @deprecated As of 6.2.0, replaced by {@link #checkInFileEntry(long,
1891            String)}.
1892            */
1893            public void unlockFileEntry(long fileEntryId, java.lang.String lockUuid)
1894                    throws com.liferay.portal.kernel.exception.PortalException,
1895                            com.liferay.portal.kernel.exception.SystemException;
1896    
1897            /**
1898            * Unlocks the folder. This method is primarily used by WebDAV.
1899            *
1900            * @param repositoryId the primary key of the repository
1901            * @param folderId the primary key of the folder
1902            * @param lockUuid the lock's UUID
1903            * @throws PortalException if the repository or folder could not be found
1904            * @throws SystemException if a system exception occurred
1905            */
1906            public void unlockFolder(long repositoryId, long folderId,
1907                    java.lang.String lockUuid)
1908                    throws com.liferay.portal.kernel.exception.PortalException,
1909                            com.liferay.portal.kernel.exception.SystemException;
1910    
1911            /**
1912            * Unlocks the folder. This method is primarily used by WebDAV.
1913            *
1914            * @param repositoryId the primary key of the repository
1915            * @param parentFolderId the primary key of the parent folder
1916            * @param name the folder's name
1917            * @param lockUuid the lock's UUID
1918            * @throws PortalException if the repository or folder could not be found
1919            * @throws SystemException if a system exception occurred
1920            */
1921            public void unlockFolder(long repositoryId, long parentFolderId,
1922                    java.lang.String name, java.lang.String lockUuid)
1923                    throws com.liferay.portal.kernel.exception.PortalException,
1924                            com.liferay.portal.kernel.exception.SystemException;
1925    
1926            /**
1927            * Unsubscribe the user from changes in documents of the file entry type.
1928            * This method is only supported by the Liferay repository.
1929            *
1930            * @param groupId the primary key of the file entry type's group
1931            * @param fileEntryTypeId the primary key of the file entry type
1932            * @throws PortalException if the user or group could not be found, or if
1933            unsubscribing was not permissible
1934            * @throws SystemException if a system exception occurred
1935            */
1936            public void unsubscribeFileEntryType(long groupId, long fileEntryTypeId)
1937                    throws com.liferay.portal.kernel.exception.PortalException,
1938                            com.liferay.portal.kernel.exception.SystemException;
1939    
1940            /**
1941            * Unsubscribe the user from document changes in the folder. This method is
1942            * only supported by the Liferay repository.
1943            *
1944            * @param groupId the primary key of the folder's group
1945            * @param folderId the primary key of the folder
1946            * @throws PortalException if the user or group could not be found, or if
1947            unsubscribing was not permissible
1948            * @throws SystemException if a system exception occurred
1949            */
1950            public void unsubscribeFolder(long groupId, long folderId)
1951                    throws com.liferay.portal.kernel.exception.PortalException,
1952                            com.liferay.portal.kernel.exception.SystemException;
1953    
1954            /**
1955            * Updates a file entry and associated metadata based on a byte array
1956            * object. If the file data is <code>null</code>, then only the associated
1957            * metadata (i.e., <code>title</code>, <code>description</code>, and
1958            * parameters in the <code>serviceContext</code>) will be updated.
1959            *
1960            * <p>
1961            * This method takes two file names, the <code>sourceFileName</code> and the
1962            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
1963            * name of the actual file being uploaded. The <code>title</code>
1964            * corresponds to a name the client wishes to assign this file after it has
1965            * been uploaded to the portal.
1966            * </p>
1967            *
1968            * @param fileEntryId the primary key of the file entry
1969            * @param sourceFileName the original file's name (optionally
1970            <code>null</code>)
1971            * @param mimeType the file's MIME type (optionally <code>null</code>)
1972            * @param title the new name to be assigned to the file (optionally <code>
1973            <code>null</code></code>)
1974            * @param description the file's new description
1975            * @param changeLog the file's version change log (optionally
1976            <code>null</code>)
1977            * @param majorVersion whether the new file version is a major version
1978            * @param bytes the file's data (optionally <code>null</code>)
1979            * @param serviceContext the service context to be applied. Can set the
1980            asset category IDs, asset tag names, and expando bridge
1981            attributes for the file entry. In a Liferay repository, it may
1982            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
1983            type </li> <li> fieldsMap - mapping for fields associated with a
1984            custom file entry type </li> </ul>
1985            * @return the file entry
1986            * @throws PortalException if the file entry could not be found
1987            * @throws SystemException if a system exception occurred
1988            */
1989            public com.liferay.portal.kernel.repository.model.FileEntry updateFileEntry(
1990                    long fileEntryId, java.lang.String sourceFileName,
1991                    java.lang.String mimeType, java.lang.String title,
1992                    java.lang.String description, java.lang.String changeLog,
1993                    boolean majorVersion, byte[] bytes,
1994                    com.liferay.portal.service.ServiceContext serviceContext)
1995                    throws com.liferay.portal.kernel.exception.PortalException,
1996                            com.liferay.portal.kernel.exception.SystemException;
1997    
1998            /**
1999            * Updates a file entry and associated metadata based on a {@link
2000            * java.io.File} object. If the file data is <code>null</code>, then only
2001            * the associated metadata (i.e., <code>title</code>,
2002            * <code>description</code>, and parameters in the
2003            * <code>serviceContext</code>) will be updated.
2004            *
2005            * <p>
2006            * This method takes two file names, the <code>sourceFileName</code> and the
2007            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
2008            * name of the actual file being uploaded. The <code>title</code>
2009            * corresponds to a name the client wishes to assign this file after it has
2010            * been uploaded to the portal.
2011            * </p>
2012            *
2013            * @param fileEntryId the primary key of the file entry
2014            * @param sourceFileName the original file's name (optionally
2015            <code>null</code>)
2016            * @param mimeType the file's MIME type (optionally <code>null</code>)
2017            * @param title the new name to be assigned to the file (optionally <code>
2018            <code>null</code></code>)
2019            * @param description the file's new description
2020            * @param changeLog the file's version change log (optionally
2021            <code>null</code>)
2022            * @param majorVersion whether the new file version is a major version
2023            * @param file EntryId the primary key of the file entry
2024            * @param serviceContext the service context to be applied. Can set the
2025            asset category IDs, asset tag names, and expando bridge
2026            attributes for the file entry. In a Liferay repository, it may
2027            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
2028            type </li> <li> fieldsMap - mapping for fields associated with a
2029            custom file entry type </li> </ul>
2030            * @return the file entry
2031            * @throws PortalException if the file entry could not be found
2032            * @throws SystemException if a system exception occurred
2033            */
2034            public com.liferay.portal.kernel.repository.model.FileEntry updateFileEntry(
2035                    long fileEntryId, java.lang.String sourceFileName,
2036                    java.lang.String mimeType, java.lang.String title,
2037                    java.lang.String description, java.lang.String changeLog,
2038                    boolean majorVersion, java.io.File file,
2039                    com.liferay.portal.service.ServiceContext serviceContext)
2040                    throws com.liferay.portal.kernel.exception.PortalException,
2041                            com.liferay.portal.kernel.exception.SystemException;
2042    
2043            /**
2044            * Updates a file entry and associated metadata based on an {@link java.io.
2045            * InputStream} object. If the file data is <code>null</code>, then only the
2046            * associated metadata (i.e., <code>title</code>, <code>description</code>,
2047            * and parameters in the <code>serviceContext</code>) will be updated.
2048            *
2049            * <p>
2050            * This method takes two file names, the <code>sourceFileName</code> and the
2051            * <code>title</code>. The <code>sourceFileName</code> corresponds to the
2052            * name of the actual file being uploaded. The <code>title</code>
2053            * corresponds to a name the client wishes to assign this file after it has
2054            * been uploaded to the portal.
2055            * </p>
2056            *
2057            * @param fileEntryId the primary key of the file entry
2058            * @param sourceFileName the original file's name (optionally
2059            <code>null</code>)
2060            * @param mimeType the file's MIME type (optionally <code>null</code>)
2061            * @param title the new name to be assigned to the file (optionally <code>
2062            <code>null</code></code>)
2063            * @param description the file's new description
2064            * @param changeLog the file's version change log (optionally
2065            <code>null</code>)
2066            * @param majorVersion whether the new file version is a major version
2067            * @param is the file's data (optionally <code>null</code>)
2068            * @param size the file's size (optionally <code>0</code>)
2069            * @param serviceContext the service context to be applied. Can set the
2070            asset category IDs, asset tag names, and expando bridge
2071            attributes for the file entry. In a Liferay repository, it may
2072            include:  <ul> <li> fileEntryTypeId - ID for a custom file entry
2073            type </li> <li> fieldsMap - mapping for fields associated with a
2074            custom file entry type </li> </ul>
2075            * @return the file entry
2076            * @throws PortalException if the file entry could not be found
2077            * @throws SystemException if a system exception occurred
2078            */
2079            public com.liferay.portal.kernel.repository.model.FileEntry updateFileEntry(
2080                    long fileEntryId, java.lang.String sourceFileName,
2081                    java.lang.String mimeType, java.lang.String title,
2082                    java.lang.String description, java.lang.String changeLog,
2083                    boolean majorVersion, java.io.InputStream is, long size,
2084                    com.liferay.portal.service.ServiceContext serviceContext)
2085                    throws com.liferay.portal.kernel.exception.PortalException,
2086                            com.liferay.portal.kernel.exception.SystemException;
2087    
2088            public com.liferay.portal.kernel.repository.model.FileEntry updateFileEntryAndCheckIn(
2089                    long fileEntryId, java.lang.String sourceFileName,
2090                    java.lang.String mimeType, java.lang.String title,
2091                    java.lang.String description, java.lang.String changeLog,
2092                    boolean majorVersion, java.io.File file,
2093                    com.liferay.portal.service.ServiceContext serviceContext)
2094                    throws com.liferay.portal.kernel.exception.PortalException,
2095                            com.liferay.portal.kernel.exception.SystemException;
2096    
2097            public com.liferay.portal.kernel.repository.model.FileEntry updateFileEntryAndCheckIn(
2098                    long fileEntryId, java.lang.String sourceFileName,
2099                    java.lang.String mimeType, java.lang.String title,
2100                    java.lang.String description, java.lang.String changeLog,
2101                    boolean majorVersion, java.io.InputStream is, long size,
2102                    com.liferay.portal.service.ServiceContext serviceContext)
2103                    throws com.liferay.portal.kernel.exception.PortalException,
2104                            com.liferay.portal.kernel.exception.SystemException;
2105    
2106            /**
2107            * Updates a file shortcut to the existing file entry. This method is only
2108            * supported by the Liferay repository.
2109            *
2110            * @param fileShortcutId the primary key of the file shortcut
2111            * @param folderId the primary key of the file shortcut's parent folder
2112            * @param toFileEntryId the primary key of the file shortcut's file entry
2113            * @param serviceContext the service context to be applied. Can set the
2114            asset category IDs, asset tag names, and expando bridge
2115            attributes for the file entry.
2116            * @return the file shortcut
2117            * @throws PortalException if the file shortcut, folder, or file entry could
2118            not be found
2119            * @throws SystemException if a system exception occurred
2120            */
2121            public com.liferay.portlet.documentlibrary.model.DLFileShortcut updateFileShortcut(
2122                    long fileShortcutId, long folderId, long toFileEntryId,
2123                    com.liferay.portal.service.ServiceContext serviceContext)
2124                    throws com.liferay.portal.kernel.exception.PortalException,
2125                            com.liferay.portal.kernel.exception.SystemException;
2126    
2127            /**
2128            * Updates the folder.
2129            *
2130            * @param folderId the primary key of the folder
2131            * @param name the folder's new name
2132            * @param description the folder's new description
2133            * @param serviceContext the service context to be applied. In a Liferay
2134            repository, it may include:  <ul> <li> defaultFileEntryTypeId -
2135            the file entry type to default all Liferay file entries to </li>
2136            <li> dlFileEntryTypesSearchContainerPrimaryKeys - a
2137            comma-delimited list of file entry type primary keys allowed in
2138            the given folder and all descendants </li> <li>
2139            overrideFileEntryTypes - boolean specifying whether to override
2140            ancestral folder's restriction of file entry types allowed </li>
2141            <li> workflowDefinitionXYZ - the workflow definition name
2142            specified per file entry type. The parameter name must be the
2143            string <code>workflowDefinition</code> appended by the <code>
2144            fileEntryTypeId</code> (optionally <code>0</code>). </li> </ul>
2145            * @return the folder
2146            * @throws PortalException if the current or new parent folder could not be
2147            found or if the new parent folder's information was invalid
2148            * @throws SystemException if a system exception occurred
2149            */
2150            public com.liferay.portal.kernel.repository.model.Folder updateFolder(
2151                    long folderId, java.lang.String name, java.lang.String description,
2152                    com.liferay.portal.service.ServiceContext serviceContext)
2153                    throws com.liferay.portal.kernel.exception.PortalException,
2154                            com.liferay.portal.kernel.exception.SystemException;
2155    
2156            /**
2157            * Returns <code>true</code> if the file entry is checked out. This method
2158            * is primarily used by WebDAV.
2159            *
2160            * @param repositoryId the primary key for the repository
2161            * @param fileEntryId the primary key for the file entry
2162            * @param lockUuid the lock's UUID
2163            * @return <code>true</code> if the file entry is checked out;
2164            <code>false</code> otherwise
2165            * @throws PortalException if the file entry could not be found
2166            * @throws SystemException if a system exception occurred
2167            */
2168            public boolean verifyFileEntryCheckOut(long repositoryId, long fileEntryId,
2169                    java.lang.String lockUuid)
2170                    throws com.liferay.portal.kernel.exception.PortalException,
2171                            com.liferay.portal.kernel.exception.SystemException;
2172    
2173            public boolean verifyFileEntryLock(long repositoryId, long fileEntryId,
2174                    java.lang.String lockUuid)
2175                    throws com.liferay.portal.kernel.exception.PortalException,
2176                            com.liferay.portal.kernel.exception.SystemException;
2177    
2178            /**
2179            * Returns <code>true</code> if the inheritable lock exists. This method is
2180            * primarily used by WebDAV.
2181            *
2182            * @param repositoryId the primary key for the repository
2183            * @param folderId the primary key for the folder
2184            * @param lockUuid the lock's UUID
2185            * @return <code>true</code> if the inheritable lock exists;
2186            <code>false</code> otherwise
2187            * @throws PortalException if the folder could not be found
2188            * @throws SystemException if a system exception occurred
2189            */
2190            public boolean verifyInheritableLock(long repositoryId, long folderId,
2191                    java.lang.String lockUuid)
2192                    throws com.liferay.portal.kernel.exception.PortalException,
2193                            com.liferay.portal.kernel.exception.SystemException;
2194    }