001    /**
002     * Copyright (c) 2000-2011 Liferay, Inc. All rights reserved.
003     *
004     * The contents of this file are subject to the terms of the Liferay Enterprise
005     * Subscription License ("License"). You may not use this file except in
006     * compliance with the License. You can obtain a copy of the License by
007     * contacting Liferay, Inc. See the License for the specific language governing
008     * permissions and limitations under the License, including but not limited to
009     * distribution rights of the Software.
010     *
011     *
012     *
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    
024    /**
025     * The interface for the message boards category remote service.
026     *
027     * <p>
028     * 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.
029     * </p>
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    @JSONWebService
038    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
039            PortalException.class, SystemException.class})
040    public interface MBCategoryService {
041            /*
042             * NOTE FOR DEVELOPERS:
043             *
044             * 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.
045             */
046            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
047                    long parentCategoryId, java.lang.String name,
048                    java.lang.String description, java.lang.String emailAddress,
049                    java.lang.String inProtocol, java.lang.String inServerName,
050                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
051                    java.lang.String inPassword, int inReadInterval,
052                    java.lang.String outEmailAddress, boolean outCustom,
053                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
054                    java.lang.String outUserName, java.lang.String outPassword,
055                    boolean allowAnonymous, boolean mailingListActive,
056                    com.liferay.portal.service.ServiceContext serviceContext)
057                    throws com.liferay.portal.kernel.exception.PortalException,
058                            com.liferay.portal.kernel.exception.SystemException;
059    
060            /**
061            * @deprecated {@link #addCategory(long, String, String, String, String,
062            String, int, boolean, String, String, int, String, boolean,
063            String, int, boolean, String, String, boolean, boolean,
064            ServiceContext)}
065            */
066            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
067                    long parentCategoryId, java.lang.String name,
068                    java.lang.String description, java.lang.String emailAddress,
069                    java.lang.String inProtocol, java.lang.String inServerName,
070                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
071                    java.lang.String inPassword, int inReadInterval,
072                    java.lang.String outEmailAddress, boolean outCustom,
073                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
074                    java.lang.String outUserName, java.lang.String outPassword,
075                    boolean mailingListActive,
076                    com.liferay.portal.service.ServiceContext serviceContext)
077                    throws com.liferay.portal.kernel.exception.PortalException,
078                            com.liferay.portal.kernel.exception.SystemException;
079    
080            public void deleteCategory(long groupId, long categoryId)
081                    throws com.liferay.portal.kernel.exception.PortalException,
082                            com.liferay.portal.kernel.exception.SystemException;
083    
084            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
085            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
086                    long groupId)
087                    throws com.liferay.portal.kernel.exception.SystemException;
088    
089            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
090            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
091                    long groupId, long parentCategoryId, int start, int end)
092                    throws 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, long[] parentCategoryIds, int start, int end)
097                    throws com.liferay.portal.kernel.exception.SystemException;
098    
099            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
100            public int getCategoriesCount(long groupId, long parentCategoryId)
101                    throws com.liferay.portal.kernel.exception.SystemException;
102    
103            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
104            public int getCategoriesCount(long groupId, long[] parentCategoryIds)
105                    throws com.liferay.portal.kernel.exception.SystemException;
106    
107            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
108            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
109                    long categoryId)
110                    throws com.liferay.portal.kernel.exception.PortalException,
111                            com.liferay.portal.kernel.exception.SystemException;
112    
113            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
114            public long[] getCategoryIds(long groupId, long categoryId)
115                    throws com.liferay.portal.kernel.exception.SystemException;
116    
117            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
118            public java.util.List<java.lang.Long> getSubcategoryIds(
119                    java.util.List<java.lang.Long> categoryIds, long groupId,
120                    long categoryId)
121                    throws com.liferay.portal.kernel.exception.SystemException;
122    
123            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
124            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
125                    long groupId, long userId, int start, int end)
126                    throws com.liferay.portal.kernel.exception.SystemException;
127    
128            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
129            public int getSubscribedCategoriesCount(long groupId, long userId)
130                    throws com.liferay.portal.kernel.exception.SystemException;
131    
132            public void subscribeCategory(long groupId, long categoryId)
133                    throws com.liferay.portal.kernel.exception.PortalException,
134                            com.liferay.portal.kernel.exception.SystemException;
135    
136            public void unsubscribeCategory(long groupId, long categoryId)
137                    throws com.liferay.portal.kernel.exception.PortalException,
138                            com.liferay.portal.kernel.exception.SystemException;
139    
140            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
141                    long categoryId, long parentCategoryId, java.lang.String name,
142                    java.lang.String description, java.lang.String emailAddress,
143                    java.lang.String inProtocol, java.lang.String inServerName,
144                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
145                    java.lang.String inPassword, int inReadInterval,
146                    java.lang.String outEmailAddress, boolean outCustom,
147                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
148                    java.lang.String outUserName, java.lang.String outPassword,
149                    boolean allowAnonymous, boolean mailingListActive,
150                    boolean mergeWithParentCategory,
151                    com.liferay.portal.service.ServiceContext serviceContext)
152                    throws com.liferay.portal.kernel.exception.PortalException,
153                            com.liferay.portal.kernel.exception.SystemException;
154    
155            /**
156            * @deprecated {@link #updateCategory(long, long, String, String, String,
157            String, String, int, boolean, String, String, int, String,
158            boolean, String, int, boolean, String, String, boolean,
159            boolean, boolean, ServiceContext)}
160            */
161            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
162                    long categoryId, long parentCategoryId, java.lang.String name,
163                    java.lang.String description, java.lang.String emailAddress,
164                    java.lang.String inProtocol, java.lang.String inServerName,
165                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
166                    java.lang.String inPassword, int inReadInterval,
167                    java.lang.String outEmailAddress, boolean outCustom,
168                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
169                    java.lang.String outUserName, java.lang.String outPassword,
170                    boolean mailingListActive, boolean mergeWithParentCategory,
171                    com.liferay.portal.service.ServiceContext serviceContext)
172                    throws com.liferay.portal.kernel.exception.PortalException,
173                            com.liferay.portal.kernel.exception.SystemException;
174    }