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.AddressServiceUtil;
022    
023    import java.rmi.RemoteException;
024    
025    /**
026     * Provides the SOAP utility for the
027     * {@link AddressServiceUtil} 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.AddressSoap}.
036     * If the method in the service utility returns a
037     * {@link com.liferay.portal.model.Address}, that is translated to a
038     * {@link com.liferay.portal.model.AddressSoap}. 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 AddressServiceHttp
061     * @see com.liferay.portal.model.AddressSoap
062     * @see AddressServiceUtil
063     * @generated
064     */
065    @ProviderType
066    public class AddressServiceSoap {
067            public static com.liferay.portal.model.AddressSoap addAddress(
068                    java.lang.String className, long classPK, java.lang.String street1,
069                    java.lang.String street2, java.lang.String street3,
070                    java.lang.String city, java.lang.String zip, long regionId,
071                    long countryId, long typeId, boolean mailing, boolean primary,
072                    com.liferay.portal.service.ServiceContext serviceContext)
073                    throws RemoteException {
074                    try {
075                            com.liferay.portal.model.Address returnValue = AddressServiceUtil.addAddress(className,
076                                            classPK, street1, street2, street3, city, zip, regionId,
077                                            countryId, typeId, mailing, primary, serviceContext);
078    
079                            return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
080                    }
081                    catch (Exception e) {
082                            _log.error(e, e);
083    
084                            throw new RemoteException(e.getMessage());
085                    }
086            }
087    
088            public static void deleteAddress(long addressId) throws RemoteException {
089                    try {
090                            AddressServiceUtil.deleteAddress(addressId);
091                    }
092                    catch (Exception e) {
093                            _log.error(e, e);
094    
095                            throw new RemoteException(e.getMessage());
096                    }
097            }
098    
099            public static com.liferay.portal.model.AddressSoap getAddress(
100                    long addressId) throws RemoteException {
101                    try {
102                            com.liferay.portal.model.Address returnValue = AddressServiceUtil.getAddress(addressId);
103    
104                            return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
105                    }
106                    catch (Exception e) {
107                            _log.error(e, e);
108    
109                            throw new RemoteException(e.getMessage());
110                    }
111            }
112    
113            public static com.liferay.portal.model.AddressSoap[] getAddresses(
114                    java.lang.String className, long classPK) throws RemoteException {
115                    try {
116                            java.util.List<com.liferay.portal.model.Address> returnValue = AddressServiceUtil.getAddresses(className,
117                                            classPK);
118    
119                            return com.liferay.portal.model.AddressSoap.toSoapModels(returnValue);
120                    }
121                    catch (Exception e) {
122                            _log.error(e, e);
123    
124                            throw new RemoteException(e.getMessage());
125                    }
126            }
127    
128            public static com.liferay.portal.model.AddressSoap updateAddress(
129                    long addressId, java.lang.String street1, java.lang.String street2,
130                    java.lang.String street3, java.lang.String city, java.lang.String zip,
131                    long regionId, long countryId, long typeId, boolean mailing,
132                    boolean primary) throws RemoteException {
133                    try {
134                            com.liferay.portal.model.Address returnValue = AddressServiceUtil.updateAddress(addressId,
135                                            street1, street2, street3, city, zip, regionId, countryId,
136                                            typeId, mailing, primary);
137    
138                            return com.liferay.portal.model.AddressSoap.toSoapModel(returnValue);
139                    }
140                    catch (Exception e) {
141                            _log.error(e, e);
142    
143                            throw new RemoteException(e.getMessage());
144                    }
145            }
146    
147            private static Log _log = LogFactoryUtil.getLog(AddressServiceSoap.class);
148    }