1   /**
2    * Copyright (c) 2000-2009 Liferay, Inc. All rights reserved.
3    *
4    * Permission is hereby granted, free of charge, to any person obtaining a copy
5    * of this software and associated documentation files (the "Software"), to deal
6    * in the Software without restriction, including without limitation the rights
7    * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8    * copies of the Software, and to permit persons to whom the Software is
9    * furnished to do so, subject to the following conditions:
10   *
11   * The above copyright notice and this permission notice shall be included in
12   * all copies or substantial portions of the Software.
13   *
14   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20   * SOFTWARE.
21   */
22  
23  package com.liferay.portlet.messageboards.service;
24  
25  import com.liferay.portal.PortalException;
26  import com.liferay.portal.SystemException;
27  import com.liferay.portal.kernel.annotation.Isolation;
28  import com.liferay.portal.kernel.annotation.Propagation;
29  import com.liferay.portal.kernel.annotation.Transactional;
30  
31  /**
32   * <a href="MBCategoryLocalService.java.html"><b><i>View Source</i></b></a>
33   *
34   * <p>
35   * ServiceBuilder generated this class. Modifications in this class will be
36   * overwritten the next time is generated.
37   * </p>
38   *
39   * <p>
40   * This interface defines the service. The default implementation is
41   * <code>com.liferay.portlet.messageboards.service.impl.MBCategoryLocalServiceImpl</code>.
42   * Modify methods in that class and rerun ServiceBuilder to populate this class
43   * and all other generated classes.
44   * </p>
45   *
46   * <p>
47   * This is a local service. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM.
48   * </p>
49   *
50   * @author Brian Wing Shun Chan
51   *
52   * @see com.liferay.portlet.messageboards.service.MBCategoryLocalServiceUtil
53   *
54   */
55  @Transactional(isolation = Isolation.PORTAL, rollbackFor =  {
56      PortalException.class, SystemException.class})
57  public interface MBCategoryLocalService {
58      public com.liferay.portlet.messageboards.model.MBCategory addMBCategory(
59          com.liferay.portlet.messageboards.model.MBCategory mbCategory)
60          throws com.liferay.portal.SystemException;
61  
62      public com.liferay.portlet.messageboards.model.MBCategory createMBCategory(
63          long categoryId);
64  
65      public void deleteMBCategory(long categoryId)
66          throws com.liferay.portal.SystemException,
67              com.liferay.portal.PortalException;
68  
69      public void deleteMBCategory(
70          com.liferay.portlet.messageboards.model.MBCategory mbCategory)
71          throws com.liferay.portal.SystemException;
72  
73      public java.util.List<Object> dynamicQuery(
74          com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
75          throws com.liferay.portal.SystemException;
76  
77      public java.util.List<Object> dynamicQuery(
78          com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
79          int end) throws com.liferay.portal.SystemException;
80  
81      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
82      public com.liferay.portlet.messageboards.model.MBCategory getMBCategory(
83          long categoryId)
84          throws com.liferay.portal.SystemException,
85              com.liferay.portal.PortalException;
86  
87      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
88      public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getMBCategories(
89          int start, int end) throws com.liferay.portal.SystemException;
90  
91      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
92      public int getMBCategoriesCount() throws com.liferay.portal.SystemException;
93  
94      public com.liferay.portlet.messageboards.model.MBCategory updateMBCategory(
95          com.liferay.portlet.messageboards.model.MBCategory mbCategory)
96          throws com.liferay.portal.SystemException;
97  
98      public com.liferay.portlet.messageboards.model.MBCategory updateMBCategory(
99          com.liferay.portlet.messageboards.model.MBCategory mbCategory,
100         boolean merge) throws com.liferay.portal.SystemException;
101 
102     public com.liferay.portlet.messageboards.model.MBCategory addCategory(
103         long userId, long plid, long parentCategoryId, java.lang.String name,
104         java.lang.String description, boolean addCommunityPermissions,
105         boolean addGuestPermissions)
106         throws com.liferay.portal.PortalException,
107             com.liferay.portal.SystemException;
108 
109     public com.liferay.portlet.messageboards.model.MBCategory addCategory(
110         java.lang.String uuid, long userId, long plid, long parentCategoryId,
111         java.lang.String name, java.lang.String description,
112         boolean addCommunityPermissions, boolean addGuestPermissions)
113         throws com.liferay.portal.PortalException,
114             com.liferay.portal.SystemException;
115 
116     public com.liferay.portlet.messageboards.model.MBCategory addCategory(
117         long userId, long plid, long parentCategoryId, java.lang.String name,
118         java.lang.String description, java.lang.String[] communityPermissions,
119         java.lang.String[] guestPermissions)
120         throws com.liferay.portal.PortalException,
121             com.liferay.portal.SystemException;
122 
123     public com.liferay.portlet.messageboards.model.MBCategory addCategory(
124         java.lang.String uuid, long userId, long plid, long parentCategoryId,
125         java.lang.String name, java.lang.String description,
126         java.lang.Boolean addCommunityPermissions,
127         java.lang.Boolean addGuestPermissions,
128         java.lang.String[] communityPermissions,
129         java.lang.String[] guestPermissions)
130         throws com.liferay.portal.PortalException,
131             com.liferay.portal.SystemException;
132 
133     public void addCategoryResources(long categoryId,
134         boolean addCommunityPermissions, boolean addGuestPermissions)
135         throws com.liferay.portal.PortalException,
136             com.liferay.portal.SystemException;
137 
138     public void addCategoryResources(
139         com.liferay.portlet.messageboards.model.MBCategory category,
140         boolean addCommunityPermissions, boolean addGuestPermissions)
141         throws com.liferay.portal.PortalException,
142             com.liferay.portal.SystemException;
143 
144     public void addCategoryResources(long categoryId,
145         java.lang.String[] communityPermissions,
146         java.lang.String[] guestPermissions)
147         throws com.liferay.portal.PortalException,
148             com.liferay.portal.SystemException;
149 
150     public void addCategoryResources(
151         com.liferay.portlet.messageboards.model.MBCategory category,
152         java.lang.String[] communityPermissions,
153         java.lang.String[] guestPermissions)
154         throws com.liferay.portal.PortalException,
155             com.liferay.portal.SystemException;
156 
157     public void deleteCategories(long groupId)
158         throws com.liferay.portal.PortalException,
159             com.liferay.portal.SystemException;
160 
161     public void deleteCategory(long categoryId)
162         throws com.liferay.portal.PortalException,
163             com.liferay.portal.SystemException;
164 
165     public void deleteCategory(
166         com.liferay.portlet.messageboards.model.MBCategory category)
167         throws com.liferay.portal.PortalException,
168             com.liferay.portal.SystemException;
169 
170     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
171     public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
172         long groupId) throws com.liferay.portal.SystemException;
173 
174     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
175     public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
176         long groupId, long parentCategoryId)
177         throws com.liferay.portal.SystemException;
178 
179     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
180     public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getCategories(
181         long groupId, long parentCategoryId, int start, int end)
182         throws com.liferay.portal.SystemException;
183 
184     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
185     public int getCategoriesCount(long groupId)
186         throws com.liferay.portal.SystemException;
187 
188     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
189     public int getCategoriesCount(long groupId, long parentCategoryId)
190         throws com.liferay.portal.SystemException;
191 
192     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
193     public com.liferay.portlet.messageboards.model.MBCategory getCategory(
194         long categoryId)
195         throws com.liferay.portal.PortalException,
196             com.liferay.portal.SystemException;
197 
198     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
199     public void getSubcategoryIds(java.util.List<Long> categoryIds,
200         long groupId, long categoryId)
201         throws com.liferay.portal.SystemException;
202 
203     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
204     public java.util.List<com.liferay.portlet.messageboards.model.MBCategory> getSubscribedCategories(
205         long groupId, long userId, int start, int end)
206         throws com.liferay.portal.SystemException;
207 
208     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
209     public int getSubscribedCategoriesCount(long groupId, long userId)
210         throws com.liferay.portal.SystemException;
211 
212     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
213     public com.liferay.portlet.messageboards.model.MBCategory getSystemCategory()
214         throws com.liferay.portal.SystemException;
215 
216     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
217     public void reIndex(java.lang.String[] ids)
218         throws com.liferay.portal.SystemException;
219 
220     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
221     public com.liferay.portal.kernel.search.Hits search(long companyId,
222         long groupId, long[] categoryIds, long threadId,
223         java.lang.String keywords, int start, int end)
224         throws com.liferay.portal.SystemException;
225 
226     public com.liferay.portlet.messageboards.model.MBCategory updateCategory(
227         long categoryId, long parentCategoryId, java.lang.String name,
228         java.lang.String description, boolean mergeWithParentCategory)
229         throws com.liferay.portal.PortalException,
230             com.liferay.portal.SystemException;
231 
232     public void subscribeCategory(long userId, long categoryId)
233         throws com.liferay.portal.PortalException,
234             com.liferay.portal.SystemException;
235 
236     public void unsubscribeCategory(long userId, long categoryId)
237         throws com.liferay.portal.PortalException,
238             com.liferay.portal.SystemException;
239 }