001    /**
002     * Copyright (c) 2000-2010 Liferay, Inc. All rights reserved.
003     *
004     * The contents of this file are subject to the terms of the Liferay Enterprise
005     * Subscription License ("License"). You may not use this file except in
006     * compliance with the License. You can obtain a copy of the License by
007     * contacting Liferay, Inc. See the License for the specific language governing
008     * permissions and limitations under the License, including but not limited to
009     * distribution rights of the Software.
010     *
011     *
012     *
013     */
014    
015    package com.liferay.portlet.shopping.service.http;
016    
017    import com.liferay.portal.kernel.log.Log;
018    import com.liferay.portal.kernel.log.LogFactoryUtil;
019    
020    import com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil;
021    
022    import java.rmi.RemoteException;
023    
024    /**
025     * <p>
026     * This class provides a SOAP utility for the
027     * {@link com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil} 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     * </p>
032     *
033     * <p>
034     * ServiceBuilder follows certain rules in translating the methods. For example,
035     * if the method in the service utility returns a {@link java.util.List}, that
036     * is translated to an array of {@link com.liferay.portlet.shopping.model.ShoppingCategorySoap}.
037     * If the method in the service utility returns a
038     * {@link com.liferay.portlet.shopping.model.ShoppingCategory}, that is translated to a
039     * {@link com.liferay.portlet.shopping.model.ShoppingCategorySoap}. Methods that SOAP cannot
040     * safely wire are skipped.
041     * </p>
042     *
043     * <p>
044     * The benefits of using the SOAP utility is that it is cross platform
045     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
046     * even Perl, to call the generated services. One drawback of SOAP is that it is
047     * slow because it needs to serialize all calls into a text format (XML).
048     * </p>
049     *
050     * <p>
051     * You can see a list of services at
052     * http://localhost:8080/tunnel-web/secure/axis. Set the property
053     * <b>tunnel.servlet.hosts.allowed</b> in portal.properties to configure
054     * security.
055     * </p>
056     *
057     * <p>
058     * The SOAP utility is only generated for remote services.
059     * </p>
060     *
061     * @author    Brian Wing Shun Chan
062     * @see       ShoppingCategoryServiceHttp
063     * @see       com.liferay.portlet.shopping.model.ShoppingCategorySoap
064     * @see       com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil
065     * @generated
066     */
067    public class ShoppingCategoryServiceSoap {
068            public static com.liferay.portlet.shopping.model.ShoppingCategorySoap addCategory(
069                    long parentCategoryId, java.lang.String name,
070                    java.lang.String description,
071                    com.liferay.portal.service.ServiceContext serviceContext)
072                    throws RemoteException {
073                    try {
074                            com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.addCategory(parentCategoryId,
075                                            name, description, serviceContext);
076    
077                            return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
078                    }
079                    catch (Exception e) {
080                            _log.error(e, e);
081    
082                            throw new RemoteException(e.getMessage());
083                    }
084            }
085    
086            public static void deleteCategory(long categoryId)
087                    throws RemoteException {
088                    try {
089                            ShoppingCategoryServiceUtil.deleteCategory(categoryId);
090                    }
091                    catch (Exception e) {
092                            _log.error(e, e);
093    
094                            throw new RemoteException(e.getMessage());
095                    }
096            }
097    
098            public static com.liferay.portlet.shopping.model.ShoppingCategorySoap getCategory(
099                    long categoryId) throws RemoteException {
100                    try {
101                            com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.getCategory(categoryId);
102    
103                            return com.liferay.portlet.shopping.model.ShoppingCategorySoap.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.portlet.shopping.model.ShoppingCategorySoap updateCategory(
113                    long categoryId, long parentCategoryId, java.lang.String name,
114                    java.lang.String description, boolean mergeWithParentCategory,
115                    com.liferay.portal.service.ServiceContext serviceContext)
116                    throws RemoteException {
117                    try {
118                            com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.updateCategory(categoryId,
119                                            parentCategoryId, name, description,
120                                            mergeWithParentCategory, serviceContext);
121    
122                            return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
123                    }
124                    catch (Exception e) {
125                            _log.error(e, e);
126    
127                            throw new RemoteException(e.getMessage());
128                    }
129            }
130    
131            private static Log _log = LogFactoryUtil.getLog(ShoppingCategoryServiceSoap.class);
132    }