1   /**
2    * Copyright (c) 2000-2007 Liferay, Inc. All rights reserved.
3    *
4    * Permission is hereby granted, free of charge, to any person obtaining a copy
5    * of this software and associated documentation files (the "Software"), to deal
6    * in the Software without restriction, including without limitation the rights
7    * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8    * copies of the Software, and to permit persons to whom the Software is
9    * furnished to do so, subject to the following conditions:
10   *
11   * The above copyright notice and this permission notice shall be included in
12   * all copies or substantial portions of the Software.
13   *
14   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15   * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17   * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19   * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20   * SOFTWARE.
21   */
22  
23  package com.liferay.portal.service.http;
24  
25  import com.liferay.portal.kernel.log.Log;
26  import com.liferay.portal.kernel.log.LogFactoryUtil;
27  import com.liferay.portal.service.AddressServiceUtil;
28  
29  import java.rmi.RemoteException;
30  
31  /**
32   * <a href="AddressServiceSoap.java.html"><b><i>View Source</i></b></a>
33   *
34   * <p>
35   * ServiceBuilder generated this class. Modifications in this class will be overwritten
36   * the next time is generated.
37   * </p>
38   *
39   * <p>
40   * This class provides a SOAP utility for the <code>com.liferay.portal.service.AddressServiceUtil</code>
41   * service utility. The static methods of this class calls the same methods of the
42   * service utility. However, the signatures are different because it is difficult
43   * for SOAP to support certain types.
44   * </p>
45   *
46   * <p>
47   * ServiceBuilder follows certain rules in translating the methods. For example,
48   * if the method in the service utility returns a <code>java.util.List</code>, that
49   * is translated to an array of <code>com.liferay.portal.model.AddressSoap</code>.
50   * If the method in the service utility returns a <code>com.liferay.portal.model.Address</code>,
51   * that is translated to a <code>com.liferay.portal.model.AddressSoap</code>. Methods
52   * that SOAP cannot safely wire are skipped.
53   * </p>
54   *
55   * <p>
56   * The benefits of using the SOAP utility is that it is cross platform compatible.
57   * SOAP allows different languages like Java, .NET, C++, PHP, and even Perl, to
58   * call the generated services. One drawback of SOAP is that it is slow because
59   * it needs to serialize all calls into a text format (XML).
60   * </p>
61   *
62   * <p>
63   * You can see a list of services at http://localhost:8080/tunnel-web/secure/axis.
64   * Set the property <code>tunnel.servlet.hosts.allowed</code> in portal.properties
65   * to configure 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.service.AddressServiceUtil
75   * @see com.liferay.portal.service.http.AddressServiceHttp
76   * @see com.liferay.portal.service.model.AddressSoap
77   *
78   */
79  public class AddressServiceSoap {
80      public static com.liferay.portal.model.AddressSoap addAddress(
81          java.lang.String className, long classPK, java.lang.String street1,
82          java.lang.String street2, java.lang.String street3,
83          java.lang.String city, java.lang.String zip, long regionId,
84          long countryId, int typeId, boolean mailing, boolean primary)
85          throws RemoteException {
86          try {
87              com.liferay.portal.model.Address returnValue = AddressServiceUtil.addAddress(className,
88                      classPK, street1, street2, street3, city, zip, regionId,
89                      countryId, typeId, mailing, primary);
90  
91              return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
92          }
93          catch (Exception e) {
94              _log.error(e, e);
95              throw new RemoteException(e.getMessage());
96          }
97      }
98  
99      public static void deleteAddress(long addressId) throws RemoteException {
100         try {
101             AddressServiceUtil.deleteAddress(addressId);
102         }
103         catch (Exception e) {
104             _log.error(e, e);
105             throw new RemoteException(e.getMessage());
106         }
107     }
108 
109     public static com.liferay.portal.model.AddressSoap getAddress(
110         long addressId) throws RemoteException {
111         try {
112             com.liferay.portal.model.Address returnValue = AddressServiceUtil.getAddress(addressId);
113 
114             return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
115         }
116         catch (Exception e) {
117             _log.error(e, e);
118             throw new RemoteException(e.getMessage());
119         }
120     }
121 
122     public static com.liferay.portal.model.AddressSoap[] getAddresses(
123         java.lang.String className, long classPK) throws RemoteException {
124         try {
125             java.util.List returnValue = AddressServiceUtil.getAddresses(className,
126                     classPK);
127 
128             return com.liferay.portal.model.AddressSoap.toSoapModels(returnValue);
129         }
130         catch (Exception e) {
131             _log.error(e, e);
132             throw new RemoteException(e.getMessage());
133         }
134     }
135 
136     public static com.liferay.portal.model.AddressSoap updateAddress(
137         long addressId, java.lang.String street1, java.lang.String street2,
138         java.lang.String street3, java.lang.String city, java.lang.String zip,
139         long regionId, long countryId, int typeId, boolean mailing,
140         boolean primary) throws RemoteException {
141         try {
142             com.liferay.portal.model.Address returnValue = AddressServiceUtil.updateAddress(addressId,
143                     street1, street2, street3, city, zip, regionId, countryId,
144                     typeId, mailing, primary);
145 
146             return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
147         }
148         catch (Exception e) {
149             _log.error(e, e);
150             throw new RemoteException(e.getMessage());
151         }
152     }
153 
154     private static Log _log = LogFactoryUtil.getLog(AddressServiceSoap.class);
155 }