001    /**
002     * Copyright (c) 2000-present 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.journal.service;
016    
017    import aQute.bnd.annotation.ProviderType;
018    
019    import com.liferay.portal.kernel.exception.PortalException;
020    import com.liferay.portal.kernel.exception.SystemException;
021    import com.liferay.portal.kernel.jsonwebservice.JSONWebService;
022    import com.liferay.portal.kernel.transaction.Isolation;
023    import com.liferay.portal.kernel.transaction.Propagation;
024    import com.liferay.portal.kernel.transaction.Transactional;
025    import com.liferay.portal.security.ac.AccessControlled;
026    import com.liferay.portal.service.BaseService;
027    
028    /**
029     * Provides the remote service interface for JournalFolder. Methods of this
030     * service are expected to have security checks based on the propagated JAAS
031     * credentials because this service can be accessed remotely.
032     *
033     * @author Brian Wing Shun Chan
034     * @see JournalFolderServiceUtil
035     * @see com.liferay.portlet.journal.service.base.JournalFolderServiceBaseImpl
036     * @see com.liferay.portlet.journal.service.impl.JournalFolderServiceImpl
037     * @generated
038     */
039    @AccessControlled
040    @JSONWebService
041    @ProviderType
042    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
043            PortalException.class, SystemException.class})
044    public interface JournalFolderService extends BaseService {
045            /*
046             * NOTE FOR DEVELOPERS:
047             *
048             * Never modify or reference this interface directly. Always use {@link JournalFolderServiceUtil} to access the journal folder remote service. Add custom service methods to {@link com.liferay.portlet.journal.service.impl.JournalFolderServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface.
049             */
050            public com.liferay.portlet.journal.model.JournalFolder addFolder(
051                    long groupId, long parentFolderId, java.lang.String name,
052                    java.lang.String description,
053                    com.liferay.portal.service.ServiceContext serviceContext)
054                    throws com.liferay.portal.kernel.exception.PortalException;
055    
056            public void deleteFolder(long folderId)
057                    throws com.liferay.portal.kernel.exception.PortalException;
058    
059            public void deleteFolder(long folderId, boolean includeTrashedEntries)
060                    throws com.liferay.portal.kernel.exception.PortalException;
061    
062            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
063            public com.liferay.portlet.journal.model.JournalFolder fetchFolder(
064                    long folderId)
065                    throws com.liferay.portal.kernel.exception.PortalException;
066    
067            /**
068            * Returns the Spring bean ID for this bean.
069            *
070            * @return the Spring bean ID for this bean
071            */
072            public java.lang.String getBeanIdentifier();
073    
074            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
075            public com.liferay.portlet.journal.model.JournalFolder getFolder(
076                    long folderId)
077                    throws com.liferay.portal.kernel.exception.PortalException;
078    
079            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
080            public java.util.List<java.lang.Long> getFolderIds(long groupId,
081                    long folderId)
082                    throws com.liferay.portal.kernel.exception.PortalException;
083    
084            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
085            public java.util.List<com.liferay.portlet.journal.model.JournalFolder> getFolders(
086                    long groupId);
087    
088            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
089            public java.util.List<com.liferay.portlet.journal.model.JournalFolder> getFolders(
090                    long groupId, long parentFolderId);
091    
092            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
093            public java.util.List<com.liferay.portlet.journal.model.JournalFolder> getFolders(
094                    long groupId, long parentFolderId, int start, int end);
095    
096            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
097            public java.util.List<com.liferay.portlet.journal.model.JournalFolder> getFolders(
098                    long groupId, long parentFolderId, int status);
099    
100            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
101            public java.util.List<com.liferay.portlet.journal.model.JournalFolder> getFolders(
102                    long groupId, long parentFolderId, int status, int start, int end);
103    
104            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
105            public java.util.List<java.lang.Object> getFoldersAndArticles(
106                    long groupId, long folderId, int start, int end,
107                    com.liferay.portal.kernel.util.OrderByComparator<?> obc);
108    
109            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
110            public java.util.List<java.lang.Object> getFoldersAndArticles(
111                    long groupId, long folderId, int status, int start, int end,
112                    com.liferay.portal.kernel.util.OrderByComparator<?> obc);
113    
114            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
115            public int getFoldersAndArticlesCount(long groupId, long folderId);
116    
117            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
118            public int getFoldersAndArticlesCount(long groupId, long folderId,
119                    int status);
120    
121            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
122            public int getFoldersAndArticlesCount(long groupId,
123                    java.util.List<java.lang.Long> folderIds, int status);
124    
125            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
126            public int getFoldersCount(long groupId, long parentFolderId);
127    
128            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
129            public int getFoldersCount(long groupId, long parentFolderId, int status);
130    
131            /**
132            * @deprecated As of 7.0.0, replaced by {@link #getSubfolderIds(List, long,
133            long, boolean)}
134            */
135            @java.lang.Deprecated
136            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
137            public void getSubfolderIds(java.util.List<java.lang.Long> folderIds,
138                    long groupId, long folderId);
139    
140            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
141            public void getSubfolderIds(java.util.List<java.lang.Long> folderIds,
142                    long groupId, long folderId, boolean recurse);
143    
144            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
145            public java.util.List<java.lang.Long> getSubfolderIds(long groupId,
146                    long folderId, boolean recurse);
147    
148            public com.liferay.portlet.journal.model.JournalFolder moveFolder(
149                    long folderId, long parentFolderId,
150                    com.liferay.portal.service.ServiceContext serviceContext)
151                    throws com.liferay.portal.kernel.exception.PortalException;
152    
153            public com.liferay.portlet.journal.model.JournalFolder moveFolderFromTrash(
154                    long folderId, long parentFolderId,
155                    com.liferay.portal.service.ServiceContext serviceContext)
156                    throws com.liferay.portal.kernel.exception.PortalException;
157    
158            public com.liferay.portlet.journal.model.JournalFolder moveFolderToTrash(
159                    long folderId)
160                    throws com.liferay.portal.kernel.exception.PortalException;
161    
162            public void restoreFolderFromTrash(long folderId)
163                    throws com.liferay.portal.kernel.exception.PortalException;
164    
165            /**
166            * Sets the Spring bean ID for this bean.
167            *
168            * @param beanIdentifier the Spring bean ID for this bean
169            */
170            public void setBeanIdentifier(java.lang.String beanIdentifier);
171    
172            public void subscribe(long groupId, long folderId)
173                    throws com.liferay.portal.kernel.exception.PortalException;
174    
175            public void unsubscribe(long groupId, long folderId)
176                    throws com.liferay.portal.kernel.exception.PortalException;
177    
178            public com.liferay.portlet.journal.model.JournalFolder updateFolder(
179                    long folderId, long parentFolderId, java.lang.String name,
180                    java.lang.String description, long[] ddmStructureIds,
181                    int restrictionType, boolean mergeWithParentFolder,
182                    com.liferay.portal.service.ServiceContext serviceContext)
183                    throws com.liferay.portal.kernel.exception.PortalException;
184    
185            public com.liferay.portlet.journal.model.JournalFolder updateFolder(
186                    long folderId, long parentFolderId, java.lang.String name,
187                    java.lang.String description, boolean mergeWithParentFolder,
188                    com.liferay.portal.service.ServiceContext serviceContext)
189                    throws com.liferay.portal.kernel.exception.PortalException;
190    }