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.BookmarksEntryServiceUtil;
26  
27  import java.rmi.RemoteException;
28  
29  /**
30   * <a href="BookmarksEntryServiceSoap.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.BookmarksEntryServiceUtil</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.BookmarksEntrySoap</code>. If the method in the
50   * service utility returns a <code>com.liferay.portlet.bookmarks.model.BookmarksEntry</code>,
51   * that is translated to a <code>com.liferay.portlet.bookmarks.model.BookmarksEntrySoap</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.BookmarksEntrySoap
76   * @see com.liferay.portlet.bookmarks.service.BookmarksEntryServiceUtil
77   * @see com.liferay.portlet.bookmarks.service.http.BookmarksEntryServiceHttp
78   *
79   */
80  public class BookmarksEntryServiceSoap {
81      public static com.liferay.portlet.bookmarks.model.BookmarksEntrySoap addEntry(
82          long folderId, java.lang.String name, java.lang.String url,
83          java.lang.String comments, java.lang.String[] tagsEntries,
84          boolean addCommunityPermissions, boolean addGuestPermissions)
85          throws RemoteException {
86          try {
87              com.liferay.portlet.bookmarks.model.BookmarksEntry returnValue = BookmarksEntryServiceUtil.addEntry(folderId,
88                      name, url, comments, tagsEntries, addCommunityPermissions,
89                      addGuestPermissions);
90  
91              return com.liferay.portlet.bookmarks.model.BookmarksEntrySoap.toSoapModel(returnValue);
92          }
93          catch (Exception e) {
94              _log.error(e, e);
95  
96              throw new RemoteException(e.getMessage());
97          }
98      }
99  
100     public static com.liferay.portlet.bookmarks.model.BookmarksEntrySoap addEntry(
101         long folderId, java.lang.String name, java.lang.String url,
102         java.lang.String comments, java.lang.String[] tagsEntries,
103         java.lang.String[] communityPermissions,
104         java.lang.String[] guestPermissions) throws RemoteException {
105         try {
106             com.liferay.portlet.bookmarks.model.BookmarksEntry returnValue = BookmarksEntryServiceUtil.addEntry(folderId,
107                     name, url, comments, tagsEntries, communityPermissions,
108                     guestPermissions);
109 
110             return com.liferay.portlet.bookmarks.model.BookmarksEntrySoap.toSoapModel(returnValue);
111         }
112         catch (Exception e) {
113             _log.error(e, e);
114 
115             throw new RemoteException(e.getMessage());
116         }
117     }
118 
119     public static void deleteEntry(long entryId) throws RemoteException {
120         try {
121             BookmarksEntryServiceUtil.deleteEntry(entryId);
122         }
123         catch (Exception e) {
124             _log.error(e, e);
125 
126             throw new RemoteException(e.getMessage());
127         }
128     }
129 
130     public static com.liferay.portlet.bookmarks.model.BookmarksEntrySoap getEntry(
131         long entryId) throws RemoteException {
132         try {
133             com.liferay.portlet.bookmarks.model.BookmarksEntry returnValue = BookmarksEntryServiceUtil.getEntry(entryId);
134 
135             return com.liferay.portlet.bookmarks.model.BookmarksEntrySoap.toSoapModel(returnValue);
136         }
137         catch (Exception e) {
138             _log.error(e, e);
139 
140             throw new RemoteException(e.getMessage());
141         }
142     }
143 
144     public static com.liferay.portlet.bookmarks.model.BookmarksEntrySoap openEntry(
145         long entryId) throws RemoteException {
146         try {
147             com.liferay.portlet.bookmarks.model.BookmarksEntry returnValue = BookmarksEntryServiceUtil.openEntry(entryId);
148 
149             return com.liferay.portlet.bookmarks.model.BookmarksEntrySoap.toSoapModel(returnValue);
150         }
151         catch (Exception e) {
152             _log.error(e, e);
153 
154             throw new RemoteException(e.getMessage());
155         }
156     }
157 
158     public static com.liferay.portlet.bookmarks.model.BookmarksEntrySoap updateEntry(
159         long entryId, long folderId, java.lang.String name,
160         java.lang.String url, java.lang.String comments,
161         java.lang.String[] tagsEntries) throws RemoteException {
162         try {
163             com.liferay.portlet.bookmarks.model.BookmarksEntry returnValue = BookmarksEntryServiceUtil.updateEntry(entryId,
164                     folderId, name, url, comments, tagsEntries);
165 
166             return com.liferay.portlet.bookmarks.model.BookmarksEntrySoap.toSoapModel(returnValue);
167         }
168         catch (Exception e) {
169             _log.error(e, e);
170 
171             throw new RemoteException(e.getMessage());
172         }
173     }
174 
175     private static Log _log = LogFactoryUtil.getLog(BookmarksEntryServiceSoap.class);
176 }