001 /** 002 * Copyright (c) 2000-2013 Liferay, Inc. All rights reserved. 003 * 004 * This library is free software; you can redistribute it and/or modify it under 005 * the terms of the GNU Lesser General Public License as published by the Free 006 * Software Foundation; either version 2.1 of the License, or (at your option) 007 * any later version. 008 * 009 * This library is distributed in the hope that it will be useful, but WITHOUT 010 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 011 * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more 012 * details. 013 */ 014 015 package com.liferay.portal.service.http; 016 017 import com.liferay.portal.kernel.log.Log; 018 import com.liferay.portal.kernel.log.LogFactoryUtil; 019 import com.liferay.portal.service.PortletServiceUtil; 020 021 import java.rmi.RemoteException; 022 023 /** 024 * <p> 025 * This class provides a SOAP utility for the 026 * {@link com.liferay.portal.service.PortletServiceUtil} service utility. The 027 * static methods of this class calls the same methods of the service utility. 028 * However, the signatures are different because it is difficult for SOAP to 029 * support certain types. 030 * </p> 031 * 032 * <p> 033 * ServiceBuilder follows certain rules in translating the methods. For example, 034 * if the method in the service utility returns a {@link java.util.List}, that 035 * is translated to an array of {@link com.liferay.portal.model.PortletSoap}. 036 * If the method in the service utility returns a 037 * {@link com.liferay.portal.model.Portlet}, that is translated to a 038 * {@link com.liferay.portal.model.PortletSoap}. Methods that SOAP cannot 039 * safely wire are skipped. 040 * </p> 041 * 042 * <p> 043 * The benefits of using the SOAP utility is that it is cross platform 044 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and 045 * even Perl, to call the generated services. One drawback of SOAP is that it is 046 * slow because it needs to serialize all calls into a text format (XML). 047 * </p> 048 * 049 * <p> 050 * You can see a list of services at 051 * http://localhost:8080/api/secure/axis. Set the property 052 * <b>axis.servlet.hosts.allowed</b> in portal.properties to configure 053 * security. 054 * </p> 055 * 056 * <p> 057 * The SOAP utility is only generated for remote services. 058 * </p> 059 * 060 * @author Brian Wing Shun Chan 061 * @see PortletServiceHttp 062 * @see com.liferay.portal.model.PortletSoap 063 * @see com.liferay.portal.service.PortletServiceUtil 064 * @generated 065 */ 066 public class PortletServiceSoap { 067 public static java.lang.String getWARPortlets() throws RemoteException { 068 try { 069 com.liferay.portal.kernel.json.JSONArray returnValue = PortletServiceUtil.getWARPortlets(); 070 071 return returnValue.toString(); 072 } 073 catch (Exception e) { 074 _log.error(e, e); 075 076 throw new RemoteException(e.getMessage()); 077 } 078 } 079 080 public static com.liferay.portal.model.PortletSoap updatePortlet( 081 long companyId, java.lang.String portletId, java.lang.String roles, 082 boolean active) throws RemoteException { 083 try { 084 com.liferay.portal.model.Portlet returnValue = PortletServiceUtil.updatePortlet(companyId, 085 portletId, roles, active); 086 087 return com.liferay.portal.model.PortletSoap.toSoapModel(returnValue); 088 } 089 catch (Exception e) { 090 _log.error(e, e); 091 092 throw new RemoteException(e.getMessage()); 093 } 094 } 095 096 private static Log _log = LogFactoryUtil.getLog(PortletServiceSoap.class); 097 }