ShoppingItemServiceSoap.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.shopping.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.shopping.service.ShoppingItemServiceUtil; 29 30 import java.rmi.RemoteException; 31 32 /** 33 * <a href="ShoppingItemServiceSoap.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.shopping.service.ShoppingItemServiceUtil</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.shopping.model.ShoppingItemSoap</code>. If the method in the 53 * service utility returns a <code>com.liferay.portlet.shopping.model.ShoppingItem</code>, 54 * that is translated to a <code>com.liferay.portlet.shopping.model.ShoppingItemSoap</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.shopping.model.ShoppingItemSoap 79 * @see com.liferay.portlet.shopping.service.ShoppingItemServiceUtil 80 * @see com.liferay.portlet.shopping.service.http.ShoppingItemServiceHttp 81 * 82 */ 83 public class ShoppingItemServiceSoap { 84 public static void addBookItems(long categoryId, java.lang.String[] isbns) 85 throws RemoteException { 86 try { 87 ShoppingItemServiceUtil.addBookItems(categoryId, isbns); 88 } 89 catch (Exception e) { 90 _log.error(e, e); 91 92 throw new RemoteException(e.getMessage()); 93 } 94 } 95 96 public static void deleteItem(long itemId) throws RemoteException { 97 try { 98 ShoppingItemServiceUtil.deleteItem(itemId); 99 } 100 catch (Exception e) { 101 _log.error(e, e); 102 103 throw new RemoteException(e.getMessage()); 104 } 105 } 106 107 public static com.liferay.portlet.shopping.model.ShoppingItemSoap getItem( 108 long itemId) throws RemoteException { 109 try { 110 com.liferay.portlet.shopping.model.ShoppingItem returnValue = ShoppingItemServiceUtil.getItem(itemId); 111 112 return com.liferay.portlet.shopping.model.ShoppingItemSoap.toSoapModel(returnValue); 113 } 114 catch (Exception e) { 115 _log.error(e, e); 116 117 throw new RemoteException(e.getMessage()); 118 } 119 } 120 121 private static Log _log = LogFactoryUtil.getLog(ShoppingItemServiceSoap.class); 122 }