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