001    /**
002     * Copyright (c) 2000-2010 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.annotation.Isolation;
018    import com.liferay.portal.kernel.annotation.Propagation;
019    import com.liferay.portal.kernel.annotation.Transactional;
020    import com.liferay.portal.kernel.exception.PortalException;
021    import com.liferay.portal.kernel.exception.SystemException;
022    
023    /**
024     * The interface for the message boards category remote service.
025     *
026     * <p>
027     * 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.
028     * </p>
029     *
030     * <p>
031     * 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.
032     * </p>
033     *
034     * @author Brian Wing Shun Chan
035     * @see MBCategoryServiceUtil
036     * @see com.liferay.portlet.messageboards.service.base.MBCategoryServiceBaseImpl
037     * @see com.liferay.portlet.messageboards.service.impl.MBCategoryServiceImpl
038     * @generated
039     */
040    @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
041            PortalException.class, SystemException.class})
042    public interface MBCategoryService {
043            public com.liferay.portlet.messageboards.model.MBCategory addCategory(
044                    long parentCategoryId, java.lang.String name,
045                    java.lang.String description, java.lang.String emailAddress,
046                    java.lang.String inProtocol, java.lang.String inServerName,
047                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
048                    java.lang.String inPassword, int inReadInterval,
049                    java.lang.String outEmailAddress, boolean outCustom,
050                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
051                    java.lang.String outUserName, java.lang.String outPassword,
052                    boolean mailingListActive,
053                    com.liferay.portal.service.ServiceContext serviceContext)
054                    throws com.liferay.portal.kernel.exception.PortalException,
055                            com.liferay.portal.kernel.exception.SystemException;
056    
057            public void deleteCategory(long groupId, long categoryId)
058                    throws com.liferay.portal.kernel.exception.PortalException,
059                            com.liferay.portal.kernel.exception.SystemException;
060    
061            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
062            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
063                    long groupId, long parentCategoryId, int start, int end)
064                    throws com.liferay.portal.kernel.exception.SystemException;
065    
066            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
067            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
068                    long groupId, long[] parentCategoryIds, int start, int end)
069                    throws com.liferay.portal.kernel.exception.SystemException;
070    
071            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
072            public int getCategoriesCount(long groupId, long parentCategoryId)
073                    throws com.liferay.portal.kernel.exception.SystemException;
074    
075            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
076            public int getCategoriesCount(long groupId, long[] parentCategoryIds)
077                    throws com.liferay.portal.kernel.exception.SystemException;
078    
079            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
080            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
081                    long categoryId)
082                    throws com.liferay.portal.kernel.exception.PortalException,
083                            com.liferay.portal.kernel.exception.SystemException;
084    
085            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
086            public long[] getCategoryIds(long groupId, long categoryId)
087                    throws com.liferay.portal.kernel.exception.SystemException;
088    
089            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
090            public java.util.List<java.lang.Long> getSubcategoryIds(
091                    java.util.List<java.lang.Long> categoryIds, long groupId,
092                    long categoryId)
093                    throws 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> getSubscribedCategories(
097                    long groupId, long userId, int start, int end)
098                    throws com.liferay.portal.kernel.exception.SystemException;
099    
100            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
101            public int getSubscribedCategoriesCount(long groupId, long userId)
102                    throws com.liferay.portal.kernel.exception.SystemException;
103    
104            public void subscribeCategory(long groupId, long categoryId)
105                    throws com.liferay.portal.kernel.exception.PortalException,
106                            com.liferay.portal.kernel.exception.SystemException;
107    
108            public void unsubscribeCategory(long groupId, long categoryId)
109                    throws com.liferay.portal.kernel.exception.PortalException,
110                            com.liferay.portal.kernel.exception.SystemException;
111    
112            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
113                    long categoryId, long parentCategoryId, java.lang.String name,
114                    java.lang.String description, java.lang.String emailAddress,
115                    java.lang.String inProtocol, java.lang.String inServerName,
116                    int inServerPort, boolean inUseSSL, java.lang.String inUserName,
117                    java.lang.String inPassword, int inReadInterval,
118                    java.lang.String outEmailAddress, boolean outCustom,
119                    java.lang.String outServerName, int outServerPort, boolean outUseSSL,
120                    java.lang.String outUserName, java.lang.String outPassword,
121                    boolean mailingListActive, boolean mergeWithParentCategory,
122                    com.liferay.portal.service.ServiceContext serviceContext)
123                    throws com.liferay.portal.kernel.exception.PortalException,
124                            com.liferay.portal.kernel.exception.SystemException;
125    }