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            /**
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) throws PortalException;
142    
143            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
144            public long[] getCategoryIds(long groupId, long categoryId);
145    
146            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
147            public java.util.List<java.lang.Long> getSubcategoryIds(
148                    java.util.List<java.lang.Long> categoryIds, long groupId,
149                    long categoryId);
150    
151            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
152            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
153                    long groupId, long userId, int start, int end);
154    
155            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
156            public int getSubscribedCategoriesCount(long groupId, long userId);
157    
158            public com.liferay.portlet.messageboards.model.MBCategory moveCategory(
159                    long categoryId, long parentCategoryId, boolean mergeWithParentCategory)
160                    throws PortalException;
161    
162            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryFromTrash(
163                    long categoryId, long newCategoryId) throws PortalException;
164    
165            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryToTrash(
166                    long categoryId) throws PortalException;
167    
168            public void restoreCategoryFromTrash(long categoryId)
169                    throws PortalException;
170    
171            /**
172            * Sets the Spring bean ID for this bean.
173            *
174            * @param beanIdentifier the Spring bean ID for this bean
175            */
176            public void setBeanIdentifier(java.lang.String beanIdentifier);
177    
178            public void subscribeCategory(long groupId, long categoryId)
179                    throws PortalException;
180    
181            public void unsubscribeCategory(long groupId, long categoryId)
182                    throws PortalException;
183    
184            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
185                    long categoryId, long parentCategoryId, java.lang.String name,
186                    java.lang.String description, java.lang.String displayStyle,
187                    java.lang.String emailAddress, java.lang.String inProtocol,
188                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
189                    java.lang.String inUserName, java.lang.String inPassword,
190                    int inReadInterval, java.lang.String outEmailAddress,
191                    boolean outCustom, java.lang.String outServerName, int outServerPort,
192                    boolean outUseSSL, java.lang.String outUserName,
193                    java.lang.String outPassword, boolean mailingListActive,
194                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
195                    com.liferay.portal.service.ServiceContext serviceContext)
196                    throws PortalException;
197    }