| BookmarksFolderServiceSoap.java |
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.http;
24
25 import com.liferay.portal.kernel.log.Log;
26 import com.liferay.portal.kernel.log.LogFactoryUtil;
27
28 import com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil;
29
30 import java.rmi.RemoteException;
31
32 /**
33 * <a href="BookmarksFolderServiceSoap.java.html"><b><i>View Source</i></b></a>
34 *
35 * <p>
36 * ServiceBuilder generated this class. Modifications in this class will be
37 * overwritten the next time is generated.
38 * </p>
39 *
40 * <p>
41 * This class provides a SOAP utility for the
42 * <code>com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil</code> service
43 * utility. The static methods of this class calls the same methods of the
44 * service utility. However, the signatures are different because it is
45 * difficult for SOAP to support certain types.
46 * </p>
47 *
48 * <p>
49 * ServiceBuilder follows certain rules in translating the methods. For example,
50 * if the method in the service utility returns a <code>java.util.List</code>,
51 * that is translated to an array of
52 * <code>com.liferay.portlet.bookmarks.model.BookmarksFolderSoap</code>. If the method in the
53 * service utility returns a <code>com.liferay.portlet.bookmarks.model.BookmarksFolder</code>,
54 * that is translated to a <code>com.liferay.portlet.bookmarks.model.BookmarksFolderSoap</code>.
55 * Methods that SOAP cannot safely wire are skipped.
56 * </p>
57 *
58 * <p>
59 * The benefits of using the SOAP utility is that it is cross platform
60 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
61 * even Perl, to call the generated services. One drawback of SOAP is that it is
62 * slow because it needs to serialize all calls into a text format (XML).
63 * </p>
64 *
65 * <p>
66 * You can see a list of services at
67 * http://localhost:8080/tunnel-web/secure/axis. Set the property
68 * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure
69 * security.
70 * </p>
71 *
72 * <p>
73 * The SOAP utility is only generated for remote services.
74 * </p>
75 *
76 * @author Brian Wing Shun Chan
77 *
78 * @see com.liferay.portlet.bookmarks.model.BookmarksFolderSoap
79 * @see com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil
80 * @see com.liferay.portlet.bookmarks.service.http.BookmarksFolderServiceHttp
81 *
82 */
83 public class BookmarksFolderServiceSoap {
84 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap addFolder(
85 long parentFolderId, java.lang.String name,
86 java.lang.String description,
87 com.liferay.portal.service.ServiceContext serviceContext)
88 throws RemoteException {
89 try {
90 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.addFolder(parentFolderId,
91 name, description, serviceContext);
92
93 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
94 }
95 catch (Exception e) {
96 _log.error(e, e);
97
98 throw new RemoteException(e.getMessage());
99 }
100 }
101
102 public static void deleteFolder(long folderId) throws RemoteException {
103 try {
104 BookmarksFolderServiceUtil.deleteFolder(folderId);
105 }
106 catch (Exception e) {
107 _log.error(e, e);
108
109 throw new RemoteException(e.getMessage());
110 }
111 }
112
113 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap getFolder(
114 long folderId) throws RemoteException {
115 try {
116 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.getFolder(folderId);
117
118 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
119 }
120 catch (Exception e) {
121 _log.error(e, e);
122
123 throw new RemoteException(e.getMessage());
124 }
125 }
126
127 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap updateFolder(
128 long folderId, long parentFolderId, java.lang.String name,
129 java.lang.String description, boolean mergeWithParentFolder)
130 throws RemoteException {
131 try {
132 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.updateFolder(folderId,
133 parentFolderId, name, description, mergeWithParentFolder);
134
135 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
136 }
137 catch (Exception e) {
138 _log.error(e, e);
139
140 throw new RemoteException(e.getMessage());
141 }
142 }
143
144 private static Log _log = LogFactoryUtil.getLog(BookmarksFolderServiceSoap.class);
145 }