1   /**
2    * Copyright (c) 2000-2009 Liferay, Inc. All rights reserved.
3    *
4    * The contents of this file are subject to the terms of the Liferay Enterprise
5    * Subscription License ("License"). You may not use this file except in
6    * compliance with the License. You can obtain a copy of the License by
7    * contacting Liferay, Inc. See the License for the specific language governing
8    * permissions and limitations under the License, including but not limited to
9    * distribution rights of the Software.
10   *
11   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
12   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
14   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
15   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
16   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
17   * SOFTWARE.
18   */
19  
20  package com.liferay.portal.service.http;
21  
22  import com.liferay.portal.kernel.log.Log;
23  import com.liferay.portal.kernel.log.LogFactoryUtil;
24  import com.liferay.portal.service.RegionServiceUtil;
25  
26  import java.rmi.RemoteException;
27  
28  /**
29   * <a href="RegionServiceSoap.java.html"><b><i>View Source</i></b></a>
30   *
31   * <p>
32   * ServiceBuilder generated this class. Modifications in this class will be
33   * overwritten the next time is generated.
34   * </p>
35   *
36   * <p>
37   * This class provides a SOAP utility for the
38   * <code>com.liferay.portal.service.RegionServiceUtil</code> service
39   * utility. The static methods of this class calls the same methods of the
40   * service utility. However, the signatures are different because it is
41   * difficult for SOAP to support certain types.
42   * </p>
43   *
44   * <p>
45   * ServiceBuilder follows certain rules in translating the methods. For example,
46   * if the method in the service utility returns a <code>java.util.List</code>,
47   * that is translated to an array of
48   * <code>com.liferay.portal.model.RegionSoap</code>. If the method in the
49   * service utility returns a <code>com.liferay.portal.model.Region</code>,
50   * that is translated to a <code>com.liferay.portal.model.RegionSoap</code>.
51   * Methods that SOAP cannot safely wire are skipped.
52   * </p>
53   *
54   * <p>
55   * The benefits of using the SOAP utility is that it is cross platform
56   * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
57   * even Perl, to call the generated services. One drawback of SOAP is that it is
58   * slow because it needs to serialize all calls into a text format (XML).
59   * </p>
60   *
61   * <p>
62   * You can see a list of services at
63   * http://localhost:8080/tunnel-web/secure/axis. Set the property
64   * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure
65   * security.
66   * </p>
67   *
68   * <p>
69   * The SOAP utility is only generated for remote services.
70   * </p>
71   *
72   * @author Brian Wing Shun Chan
73   *
74   * @see com.liferay.portal.model.RegionSoap
75   * @see com.liferay.portal.service.RegionServiceUtil
76   * @see com.liferay.portal.service.http.RegionServiceHttp
77   *
78   */
79  public class RegionServiceSoap {
80      public static com.liferay.portal.model.RegionSoap addRegion(
81          long countryId, java.lang.String regionCode, java.lang.String name,
82          boolean active) throws RemoteException {
83          try {
84              com.liferay.portal.model.Region returnValue = RegionServiceUtil.addRegion(countryId,
85                      regionCode, name, active);
86  
87              return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
88          }
89          catch (Exception e) {
90              _log.error(e, e);
91  
92              throw new RemoteException(e.getMessage());
93          }
94      }
95  
96      public static com.liferay.portal.model.RegionSoap[] getRegions()
97          throws RemoteException {
98          try {
99              java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions();
100 
101             return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
102         }
103         catch (Exception e) {
104             _log.error(e, e);
105 
106             throw new RemoteException(e.getMessage());
107         }
108     }
109 
110     public static com.liferay.portal.model.RegionSoap[] getRegions(
111         long countryId) throws RemoteException {
112         try {
113             java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId);
114 
115             return com.liferay.portal.model.RegionSoap.toSoapModels(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         boolean active) throws RemoteException {
126         try {
127             java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(active);
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         long countryId, boolean active) throws RemoteException {
140         try {
141             java.util.List<com.liferay.portal.model.Region> returnValue = RegionServiceUtil.getRegions(countryId,
142                     active);
143 
144             return com.liferay.portal.model.RegionSoap.toSoapModels(returnValue);
145         }
146         catch (Exception e) {
147             _log.error(e, e);
148 
149             throw new RemoteException(e.getMessage());
150         }
151     }
152 
153     public static com.liferay.portal.model.RegionSoap getRegion(long regionId)
154         throws RemoteException {
155         try {
156             com.liferay.portal.model.Region returnValue = RegionServiceUtil.getRegion(regionId);
157 
158             return com.liferay.portal.model.RegionSoap.toSoapModel(returnValue);
159         }
160         catch (Exception e) {
161             _log.error(e, e);
162 
163             throw new RemoteException(e.getMessage());
164         }
165     }
166 
167     private static Log _log = LogFactoryUtil.getLog(RegionServiceSoap.class);
168 }