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.portlet.shopping.service.http;
21  
22  import com.liferay.portal.kernel.log.Log;
23  import com.liferay.portal.kernel.log.LogFactoryUtil;
24  
25  import com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil;
26  
27  import java.rmi.RemoteException;
28  
29  /**
30   * <a href="ShoppingCategoryServiceSoap.java.html"><b><i>View Source</i></b></a>
31   *
32   * <p>
33   * ServiceBuilder generated this class. Modifications in this class will be
34   * overwritten the next time is generated.
35   * </p>
36   *
37   * <p>
38   * This class provides a SOAP utility for the
39   * <code>com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil</code> service
40   * utility. The static methods of this class calls the same methods of the
41   * service utility. However, the signatures are different because it is
42   * difficult for SOAP to support certain types.
43   * </p>
44   *
45   * <p>
46   * ServiceBuilder follows certain rules in translating the methods. For example,
47   * if the method in the service utility returns a <code>java.util.List</code>,
48   * that is translated to an array of
49   * <code>com.liferay.portlet.shopping.model.ShoppingCategorySoap</code>. If the method in the
50   * service utility returns a <code>com.liferay.portlet.shopping.model.ShoppingCategory</code>,
51   * that is translated to a <code>com.liferay.portlet.shopping.model.ShoppingCategorySoap</code>.
52   * Methods 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
57   * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
58   * even Perl, to call the generated services. One drawback of SOAP is that it is
59   * slow because 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
64   * http://localhost:8080/tunnel-web/secure/axis. Set the property
65   * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure
66   * security.
67   * </p>
68   *
69   * <p>
70   * The SOAP utility is only generated for remote services.
71   * </p>
72   *
73   * @author Brian Wing Shun Chan
74   *
75   * @see com.liferay.portlet.shopping.model.ShoppingCategorySoap
76   * @see com.liferay.portlet.shopping.service.ShoppingCategoryServiceUtil
77   * @see com.liferay.portlet.shopping.service.http.ShoppingCategoryServiceHttp
78   *
79   */
80  public class ShoppingCategoryServiceSoap {
81      public static com.liferay.portlet.shopping.model.ShoppingCategorySoap addCategory(
82          long plid, long parentCategoryId, java.lang.String name,
83          java.lang.String description, boolean addCommunityPermissions,
84          boolean addGuestPermissions) throws RemoteException {
85          try {
86              com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.addCategory(plid,
87                      parentCategoryId, name, description,
88                      addCommunityPermissions, addGuestPermissions);
89  
90              return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
91          }
92          catch (Exception e) {
93              _log.error(e, e);
94  
95              throw new RemoteException(e.getMessage());
96          }
97      }
98  
99      public static com.liferay.portlet.shopping.model.ShoppingCategorySoap addCategory(
100         long plid, long parentCategoryId, java.lang.String name,
101         java.lang.String description, java.lang.String[] communityPermissions,
102         java.lang.String[] guestPermissions) throws RemoteException {
103         try {
104             com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.addCategory(plid,
105                     parentCategoryId, name, description, communityPermissions,
106                     guestPermissions);
107 
108             return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
109         }
110         catch (Exception e) {
111             _log.error(e, e);
112 
113             throw new RemoteException(e.getMessage());
114         }
115     }
116 
117     public static void deleteCategory(long categoryId)
118         throws RemoteException {
119         try {
120             ShoppingCategoryServiceUtil.deleteCategory(categoryId);
121         }
122         catch (Exception e) {
123             _log.error(e, e);
124 
125             throw new RemoteException(e.getMessage());
126         }
127     }
128 
129     public static com.liferay.portlet.shopping.model.ShoppingCategorySoap getCategory(
130         long categoryId) throws RemoteException {
131         try {
132             com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.getCategory(categoryId);
133 
134             return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
135         }
136         catch (Exception e) {
137             _log.error(e, e);
138 
139             throw new RemoteException(e.getMessage());
140         }
141     }
142 
143     public static com.liferay.portlet.shopping.model.ShoppingCategorySoap updateCategory(
144         long categoryId, long parentCategoryId, java.lang.String name,
145         java.lang.String description, boolean mergeWithParentCategory)
146         throws RemoteException {
147         try {
148             com.liferay.portlet.shopping.model.ShoppingCategory returnValue = ShoppingCategoryServiceUtil.updateCategory(categoryId,
149                     parentCategoryId, name, description, mergeWithParentCategory);
150 
151             return com.liferay.portlet.shopping.model.ShoppingCategorySoap.toSoapModel(returnValue);
152         }
153         catch (Exception e) {
154             _log.error(e, e);
155 
156             throw new RemoteException(e.getMessage());
157         }
158     }
159 
160     private static Log _log = LogFactoryUtil.getLog(ShoppingCategoryServiceSoap.class);
161 }