PortalServiceHttp.java |
1 /** 2 * Copyright (c) 2000-2007 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.kernel.util.MethodWrapper; 28 import com.liferay.portal.security.auth.HttpPrincipal; 29 import com.liferay.portal.service.PortalServiceUtil; 30 import com.liferay.portal.service.http.TunnelUtil; 31 32 /** 33 * <a href="PortalServiceHttp.java.html"><b><i>View Source</i></b></a> 34 * 35 * <p> 36 * ServiceBuilder generated this class. Modifications in this class will be overwritten 37 * the next time is generated. 38 * </p> 39 * 40 * <p> 41 * This class provides a HTTP utility for the <code>com.liferay.portal.service.PortalServiceUtil</code> 42 * service utility. The static methods of this class calls the same methods of the 43 * service utility. However, the signatures are different because it requires an 44 * additional <code>com.liferay.portal.security.auth.HttpPrincipal</code> parameter. 45 * </p> 46 * 47 * <p> 48 * The benefits of using the HTTP utility is that it is fast and allows for tunneling 49 * without the cost of serializing to text. The drawback is that it only works with 50 * Java. 51 * </p> 52 * 53 * <p> 54 * Set the property <code>tunnel.servlet.hosts.allowed</code> in portal.properties 55 * to configure security. 56 * </p> 57 * 58 * <p> 59 * The HTTP utility is only generated for remote services. 60 * </p> 61 * 62 * @author Brian Wing Shun Chan 63 * 64 * @see com.liferay.portal.security.auth.HttpPrincipal 65 * @see com.liferay.portal.service.PortalServiceUtil 66 * @see com.liferay.portal.service.http.PortalServiceSoap 67 * 68 */ 69 public class PortalServiceHttp { 70 public static void test(HttpPrincipal httpPrincipal) 71 throws com.liferay.portal.SystemException { 72 try { 73 MethodWrapper methodWrapper = new MethodWrapper(PortalServiceUtil.class.getName(), 74 "test", new Object[0]); 75 76 try { 77 TunnelUtil.invoke(httpPrincipal, methodWrapper); 78 } 79 catch (Exception e) { 80 if (e instanceof com.liferay.portal.SystemException) { 81 throw (com.liferay.portal.SystemException)e; 82 } 83 84 throw new com.liferay.portal.SystemException(e); 85 } 86 } 87 catch (com.liferay.portal.SystemException se) { 88 _log.error(se, se); 89 throw se; 90 } 91 } 92 93 private static Log _log = LogFactoryUtil.getLog(PortalServiceHttp.class); 94 }