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  }