001    /**
002     * Copyright (c) 2000-2010 Liferay, Inc. All rights reserved.
003     *
004     * The contents of this file are subject to the terms of the Liferay Enterprise
005     * Subscription License ("License"). You may not use this file except in
006     * compliance with the License. You can obtain a copy of the License by
007     * contacting Liferay, Inc. See the License for the specific language governing
008     * permissions and limitations under the License, including but not limited to
009     * distribution rights of the Software.
010     *
011     *
012     *
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.RegionServiceUtil;
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.RegionServiceUtil} 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.RegionSoap}.
036     * If the method in the service utility returns a
037     * {@link com.liferay.portal.model.Region}, that is translated to a
038     * {@link com.liferay.portal.model.RegionSoap}. 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       RegionServiceHttp
062     * @see       com.liferay.portal.model.RegionSoap
063     * @see       com.liferay.portal.service.RegionServiceUtil
064     * @generated
065     */
066    public class RegionServiceSoap {
067            public static com.liferay.portal.model.RegionSoap addRegion(
068                    long countryId, java.lang.String regionCode, java.lang.String name,
069                    boolean active) throws RemoteException {
070                    try {
071                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.addRegion(countryId,
072                                            regionCode, name, active);
073    
074                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
075                    }
076                    catch (Exception e) {
077                            _log.error(e, e);
078    
079                            throw new RemoteException(e.getMessage());
080                    }
081            }
082    
083            public static com.liferay.portal.model.RegionSoap[] getRegions()
084                    throws RemoteException {
085                    try {
086                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions();
087    
088                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
089                    }
090                    catch (Exception e) {
091                            _log.error(e, e);
092    
093                            throw new RemoteException(e.getMessage());
094                    }
095            }
096    
097            public static com.liferay.portal.model.RegionSoap[] getRegions(
098                    long countryId) throws RemoteException {
099                    try {
100                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId);
101    
102                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
103                    }
104                    catch (Exception e) {
105                            _log.error(e, e);
106    
107                            throw new RemoteException(e.getMessage());
108                    }
109            }
110    
111            public static com.liferay.portal.model.RegionSoap[] getRegions(
112                    boolean active) throws RemoteException {
113                    try {
114                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(active);
115    
116                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
117                    }
118                    catch (Exception e) {
119                            _log.error(e, e);
120    
121                            throw new RemoteException(e.getMessage());
122                    }
123            }
124    
125            public static com.liferay.portal.model.RegionSoap[] getRegions(
126                    long countryId, boolean active) throws RemoteException {
127                    try {
128                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId,
129                                            active);
130    
131                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
132                    }
133                    catch (Exception e) {
134                            _log.error(e, e);
135    
136                            throw new RemoteException(e.getMessage());
137                    }
138            }
139    
140            public static com.liferay.portal.model.RegionSoap getRegion(long regionId)
141                    throws RemoteException {
142                    try {
143                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(regionId);
144    
145                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
146                    }
147                    catch (Exception e) {
148                            _log.error(e, e);
149    
150                            throw new RemoteException(e.getMessage());
151                    }
152            }
153    
154            private static Log _log = LogFactoryUtil.getLog(RegionServiceSoap.class);
155    }