001    /**
002     * Copyright (c) 2000-2010 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/tunnel-web/secure/axis. Set the property
052     * <b>tunnel.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 com.liferay.portal.kernel.json.JSONArray getWARPortlets()
068                    throws RemoteException {
069                    try {
070                            com.liferay.portal.kernel.json.JSONArray returnValue = PortletServiceUtil.getWARPortlets();
071    
072                            return returnValue;
073                    }
074                    catch (Exception e) {
075                            _log.error(e, e);
076    
077                            throw new RemoteException(e.getMessage());
078                    }
079            }
080    
081            public static com.liferay.portal.model.PortletSoap updatePortlet(
082                    long companyId, java.lang.String portletId, java.lang.String roles,
083                    boolean active) throws RemoteException {
084                    try {
085                            com.liferay.portal.model.Portlet returnValue = PortletServiceUtil.updatePortlet(companyId,
086                                            portletId, roles, active);
087    
088                            return com.liferay.portal.model.PortletSoap.toSoapModel(returnValue);
089                    }
090                    catch (Exception e) {
091                            _log.error(e, e);
092    
093                            throw new RemoteException(e.getMessage());
094                    }
095            }
096    
097            private static Log _log = LogFactoryUtil.getLog(PortletServiceSoap.class);
098    }