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.bookmarks.service;
24  
25  import com.liferay.portal.PortalException;
26  import com.liferay.portal.SystemException;
27  import com.liferay.portal.kernel.annotation.Propagation;
28  import com.liferay.portal.kernel.annotation.Transactional;
29  
30  /**
31   * <a href="BookmarksFolderLocalService.java.html"><b><i>View Source</i></b></a>
32   *
33   * <p>
34   * ServiceBuilder generated this class. Modifications in this class will be
35   * overwritten the next time is generated.
36   * </p>
37   *
38   * <p>
39   * This interface defines the service. The default implementation is
40   * <code>com.liferay.portlet.bookmarks.service.impl.BookmarksFolderLocalServiceImpl</code>.
41   * Modify methods in that class and rerun ServiceBuilder to populate this class
42   * and all other generated classes.
43   * </p>
44   *
45   * <p>
46   * 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.
47   * </p>
48   *
49   * @author Brian Wing Shun Chan
50   *
51   * @see com.liferay.portlet.bookmarks.service.BookmarksFolderLocalServiceUtil
52   *
53   */
54  @Transactional(rollbackFor =  {
55      PortalException.class, SystemException.class})
56  public interface BookmarksFolderLocalService {
57      public com.liferay.portlet.bookmarks.model.BookmarksFolder addBookmarksFolder(
58          com.liferay.portlet.bookmarks.model.BookmarksFolder bookmarksFolder)
59          throws com.liferay.portal.SystemException;
60  
61      public com.liferay.portlet.bookmarks.model.BookmarksFolder createBookmarksFolder(
62          long folderId);
63  
64      public void deleteBookmarksFolder(long folderId)
65          throws com.liferay.portal.SystemException,
66              com.liferay.portal.PortalException;
67  
68      public void deleteBookmarksFolder(
69          com.liferay.portlet.bookmarks.model.BookmarksFolder bookmarksFolder)
70          throws com.liferay.portal.SystemException;
71  
72      public java.util.List<Object> dynamicQuery(
73          com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery)
74          throws com.liferay.portal.SystemException;
75  
76      public java.util.List<Object> dynamicQuery(
77          com.liferay.portal.kernel.dao.orm.DynamicQuery dynamicQuery, int start,
78          int end) throws com.liferay.portal.SystemException;
79  
80      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
81      public com.liferay.portlet.bookmarks.model.BookmarksFolder getBookmarksFolder(
82          long folderId)
83          throws com.liferay.portal.SystemException,
84              com.liferay.portal.PortalException;
85  
86      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
87      public java.util.List<com.liferay.portlet.bookmarks.model.BookmarksFolder> getBookmarksFolders(
88          int start, int end) throws com.liferay.portal.SystemException;
89  
90      @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
91      public int getBookmarksFoldersCount()
92          throws com.liferay.portal.SystemException;
93  
94      public com.liferay.portlet.bookmarks.model.BookmarksFolder updateBookmarksFolder(
95          com.liferay.portlet.bookmarks.model.BookmarksFolder bookmarksFolder)
96          throws com.liferay.portal.SystemException;
97  
98      public com.liferay.portlet.bookmarks.model.BookmarksFolder addFolder(
99          long userId, long parentFolderId, java.lang.String name,
100         java.lang.String description,
101         com.liferay.portal.service.ServiceContext serviceContext)
102         throws com.liferay.portal.PortalException,
103             com.liferay.portal.SystemException;
104 
105     public com.liferay.portlet.bookmarks.model.BookmarksFolder addFolder(
106         java.lang.String uuid, long userId, long parentFolderId,
107         java.lang.String name, java.lang.String description,
108         com.liferay.portal.service.ServiceContext serviceContext)
109         throws com.liferay.portal.PortalException,
110             com.liferay.portal.SystemException;
111 
112     public void addFolderResources(long folderId,
113         boolean addCommunityPermissions, boolean addGuestPermissions)
114         throws com.liferay.portal.PortalException,
115             com.liferay.portal.SystemException;
116 
117     public void addFolderResources(
118         com.liferay.portlet.bookmarks.model.BookmarksFolder folder,
119         boolean addCommunityPermissions, boolean addGuestPermissions)
120         throws com.liferay.portal.PortalException,
121             com.liferay.portal.SystemException;
122 
123     public void addFolderResources(long folderId,
124         java.lang.String[] communityPermissions,
125         java.lang.String[] guestPermissions)
126         throws com.liferay.portal.PortalException,
127             com.liferay.portal.SystemException;
128 
129     public void addFolderResources(
130         com.liferay.portlet.bookmarks.model.BookmarksFolder folder,
131         java.lang.String[] communityPermissions,
132         java.lang.String[] guestPermissions)
133         throws com.liferay.portal.PortalException,
134             com.liferay.portal.SystemException;
135 
136     public void deleteFolder(long folderId)
137         throws com.liferay.portal.PortalException,
138             com.liferay.portal.SystemException;
139 
140     public void deleteFolder(
141         com.liferay.portlet.bookmarks.model.BookmarksFolder folder)
142         throws com.liferay.portal.PortalException,
143             com.liferay.portal.SystemException;
144 
145     public void deleteFolders(long groupId)
146         throws com.liferay.portal.PortalException,
147             com.liferay.portal.SystemException;
148 
149     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
150     public com.liferay.portlet.bookmarks.model.BookmarksFolder getFolder(
151         long folderId)
152         throws com.liferay.portal.PortalException,
153             com.liferay.portal.SystemException;
154 
155     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
156     public java.util.List<com.liferay.portlet.bookmarks.model.BookmarksFolder> getFolders(
157         long groupId, long parentFolderId, int start, int end)
158         throws com.liferay.portal.SystemException;
159 
160     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
161     public int getFoldersCount(long groupId, long parentFolderId)
162         throws com.liferay.portal.SystemException;
163 
164     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
165     public void getSubfolderIds(java.util.List<Long> folderIds, long groupId,
166         long folderId) throws com.liferay.portal.SystemException;
167 
168     public void reIndex(java.lang.String[] ids)
169         throws com.liferay.portal.SystemException;
170 
171     @Transactional(propagation = Propagation.SUPPORTS, readOnly = true)
172     public com.liferay.portal.kernel.search.Hits search(long companyId,
173         long groupId, long userId, long[] folderIds, java.lang.String keywords,
174         int start, int end) throws com.liferay.portal.SystemException;
175 
176     public com.liferay.portlet.bookmarks.model.BookmarksFolder updateFolder(
177         long folderId, long parentFolderId, java.lang.String name,
178         java.lang.String description, boolean mergeWithParentFolder)
179         throws com.liferay.portal.PortalException,
180             com.liferay.portal.SystemException;
181 }