001    /**
002     * Copyright (c) 2000-present 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 aQute.bnd.annotation.ProviderType;
018    
019    import com.liferay.portal.kernel.log.Log;
020    import com.liferay.portal.kernel.log.LogFactoryUtil;
021    import com.liferay.portal.service.RegionServiceUtil;
022    
023    import java.rmi.RemoteException;
024    
025    /**
026     * Provides the SOAP utility for the
027     * {@link RegionServiceUtil} service utility. The
028     * static methods of this class calls the same methods of the service utility.
029     * However, the signatures are different because it is difficult for SOAP to
030     * support certain types.
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 http://localhost:8080/api/axis. Set the
051     * property <b>axis.servlet.hosts.allowed</b> in portal.properties to configure
052     * security.
053     * </p>
054     *
055     * <p>
056     * The SOAP utility is only generated for remote services.
057     * </p>
058     *
059     * @author Brian Wing Shun Chan
060     * @see RegionServiceHttp
061     * @see com.liferay.portal.model.RegionSoap
062     * @see RegionServiceUtil
063     * @generated
064     */
065    @ProviderType
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 fetchRegion(long regionId)
084                    throws RemoteException {
085                    try {
086                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.fetchRegion(regionId);
087    
088                            return com.liferay.portal.model.RegionSoap.toSoapModel(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 fetchRegion(
098                    long countryId, java.lang.String regionCode) throws RemoteException {
099                    try {
100                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.fetchRegion(countryId,
101                                            regionCode);
102    
103                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
104                    }
105                    catch (Exception e) {
106                            _log.error(e, e);
107    
108                            throw new RemoteException(e.getMessage());
109                    }
110            }
111    
112            public static com.liferay.portal.model.RegionSoap getRegion(long regionId)
113                    throws RemoteException {
114                    try {
115                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(regionId);
116    
117                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
118                    }
119                    catch (Exception e) {
120                            _log.error(e, e);
121    
122                            throw new RemoteException(e.getMessage());
123                    }
124            }
125    
126            public static com.liferay.portal.model.RegionSoap getRegion(
127                    long countryId, java.lang.String regionCode) throws RemoteException {
128                    try {
129                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(countryId,
130                                            regionCode);
131    
132                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
133                    }
134                    catch (Exception e) {
135                            _log.error(e, e);
136    
137                            throw new RemoteException(e.getMessage());
138                    }
139            }
140    
141            public static com.liferay.portal.model.RegionSoap[] getRegions()
142                    throws RemoteException {
143                    try {
144                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions();
145    
146                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
147                    }
148                    catch (Exception e) {
149                            _log.error(e, e);
150    
151                            throw new RemoteException(e.getMessage());
152                    }
153            }
154    
155            public static com.liferay.portal.model.RegionSoap[] getRegions(
156                    boolean active) throws RemoteException {
157                    try {
158                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(active);
159    
160                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
161                    }
162                    catch (Exception e) {
163                            _log.error(e, e);
164    
165                            throw new RemoteException(e.getMessage());
166                    }
167            }
168    
169            public static com.liferay.portal.model.RegionSoap[] getRegions(
170                    long countryId) throws RemoteException {
171                    try {
172                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId);
173    
174                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
175                    }
176                    catch (Exception e) {
177                            _log.error(e, e);
178    
179                            throw new RemoteException(e.getMessage());
180                    }
181            }
182    
183            public static com.liferay.portal.model.RegionSoap[] getRegions(
184                    long countryId, boolean active) throws RemoteException {
185                    try {
186                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId,
187                                            active);
188    
189                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
190                    }
191                    catch (Exception e) {
192                            _log.error(e, e);
193    
194                            throw new RemoteException(e.getMessage());
195                    }
196            }
197    
198            private static Log _log = LogFactoryUtil.getLog(RegionServiceSoap.class);
199    }