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.messageboards.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.security.access.control.AccessControlled;
023    import com.liferay.portal.kernel.transaction.Isolation;
024    import com.liferay.portal.kernel.transaction.Propagation;
025    import com.liferay.portal.kernel.transaction.Transactional;
026    import com.liferay.portal.service.BaseService;
027    
028    /**
029     * Provides the remote service interface for MBCategory. 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 MBCategoryServiceUtil
035     * @see com.liferay.portlet.messageboards.service.base.MBCategoryServiceBaseImpl
036     * @see com.liferay.portlet.messageboards.service.impl.MBCategoryServiceImpl
037     * @generated
038     */
039    @AccessControlled
040    @JSONWebService
041    @ProviderType
042    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
043            PortalException.class, SystemException.class})
044    public interface MBCategoryService extends BaseService {
045            /*
046             * NOTE FOR DEVELOPERS:
047             *
048             * Never modify or reference this interface directly. Always use {@link MBCategoryServiceUtil} to access the message boards category remote service. Add custom service methods to {@link com.liferay.portlet.messageboards.service.impl.MBCategoryServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface.
049             */
050            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
051                    long parentCategoryId, java.lang.String name,
052                    java.lang.String description, java.lang.String displayStyle,
053                    java.lang.String emailAddress, java.lang.String inProtocol,
054                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
055                    java.lang.String inUserName, java.lang.String inPassword,
056                    int inReadInterval, java.lang.String outEmailAddress,
057                    boolean outCustom, java.lang.String outServerName, int outServerPort,
058                    boolean outUseSSL, java.lang.String outUserName,
059                    java.lang.String outPassword, boolean mailingListActive,
060                    boolean allowAnonymousEmail,
061                    com.liferay.portal.service.ServiceContext serviceContext)
062                    throws PortalException;
063    
064            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
065                    long userId, long parentCategoryId, java.lang.String name,
066                    java.lang.String description,
067                    com.liferay.portal.service.ServiceContext serviceContext)
068                    throws PortalException;
069    
070            public void deleteCategory(long categoryId, boolean includeTrashedEntries)
071                    throws PortalException;
072    
073            public void deleteCategory(long groupId, long categoryId)
074                    throws PortalException;
075    
076            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
077            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
078                    long groupId);
079    
080            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
081            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
082                    long groupId, long excludedCategoryId, long parentCategoryId,
083                    int status, int start, int end);
084    
085            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
086            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
087                    long groupId, long[] excludedCategoryIds, long[] parentCategoryIds,
088                    int status, int start, int end);
089    
090            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
091            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
092                    long groupId, long parentCategoryId, int start, int end);
093    
094            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
095            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
096                    long groupId, long parentCategoryId, int status, int start, int end);
097    
098            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
099            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
100                    long groupId, long[] parentCategoryIds, int start, int end);
101    
102            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
103            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
104                    long groupId, long[] parentCategoryIds, int status, int start, int end);
105    
106            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
107            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
108                    long groupId, int status);
109    
110            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
111            public java.util.List<java.lang.Object> getCategoriesAndThreads(
112                    long groupId, long categoryId);
113    
114            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
115            public java.util.List<java.lang.Object> getCategoriesAndThreads(
116                    long groupId, long categoryId, int status);
117    
118            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
119            public java.util.List<java.lang.Object> getCategoriesAndThreads(
120                    long groupId, long categoryId, int status, int start, int end);
121    
122            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
123            public int getCategoriesAndThreadsCount(long groupId, long categoryId);
124    
125            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
126            public int getCategoriesAndThreadsCount(long groupId, long categoryId,
127                    int status);
128    
129            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
130            public int getCategoriesCount(long groupId, long excludedCategoryId,
131                    long parentCategoryId, int status);
132    
133            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
134            public int getCategoriesCount(long groupId, long[] excludedCategoryIds,
135                    long[] parentCategoryIds, int status);
136    
137            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
138            public int getCategoriesCount(long groupId, long parentCategoryId);
139    
140            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
141            public int getCategoriesCount(long groupId, long parentCategoryId,
142                    int status);
143    
144            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
145            public int getCategoriesCount(long groupId, long[] parentCategoryIds);
146    
147            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
148            public int getCategoriesCount(long groupId, long[] parentCategoryIds,
149                    int status);
150    
151            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
152            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
153                    long categoryId) throws PortalException;
154    
155            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
156            public long[] getCategoryIds(long groupId, long categoryId);
157    
158            /**
159            * Returns the OSGi service identifier.
160            *
161            * @return the OSGi service identifier
162            */
163            public java.lang.String getOSGiServiceIdentifier();
164    
165            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
166            public java.util.List<java.lang.Long> getSubcategoryIds(
167                    java.util.List<java.lang.Long> categoryIds, long groupId,
168                    long categoryId);
169    
170            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
171            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
172                    long groupId, long userId, int start, int end);
173    
174            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
175            public int getSubscribedCategoriesCount(long groupId, long userId);
176    
177            public com.liferay.portlet.messageboards.model.MBCategory moveCategory(
178                    long categoryId, long parentCategoryId, boolean mergeWithParentCategory)
179                    throws PortalException;
180    
181            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryFromTrash(
182                    long categoryId, long newCategoryId) throws PortalException;
183    
184            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryToTrash(
185                    long categoryId) throws PortalException;
186    
187            public void restoreCategoryFromTrash(long categoryId)
188                    throws PortalException;
189    
190            public void subscribeCategory(long groupId, long categoryId)
191                    throws PortalException;
192    
193            public void unsubscribeCategory(long groupId, long categoryId)
194                    throws PortalException;
195    
196            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
197                    long categoryId, long parentCategoryId, java.lang.String name,
198                    java.lang.String description, java.lang.String displayStyle,
199                    java.lang.String emailAddress, java.lang.String inProtocol,
200                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
201                    java.lang.String inUserName, java.lang.String inPassword,
202                    int inReadInterval, java.lang.String outEmailAddress,
203                    boolean outCustom, java.lang.String outServerName, int outServerPort,
204                    boolean outUseSSL, java.lang.String outUserName,
205                    java.lang.String outPassword, boolean mailingListActive,
206                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
207                    com.liferay.portal.service.ServiceContext serviceContext)
208                    throws PortalException;
209    }