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.messageboards.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     * The interface for the message boards category remote service.
028     *
029     * <p>
030     * This is a remote service. Methods of this service are expected to have security checks based on the propagated JAAS credentials because this service can be accessed remotely.
031     * </p>
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    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
042            PortalException.class, SystemException.class})
043    public interface MBCategoryService extends BaseService {
044            /*
045             * NOTE FOR DEVELOPERS:
046             *
047             * 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.
048             */
049    
050            /**
051            * Returns the Spring bean ID for this bean.
052            *
053            * @return the Spring bean ID for this bean
054            */
055            public java.lang.String getBeanIdentifier();
056    
057            /**
058            * Sets the Spring bean ID for this bean.
059            *
060            * @param beanIdentifier the Spring bean ID for this bean
061            */
062            public void setBeanIdentifier(java.lang.String beanIdentifier);
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                            com.liferay.portal.kernel.exception.SystemException;
070    
071            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
072                    long parentCategoryId, java.lang.String name,
073                    java.lang.String description, java.lang.String displayStyle,
074                    java.lang.String emailAddress, java.lang.String inProtocol,
075                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
076                    java.lang.String inUserName, java.lang.String inPassword,
077                    int inReadInterval, java.lang.String outEmailAddress,
078                    boolean outCustom, java.lang.String outServerName, int outServerPort,
079                    boolean outUseSSL, java.lang.String outUserName,
080                    java.lang.String outPassword, boolean mailingListActive,
081                    boolean allowAnonymousEmail,
082                    com.liferay.portal.service.ServiceContext serviceContext)
083                    throws com.liferay.portal.kernel.exception.PortalException,
084                            com.liferay.portal.kernel.exception.SystemException;
085    
086            public void deleteCategory(long categoryId, boolean includeTrashedEntries)
087                    throws com.liferay.portal.kernel.exception.PortalException,
088                            com.liferay.portal.kernel.exception.SystemException;
089    
090            public void deleteCategory(long groupId, long categoryId)
091                    throws com.liferay.portal.kernel.exception.PortalException,
092                            com.liferay.portal.kernel.exception.SystemException;
093    
094            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
095            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
096                    long groupId)
097                    throws com.liferay.portal.kernel.exception.SystemException;
098    
099            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
100            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
101                    long groupId, int status)
102                    throws com.liferay.portal.kernel.exception.SystemException;
103    
104            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
105            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
106                    long groupId, long parentCategoryId, int start, int end)
107                    throws com.liferay.portal.kernel.exception.SystemException;
108    
109            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
110            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
111                    long groupId, long parentCategoryId, int status, int start, int end)
112                    throws com.liferay.portal.kernel.exception.SystemException;
113    
114            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
115            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
116                    long groupId, long[] parentCategoryIds, int start, int end)
117                    throws com.liferay.portal.kernel.exception.SystemException;
118    
119            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
120            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
121                    long groupId, long[] parentCategoryIds, int status, int start, int end)
122                    throws com.liferay.portal.kernel.exception.SystemException;
123    
124            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
125            public int getCategoriesCount(long groupId, long parentCategoryId)
126                    throws com.liferay.portal.kernel.exception.SystemException;
127    
128            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
129            public int getCategoriesCount(long groupId, long parentCategoryId,
130                    int status) throws com.liferay.portal.kernel.exception.SystemException;
131    
132            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
133            public int getCategoriesCount(long groupId, long[] parentCategoryIds)
134                    throws com.liferay.portal.kernel.exception.SystemException;
135    
136            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
137            public int getCategoriesCount(long groupId, long[] parentCategoryIds,
138                    int status) throws com.liferay.portal.kernel.exception.SystemException;
139    
140            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
141            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
142                    long categoryId)
143                    throws com.liferay.portal.kernel.exception.PortalException,
144                            com.liferay.portal.kernel.exception.SystemException;
145    
146            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
147            public long[] getCategoryIds(long groupId, long categoryId)
148                    throws com.liferay.portal.kernel.exception.SystemException;
149    
150            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
151            public java.util.List<java.lang.Long> getSubcategoryIds(
152                    java.util.List<java.lang.Long> categoryIds, long groupId,
153                    long categoryId)
154                    throws com.liferay.portal.kernel.exception.SystemException;
155    
156            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
157            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
158                    long groupId, long userId, int start, int end)
159                    throws com.liferay.portal.kernel.exception.SystemException;
160    
161            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
162            public int getSubscribedCategoriesCount(long groupId, long userId)
163                    throws com.liferay.portal.kernel.exception.SystemException;
164    
165            public com.liferay.portlet.messageboards.model.MBCategory moveCategory(
166                    long categoryId, long parentCategoryId, boolean mergeWithParentCategory)
167                    throws com.liferay.portal.kernel.exception.PortalException,
168                            com.liferay.portal.kernel.exception.SystemException;
169    
170            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryFromTrash(
171                    long categoryId, long newCategoryId)
172                    throws com.liferay.portal.kernel.exception.PortalException,
173                            com.liferay.portal.kernel.exception.SystemException;
174    
175            public com.liferay.portlet.messageboards.model.MBCategory moveCategoryToTrash(
176                    long categoryId)
177                    throws com.liferay.portal.kernel.exception.PortalException,
178                            com.liferay.portal.kernel.exception.SystemException;
179    
180            public void restoreCategoryFromTrash(long categoryId)
181                    throws com.liferay.portal.kernel.exception.PortalException,
182                            com.liferay.portal.kernel.exception.SystemException;
183    
184            public void subscribeCategory(long groupId, long categoryId)
185                    throws com.liferay.portal.kernel.exception.PortalException,
186                            com.liferay.portal.kernel.exception.SystemException;
187    
188            public void unsubscribeCategory(long groupId, long categoryId)
189                    throws com.liferay.portal.kernel.exception.PortalException,
190                            com.liferay.portal.kernel.exception.SystemException;
191    
192            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
193                    long categoryId, long parentCategoryId, java.lang.String name,
194                    java.lang.String description, java.lang.String displayStyle,
195                    java.lang.String emailAddress, java.lang.String inProtocol,
196                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
197                    java.lang.String inUserName, java.lang.String inPassword,
198                    int inReadInterval, java.lang.String outEmailAddress,
199                    boolean outCustom, java.lang.String outServerName, int outServerPort,
200                    boolean outUseSSL, java.lang.String outUserName,
201                    java.lang.String outPassword, boolean mailingListActive,
202                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
203                    com.liferay.portal.service.ServiceContext serviceContext)
204                    throws com.liferay.portal.kernel.exception.PortalException,
205                            com.liferay.portal.kernel.exception.SystemException;
206    }