| BookmarksFolderServiceSoap.java |
1 /**
2 * Copyright (c) 2000-2009 Liferay, Inc. All rights reserved.
3 *
4 * The contents of this file are subject to the terms of the Liferay Enterprise
5 * Subscription License ("License"). You may not use this file except in
6 * compliance with the License. You can obtain a copy of the License by
7 * contacting Liferay, Inc. See the License for the specific language governing
8 * permissions and limitations under the License, including but not limited to
9 * distribution rights of the Software.
10 *
11 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
12 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
14 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
15 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
17 * SOFTWARE.
18 */
19
20 package com.liferay.portlet.bookmarks.service.http;
21
22 import com.liferay.portal.kernel.log.Log;
23 import com.liferay.portal.kernel.log.LogFactoryUtil;
24
25 import com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil;
26
27 import java.rmi.RemoteException;
28
29 /**
30 * <a href="BookmarksFolderServiceSoap.java.html"><b><i>View Source</i></b></a>
31 *
32 * <p>
33 * ServiceBuilder generated this class. Modifications in this class will be
34 * overwritten the next time is generated.
35 * </p>
36 *
37 * <p>
38 * This class provides a SOAP utility for the
39 * <code>com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil</code> service
40 * utility. The static methods of this class calls the same methods of the
41 * service utility. However, the signatures are different because it is
42 * difficult for SOAP to support certain types.
43 * </p>
44 *
45 * <p>
46 * ServiceBuilder follows certain rules in translating the methods. For example,
47 * if the method in the service utility returns a <code>java.util.List</code>,
48 * that is translated to an array of
49 * <code>com.liferay.portlet.bookmarks.model.BookmarksFolderSoap</code>. If the method in the
50 * service utility returns a <code>com.liferay.portlet.bookmarks.model.BookmarksFolder</code>,
51 * that is translated to a <code>com.liferay.portlet.bookmarks.model.BookmarksFolderSoap</code>.
52 * Methods that SOAP cannot safely wire are skipped.
53 * </p>
54 *
55 * <p>
56 * The benefits of using the SOAP utility is that it is cross platform
57 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
58 * even Perl, to call the generated services. One drawback of SOAP is that it is
59 * slow because it needs to serialize all calls into a text format (XML).
60 * </p>
61 *
62 * <p>
63 * You can see a list of services at
64 * http://localhost:8080/tunnel-web/secure/axis. Set the property
65 * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure
66 * security.
67 * </p>
68 *
69 * <p>
70 * The SOAP utility is only generated for remote services.
71 * </p>
72 *
73 * @author Brian Wing Shun Chan
74 *
75 * @see com.liferay.portlet.bookmarks.model.BookmarksFolderSoap
76 * @see com.liferay.portlet.bookmarks.service.BookmarksFolderServiceUtil
77 * @see com.liferay.portlet.bookmarks.service.http.BookmarksFolderServiceHttp
78 *
79 */
80 public class BookmarksFolderServiceSoap {
81 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap addFolder(
82 long parentFolderId, java.lang.String name,
83 java.lang.String description,
84 com.liferay.portal.service.ServiceContext serviceContext)
85 throws RemoteException {
86 try {
87 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.addFolder(parentFolderId,
88 name, description, serviceContext);
89
90 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
91 }
92 catch (Exception e) {
93 _log.error(e, e);
94
95 throw new RemoteException(e.getMessage());
96 }
97 }
98
99 public static void deleteFolder(long folderId) throws RemoteException {
100 try {
101 BookmarksFolderServiceUtil.deleteFolder(folderId);
102 }
103 catch (Exception e) {
104 _log.error(e, e);
105
106 throw new RemoteException(e.getMessage());
107 }
108 }
109
110 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap getFolder(
111 long folderId) throws RemoteException {
112 try {
113 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.getFolder(folderId);
114
115 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
116 }
117 catch (Exception e) {
118 _log.error(e, e);
119
120 throw new RemoteException(e.getMessage());
121 }
122 }
123
124 public static com.liferay.portlet.bookmarks.model.BookmarksFolderSoap updateFolder(
125 long folderId, long parentFolderId, java.lang.String name,
126 java.lang.String description, boolean mergeWithParentFolder,
127 com.liferay.portal.service.ServiceContext serviceContext)
128 throws RemoteException {
129 try {
130 com.liferay.portlet.bookmarks.model.BookmarksFolder returnValue = BookmarksFolderServiceUtil.updateFolder(folderId,
131 parentFolderId, name, description, mergeWithParentFolder,
132 serviceContext);
133
134 return com.liferay.portlet.bookmarks.model.BookmarksFolderSoap.toSoapModel(returnValue);
135 }
136 catch (Exception e) {
137 _log.error(e, e);
138
139 throw new RemoteException(e.getMessage());
140 }
141 }
142
143 private static Log _log = LogFactoryUtil.getLog(BookmarksFolderServiceSoap.class);
144 }