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