001    /**
002     * Copyright (c) 2000-2012 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 parentCategoryId, java.lang.String name,
066                    java.lang.String description, java.lang.String displayStyle,
067                    java.lang.String emailAddress, java.lang.String inProtocol,
068                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
069                    java.lang.String inUserName, java.lang.String inPassword,
070                    int inReadInterval, java.lang.String outEmailAddress,
071                    boolean outCustom, java.lang.String outServerName, int outServerPort,
072                    boolean outUseSSL, java.lang.String outUserName,
073                    java.lang.String outPassword, boolean mailingListActive,
074                    boolean allowAnonymousEmail,
075                    com.liferay.portal.service.ServiceContext serviceContext)
076                    throws com.liferay.portal.kernel.exception.PortalException,
077                            com.liferay.portal.kernel.exception.SystemException;
078    
079            public void deleteCategory(long groupId, long categoryId)
080                    throws com.liferay.portal.kernel.exception.PortalException,
081                            com.liferay.portal.kernel.exception.SystemException;
082    
083            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
084            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
085                    long groupId)
086                    throws com.liferay.portal.kernel.exception.SystemException;
087    
088            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
089            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
090                    long groupId, long parentCategoryId, int start, int end)
091                    throws com.liferay.portal.kernel.exception.SystemException;
092    
093            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
094            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
095                    long groupId, long[] parentCategoryIds, int start, int end)
096                    throws com.liferay.portal.kernel.exception.SystemException;
097    
098            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
099            public int getCategoriesCount(long groupId, long parentCategoryId)
100                    throws com.liferay.portal.kernel.exception.SystemException;
101    
102            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
103            public int getCategoriesCount(long groupId, long[] parentCategoryIds)
104                    throws com.liferay.portal.kernel.exception.SystemException;
105    
106            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
107            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
108                    long categoryId)
109                    throws com.liferay.portal.kernel.exception.PortalException,
110                            com.liferay.portal.kernel.exception.SystemException;
111    
112            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
113            public long[] getCategoryIds(long groupId, long categoryId)
114                    throws com.liferay.portal.kernel.exception.SystemException;
115    
116            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
117            public java.util.List<java.lang.Long> getSubcategoryIds(
118                    java.util.List<java.lang.Long> categoryIds, long groupId,
119                    long categoryId)
120                    throws com.liferay.portal.kernel.exception.SystemException;
121    
122            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
123            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
124                    long groupId, long userId, int start, int end)
125                    throws com.liferay.portal.kernel.exception.SystemException;
126    
127            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
128            public int getSubscribedCategoriesCount(long groupId, long userId)
129                    throws com.liferay.portal.kernel.exception.SystemException;
130    
131            public void subscribeCategory(long groupId, long categoryId)
132                    throws com.liferay.portal.kernel.exception.PortalException,
133                            com.liferay.portal.kernel.exception.SystemException;
134    
135            public void unsubscribeCategory(long groupId, long categoryId)
136                    throws com.liferay.portal.kernel.exception.PortalException,
137                            com.liferay.portal.kernel.exception.SystemException;
138    
139            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
140                    long categoryId, long parentCategoryId, java.lang.String name,
141                    java.lang.String description, java.lang.String displayStyle,
142                    java.lang.String emailAddress, java.lang.String inProtocol,
143                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
144                    java.lang.String inUserName, java.lang.String inPassword,
145                    int inReadInterval, java.lang.String outEmailAddress,
146                    boolean outCustom, java.lang.String outServerName, int outServerPort,
147                    boolean outUseSSL, java.lang.String outUserName,
148                    java.lang.String outPassword, boolean mailingListActive,
149                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
150                    com.liferay.portal.service.ServiceContext serviceContext)
151                    throws com.liferay.portal.kernel.exception.PortalException,
152                            com.liferay.portal.kernel.exception.SystemException;
153    }