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.bookmarks.service.http;
016    
017    import com.liferay.portal.kernel.log.Log;
018    import com.liferay.portal.kernel.log.LogFactoryUtil;
019    import com.liferay.portal.kernel.util.ListUtil;
020    
021    import com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil;
022    
023    import java.rmi.RemoteException;
024    
025    /**
026     * <p>
027     * This class provides a SOAP utility for the
028     * {@link com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil} service utility. The
029     * static methods of this class calls the same methods of the service utility.
030     * However, the signatures are different because it is difficult for SOAP to
031     * support certain types.
032     * </p>
033     *
034     * <p>
035     * ServiceBuilder follows certain rules in translating the methods. For example,
036     * if the method in the service utility returns a {@link java.util.List}, that
037     * is translated to an array of {@link com.liferay.portlet.bookmarks.model.BookmarksFolderSoap}.
038     * If the method in the service utility returns a
039     * {@link com.liferay.portlet.bookmarks.model.BookmarksFolder}, that is translated to a
040     * {@link com.liferay.portlet.bookmarks.model.BookmarksFolderSoap}. Methods that SOAP cannot
041     * safely wire are skipped.
042     * </p>
043     *
044     * <p>
045     * The benefits of using the SOAP utility is that it is cross platform
046     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
047     * even Perl, to call the generated services. One drawback of SOAP is that it is
048     * slow because it needs to serialize all calls into a text format (XML).
049     * </p>
050     *
051     * <p>
052     * You can see a list of services at http://localhost:8080/api/axis. Set the
053     * property <b>axis.servlet.hosts.allowed</b> in portal.properties to configure
054     * security.
055     * </p>
056     *
057     * <p>
058     * The SOAP utility is only generated for remote services.
059     * </p>
060     *
061     * @author    Brian Wing Shun Chan
062     * @see       BookmarksFolderServiceHttp
063     * @see       com.liferay.portlet.bookmarks.model.BookmarksFolderSoap
064     * @see       com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil
065     * @generated
066     */
067    public class BookmarksFolderServiceSoap {
068            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap addFolder(
069                    long parentFolderId, java.lang.String name,
070                    java.lang.String description,
071                    com.liferay.portal.service.ServiceContext serviceContext)
072                    throws RemoteException {
073                    try {
074                            com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.addFolder(parentFolderId,
075                                            name, description, serviceContext);
076    
077                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
078                    }
079                    catch (Exception e) {
080                            _log.error(e, e);
081    
082                            throw new RemoteException(e.getMessage());
083                    }
084            }
085    
086            public static void deleteFolder(long folderId) throws RemoteException {
087                    try {
088                            BookmarksFolderServiceUtil.deleteFolder(folderId);
089                    }
090                    catch (Exception e) {
091                            _log.error(e, e);
092    
093                            throw new RemoteException(e.getMessage());
094                    }
095            }
096    
097            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap getFolder(
098                    long folderId) throws RemoteException {
099                    try {
100                            com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.getFolder(folderId);
101    
102                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
103                    }
104                    catch (Exception e) {
105                            _log.error(e, e);
106    
107                            throw new RemoteException(e.getMessage());
108                    }
109            }
110    
111            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap[] getFolders(
112                    long groupId) throws RemoteException {
113                    try {
114                            java.util.List<com.liferay.portlet.bookmarks.model.BookmarksFolder> returnValue =
115                                    BookmarksFolderServiceUtil.getFolders(groupId);
116    
117                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModels(returnValue);
118                    }
119                    catch (Exception e) {
120                            _log.error(e, e);
121    
122                            throw new RemoteException(e.getMessage());
123                    }
124            }
125    
126            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap[] getFolders(
127                    long groupId, long parentFolderId) throws RemoteException {
128                    try {
129                            java.util.List<com.liferay.portlet.bookmarks.model.BookmarksFolder> returnValue =
130                                    BookmarksFolderServiceUtil.getFolders(groupId, parentFolderId);
131    
132                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModels(returnValue);
133                    }
134                    catch (Exception e) {
135                            _log.error(e, e);
136    
137                            throw new RemoteException(e.getMessage());
138                    }
139            }
140    
141            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap[] getFolders(
142                    long groupId, long parentFolderId, int start, int end)
143                    throws RemoteException {
144                    try {
145                            java.util.List<com.liferay.portlet.bookmarks.model.BookmarksFolder> returnValue =
146                                    BookmarksFolderServiceUtil.getFolders(groupId, parentFolderId,
147                                            start, end);
148    
149                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModels(returnValue);
150                    }
151                    catch (Exception e) {
152                            _log.error(e, e);
153    
154                            throw new RemoteException(e.getMessage());
155                    }
156            }
157    
158            public static int getFoldersCount(long groupId, long parentFolderId)
159                    throws RemoteException {
160                    try {
161                            int returnValue = BookmarksFolderServiceUtil.getFoldersCount(groupId,
162                                            parentFolderId);
163    
164                            return returnValue;
165                    }
166                    catch (Exception e) {
167                            _log.error(e, e);
168    
169                            throw new RemoteException(e.getMessage());
170                    }
171            }
172    
173            public static void getSubfolderIds(Long[] folderIds, long groupId,
174                    long folderId) throws RemoteException {
175                    try {
176                            BookmarksFolderServiceUtil.getSubfolderIds(ListUtil.toList(
177                                            folderIds), groupId, folderId);
178                    }
179                    catch (Exception e) {
180                            _log.error(e, e);
181    
182                            throw new RemoteException(e.getMessage());
183                    }
184            }
185    
186            public static void subscribeFolder(long groupId, long folderId)
187                    throws RemoteException {
188                    try {
189                            BookmarksFolderServiceUtil.subscribeFolder(groupId, folderId);
190                    }
191                    catch (Exception e) {
192                            _log.error(e, e);
193    
194                            throw new RemoteException(e.getMessage());
195                    }
196            }
197    
198            public static void unsubscribeFolder(long groupId, long folderId)
199                    throws RemoteException {
200                    try {
201                            BookmarksFolderServiceUtil.unsubscribeFolder(groupId, folderId);
202                    }
203                    catch (Exception e) {
204                            _log.error(e, e);
205    
206                            throw new RemoteException(e.getMessage());
207                    }
208            }
209    
210            public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap updateFolder(
211                    long folderId, long parentFolderId, java.lang.String name,
212                    java.lang.String description, boolean mergeWithParentFolder,
213                    com.liferay.portal.service.ServiceContext serviceContext)
214                    throws RemoteException {
215                    try {
216                            com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.updateFolder(folderId,
217                                            parentFolderId, name, description, mergeWithParentFolder,
218                                            serviceContext);
219    
220                            return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
221                    }
222                    catch (Exception e) {
223                            _log.error(e, e);
224    
225                            throw new RemoteException(e.getMessage());
226                    }
227            }
228    
229            private static Log _log = LogFactoryUtil.getLog(BookmarksFolderServiceSoap.class);
230    }