PortalServiceSoap.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.portal.service.http; 24 25 import com.liferay.portal.kernel.log.Log; 26 import com.liferay.portal.kernel.log.LogFactoryUtil; 27 import com.liferay.portal.service.PortalServiceUtil; 28 29 import java.rmi.RemoteException; 30 31 /** 32 * <a href="PortalServiceSoap.java.html"><b><i>View Source</i></b></a> 33 * 34 * <p> 35 * ServiceBuilder generated this class. Modifications in this class will be 36 * overwritten the next time is generated. 37 * </p> 38 * 39 * <p> 40 * This class provides a SOAP utility for the 41 * <code>com.liferay.portal.service.PortalServiceUtil</code> service 42 * utility. The static methods of this class calls the same methods of the 43 * service utility. However, the signatures are different because it is 44 * difficult for SOAP to support certain types. 45 * </p> 46 * 47 * <p> 48 * ServiceBuilder follows certain rules in translating the methods. For example, 49 * if the method in the service utility returns a <code>java.util.List</code>, 50 * that is translated to an array of 51 * <code>com.liferay.portal.model.PortalSoap</code>. If the method in the 52 * service utility returns a <code>com.liferay.portal.model.Portal</code>, 53 * that is translated to a <code>com.liferay.portal.model.PortalSoap</code>. 54 * Methods that SOAP cannot safely wire are skipped. 55 * </p> 56 * 57 * <p> 58 * The benefits of using the SOAP utility is that it is cross platform 59 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and 60 * even Perl, to call the generated services. One drawback of SOAP is that it is 61 * slow because it needs to serialize all calls into a text format (XML). 62 * </p> 63 * 64 * <p> 65 * You can see a list of services at 66 * http://localhost:8080/tunnel-web/secure/axis. Set the property 67 * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure 68 * security. 69 * </p> 70 * 71 * <p> 72 * The SOAP utility is only generated for remote services. 73 * </p> 74 * 75 * @author Brian Wing Shun Chan 76 * 77 * @see com.liferay.portal.model.PortalSoap 78 * @see com.liferay.portal.service.PortalServiceUtil 79 * @see com.liferay.portal.service.http.PortalServiceHttp 80 * 81 */ 82 public class PortalServiceSoap { 83 public static void test() throws RemoteException { 84 try { 85 PortalServiceUtil.test(); 86 } 87 catch (Exception e) { 88 _log.error(e, e); 89 90 throw new RemoteException(e.getMessage()); 91 } 92 } 93 94 public static void testCounterRollback() throws RemoteException { 95 try { 96 PortalServiceUtil.testCounterRollback(); 97 } 98 catch (Exception e) { 99 _log.error(e, e); 100 101 throw new RemoteException(e.getMessage()); 102 } 103 } 104 105 private static Log _log = LogFactoryUtil.getLog(PortalServiceSoap.class); 106 }