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 }