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.RegionServiceUtil;
020    
021    import java.rmi.RemoteException;
022    
023    /**
024     * Provides the SOAP utility for the
025     * {@link com.liferay.portal.service.RegionServiceUtil} service utility. The
026     * static methods of this class calls the same methods of the service utility.
027     * However, the signatures are different because it is difficult for SOAP to
028     * support certain types.
029     *
030     * <p>
031     * ServiceBuilder follows certain rules in translating the methods. For example,
032     * if the method in the service utility returns a {@link java.util.List}, that
033     * is translated to an array of {@link com.liferay.portal.model.RegionSoap}.
034     * If the method in the service utility returns a
035     * {@link com.liferay.portal.model.Region}, that is translated to a
036     * {@link com.liferay.portal.model.RegionSoap}. Methods that SOAP cannot
037     * safely wire are skipped.
038     * </p>
039     *
040     * <p>
041     * The benefits of using the SOAP utility is that it is cross platform
042     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
043     * even Perl, to call the generated services. One drawback of SOAP is that it is
044     * slow because it needs to serialize all calls into a text format (XML).
045     * </p>
046     *
047     * <p>
048     * You can see a list of services at http://localhost:8080/api/axis. Set the
049     * property <b>axis.servlet.hosts.allowed</b> in portal.properties to configure
050     * security.
051     * </p>
052     *
053     * <p>
054     * The SOAP utility is only generated for remote services.
055     * </p>
056     *
057     * @author Brian Wing Shun Chan
058     * @see RegionServiceHttp
059     * @see com.liferay.portal.model.RegionSoap
060     * @see com.liferay.portal.service.RegionServiceUtil
061     * @generated
062     */
063    public class RegionServiceSoap {
064            public static com.liferay.portal.model.RegionSoap addRegion(
065                    long countryId, java.lang.String regionCode, java.lang.String name,
066                    boolean active) throws RemoteException {
067                    try {
068                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.addRegion(countryId,
069                                            regionCode, name, active);
070    
071                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
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.RegionSoap fetchRegion(
081                    long countryId, java.lang.String regionCode) throws RemoteException {
082                    try {
083                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.fetchRegion(countryId,
084                                            regionCode);
085    
086                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
087                    }
088                    catch (Exception e) {
089                            _log.error(e, e);
090    
091                            throw new RemoteException(e.getMessage());
092                    }
093            }
094    
095            public static com.liferay.portal.model.RegionSoap getRegion(long regionId)
096                    throws RemoteException {
097                    try {
098                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(regionId);
099    
100                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
101                    }
102                    catch (Exception e) {
103                            _log.error(e, e);
104    
105                            throw new RemoteException(e.getMessage());
106                    }
107            }
108    
109            public static com.liferay.portal.model.RegionSoap getRegion(
110                    long countryId, java.lang.String regionCode) throws RemoteException {
111                    try {
112                            com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(countryId,
113                                            regionCode);
114    
115                            return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
116                    }
117                    catch (Exception e) {
118                            _log.error(e, e);
119    
120                            throw new RemoteException(e.getMessage());
121                    }
122            }
123    
124            public static com.liferay.portal.model.RegionSoap[] getRegions()
125                    throws RemoteException {
126                    try {
127                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions();
128    
129                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
130                    }
131                    catch (Exception e) {
132                            _log.error(e, e);
133    
134                            throw new RemoteException(e.getMessage());
135                    }
136            }
137    
138            public static com.liferay.portal.model.RegionSoap[] getRegions(
139                    boolean active) throws RemoteException {
140                    try {
141                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(active);
142    
143                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
144                    }
145                    catch (Exception e) {
146                            _log.error(e, e);
147    
148                            throw new RemoteException(e.getMessage());
149                    }
150            }
151    
152            public static com.liferay.portal.model.RegionSoap[] getRegions(
153                    long countryId) throws RemoteException {
154                    try {
155                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId);
156    
157                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
158                    }
159                    catch (Exception e) {
160                            _log.error(e, e);
161    
162                            throw new RemoteException(e.getMessage());
163                    }
164            }
165    
166            public static com.liferay.portal.model.RegionSoap[] getRegions(
167                    long countryId, boolean active) throws RemoteException {
168                    try {
169                            java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId,
170                                            active);
171    
172                            return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
173                    }
174                    catch (Exception e) {
175                            _log.error(e, e);
176    
177                            throw new RemoteException(e.getMessage());
178                    }
179            }
180    
181            private static Log _log = LogFactoryUtil.getLog(RegionServiceSoap.class);
182    }