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.service.BaseService;
024    
025    /**
026     * The interface for the message boards category remote service.
027     *
028     * <p>
029     * 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.
030     * </p>
031     *
032     * @author Brian Wing Shun Chan
033     * @see MBCategoryServiceUtil
034     * @see com.liferay.portlet.messageboards.service.base.MBCategoryServiceBaseImpl
035     * @see com.liferay.portlet.messageboards.service.impl.MBCategoryServiceImpl
036     * @generated
037     */
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 parentCategoryId, java.lang.String name,
064                    java.lang.String description, java.lang.String displayStyle,
065                    java.lang.String emailAddress, java.lang.String inProtocol,
066                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
067                    java.lang.String inUserName, java.lang.String inPassword,
068                    int inReadInterval, java.lang.String outEmailAddress,
069                    boolean outCustom, java.lang.String outServerName, int outServerPort,
070                    boolean outUseSSL, java.lang.String outUserName,
071                    java.lang.String outPassword, boolean mailingListActive,
072                    boolean allowAnonymousEmail,
073                    com.liferay.portal.service.ServiceContext serviceContext)
074                    throws com.liferay.portal.kernel.exception.PortalException,
075                            com.liferay.portal.kernel.exception.SystemException;
076    
077            public void deleteCategory(long groupId, long categoryId)
078                    throws com.liferay.portal.kernel.exception.PortalException,
079                            com.liferay.portal.kernel.exception.SystemException;
080    
081            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
082            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
083                    long groupId)
084                    throws com.liferay.portal.kernel.exception.SystemException;
085    
086            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
087            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
088                    long groupId, long parentCategoryId, int start, int end)
089                    throws com.liferay.portal.kernel.exception.SystemException;
090    
091            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
092            public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
093                    long groupId, long[] parentCategoryIds, int start, int end)
094                    throws com.liferay.portal.kernel.exception.SystemException;
095    
096            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
097            public int getCategoriesCount(long groupId, long parentCategoryId)
098                    throws com.liferay.portal.kernel.exception.SystemException;
099    
100            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
101            public int getCategoriesCount(long groupId, long[] parentCategoryIds)
102                    throws com.liferay.portal.kernel.exception.SystemException;
103    
104            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
105            public com.liferay.portlet.messageboards.model.MBCategory getCategory(
106                    long categoryId)
107                    throws com.liferay.portal.kernel.exception.PortalException,
108                            com.liferay.portal.kernel.exception.SystemException;
109    
110            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
111            public long[] getCategoryIds(long groupId, long categoryId)
112                    throws com.liferay.portal.kernel.exception.SystemException;
113    
114            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
115            public java.util.List<java.lang.Long> getSubcategoryIds(
116                    java.util.List<java.lang.Long> categoryIds, long groupId,
117                    long categoryId)
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> getSubscribedCategories(
122                    long groupId, long userId, int start, int end)
123                    throws com.liferay.portal.kernel.exception.SystemException;
124    
125            @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
126            public int getSubscribedCategoriesCount(long groupId, long userId)
127                    throws com.liferay.portal.kernel.exception.SystemException;
128    
129            public void subscribeCategory(long groupId, long categoryId)
130                    throws com.liferay.portal.kernel.exception.PortalException,
131                            com.liferay.portal.kernel.exception.SystemException;
132    
133            public void unsubscribeCategory(long groupId, long categoryId)
134                    throws com.liferay.portal.kernel.exception.PortalException,
135                            com.liferay.portal.kernel.exception.SystemException;
136    
137            public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
138                    long categoryId, long parentCategoryId, java.lang.String name,
139                    java.lang.String description, java.lang.String displayStyle,
140                    java.lang.String emailAddress, java.lang.String inProtocol,
141                    java.lang.String inServerName, int inServerPort, boolean inUseSSL,
142                    java.lang.String inUserName, java.lang.String inPassword,
143                    int inReadInterval, java.lang.String outEmailAddress,
144                    boolean outCustom, java.lang.String outServerName, int outServerPort,
145                    boolean outUseSSL, java.lang.String outUserName,
146                    java.lang.String outPassword, boolean mailingListActive,
147                    boolean allowAnonymousEmail, boolean mergeWithParentCategory,
148                    com.liferay.portal.service.ServiceContext serviceContext)
149                    throws com.liferay.portal.kernel.exception.PortalException,
150                            com.liferay.portal.kernel.exception.SystemException;
151    }