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 }