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.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 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 com.liferay.portal.kernel.exception.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 com.liferay.portal.kernel.exception.PortalException;
069    
070            public void deleteCategory(long categoryId, boolean includeTrashedEntries)
071                    throws com.liferay.portal.kernel.exception.PortalException;
072    
073            public void deleteCategory(long groupId, long categoryId)
074                    throws com.liferay.portal.kernel.exception.PortalException;
075    
076            /**
077            * Returns the Spring bean ID for this bean.
078            *
079            * @return the Spring bean ID for this bean
080            */
081            public java.lang.String getBeanIdentifier();
082    
083            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
084            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
085                    long groupId);
086    
087            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
088            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
089                    long groupId, long excludedCategoryId, long parentCategoryId,
090                    int status, int start, int end);
091    
092            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
093            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
094                    long groupId, long[] excludedCategoryIds, long[] parentCategoryIds,
095                    int status, int start, int end);
096    
097            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
098            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
099                    long groupId, long parentCategoryId, int start, int end);
100    
101            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
102            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
103                    long groupId, long parentCategoryId, int status, int start, int end);
104    
105            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
106            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
107                    long groupId, long[] parentCategoryIds, int start, int end);
108    
109            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
110            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
111                    long groupId, long[] parentCategoryIds, int status, int start, int end);
112    
113            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
114            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
115                    long groupId, int status);
116    
117            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
118            public int getCategoriesCount(long groupId, long excludedCategoryId,
119                    long parentCategoryId, int status);
120    
121            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
122            public int getCategoriesCount(long groupId, long[] excludedCategoryIds,
123                    long[] parentCategoryIds, int status);
124    
125            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
126            public int getCategoriesCount(long groupId, long parentCategoryId);
127    
128            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
129            public int getCategoriesCount(long groupId, long parentCategoryId,
130                    int status);
131    
132            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
133            public int getCategoriesCount(long groupId, long[] parentCategoryIds);
134    
135            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
136            public int getCategoriesCount(long groupId, long[] parentCategoryIds,
137                    int status);
138    
139            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
140            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
141                    long categoryId)
142                    throws com.liferay.portal.kernel.exception.PortalException;
143    
144            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
145            public long[] getCategoryIds(long groupId, long categoryId);
146    
147            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
148            public java.util.List<java.lang.Long> getSubcategoryIds(
149                    java.util.List<java.lang.Long> categoryIds, long groupId,
150                    long categoryId);
151    
152            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
153            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
154                    long groupId, long userId, int start, int end);
155    
156            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
157            public int getSubscribedCategoriesCount(long groupId, long userId);
158    
159            public com.liferay.portlet.messageboards.model.MBCategory moveCategory(
160                    long categoryId, long parentCategoryId, boolean mergeWithParentCategory)
161                    throws com.liferay.portal.kernel.exception.PortalException;
162    
163            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryFromTrash(
164                    long categoryId, long newCategoryId)
165                    throws com.liferay.portal.kernel.exception.PortalException;
166    
167            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryToTrash(
168                    long categoryId)
169                    throws com.liferay.portal.kernel.exception.PortalException;
170    
171            public void restoreCategoryFromTrash(long categoryId)
172                    throws com.liferay.portal.kernel.exception.PortalException;
173    
174            /**
175            * Sets the Spring bean ID for this bean.
176            *
177            * @param beanIdentifier the Spring bean ID for this bean
178            */
179            public void setBeanIdentifier(java.lang.String beanIdentifier);
180    
181            public void subscribeCategory(long groupId, long categoryId)
182                    throws com.liferay.portal.kernel.exception.PortalException;
183    
184            public void unsubscribeCategory(long groupId, long categoryId)
185                    throws com.liferay.portal.kernel.exception.PortalException;
186    
187            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
188                    long categoryId, long parentCategoryId, java.lang.String name,
189                    java.lang.String description, java.lang.String displayStyle,
190                    java.lang.String emailAddress, java.lang.String inProtocol,
191                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
192                    java.lang.String inUserName, java.lang.String inPassword,
193                    int inReadInterval, java.lang.String outEmailAddress,
194                    boolean outCustom, java.lang.String outServerName, int outServerPort,
195                    boolean outUseSSL, java.lang.String outUserName,
196                    java.lang.String outPassword, boolean mailingListActive,
197                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
198                    com.liferay.portal.service.ServiceContext serviceContext)
199                    throws com.liferay.portal.kernel.exception.PortalException;
200    }