1   /**
2    * Copyright (c) 2000-2010 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   *
12   * 
13   */
14  
15  package com.liferay.portlet.messageboards.service.http;
16  
17  import com.liferay.portal.kernel.log.Log;
18  import com.liferay.portal.kernel.log.LogFactoryUtil;
19  
20  import com.liferay.portlet.messageboards.service.MBCategoryServiceUtil;
21  
22  import java.rmi.RemoteException;
23  
24  /**
25   * <a href="MBCategoryServiceSoap.java.html"><b><i>View Source</i></b></a>
26   *
27   * <p>
28   * ServiceBuilder generated this class. Modifications in this class will be
29   * overwritten the next time is generated.
30   * </p>
31   *
32   * <p>
33   * This class provides a SOAP utility for the
34   * {@link com.liferay.portlet.messageboards.service.MBCategoryServiceUtil} service utility. The
35   * static methods of this class calls the same methods of the service utility.
36   * However, the signatures are different because it is difficult for SOAP to
37   * support certain types.
38   * </p>
39   *
40   * <p>
41   * ServiceBuilder follows certain rules in translating the methods. For example,
42   * if the method in the service utility returns a {@link java.util.List}, that
43   * is translated to an array of {@link com.liferay.portlet.messageboards.model.MBCategorySoap}.
44   * If the method in the service utility returns a
45   * {@link com.liferay.portlet.messageboards.model.MBCategory}, that is translated to a
46   * {@link com.liferay.portlet.messageboards.model.MBCategorySoap}. Methods that SOAP cannot
47   * safely wire are skipped.
48   * </p>
49   *
50   * <p>
51   * The benefits of using the SOAP utility is that it is cross platform
52   * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
53   * even Perl, to call the generated services. One drawback of SOAP is that it is
54   * slow because it needs to serialize all calls into a text format (XML).
55   * </p>
56   *
57   * <p>
58   * You can see a list of services at
59   * http://localhost:8080/tunnel-web/secure/axis. Set the property
60   * <b>tunnel.servlet.hosts.allowed</b> in portal.properties to configure
61   * security.
62   * </p>
63   *
64   * <p>
65   * The SOAP utility is only generated for remote services.
66   * </p>
67   *
68   * @author    Brian Wing Shun Chan
69   * @see       MBCategoryServiceHttp
70   * @see       com.liferay.portlet.messageboards.model.MBCategorySoap
71   * @see       com.liferay.portlet.messageboards.service.MBCategoryServiceUtil
72   * @generated
73   */
74  public class MBCategoryServiceSoap {
75      public static com.liferay.portlet.messageboards.model.MBCategorySoap addCategory(
76          long plid, long parentCategoryId, java.lang.String name,
77          java.lang.String description, boolean addCommunityPermissions,
78          boolean addGuestPermissions) throws RemoteException {
79          try {
80              com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
81                      parentCategoryId, name, description,
82                      addCommunityPermissions, addGuestPermissions);
83  
84              return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
85          }
86          catch (Exception e) {
87              _log.error(e, e);
88  
89              throw new RemoteException(e.getMessage());
90          }
91      }
92  
93      public static com.liferay.portlet.messageboards.model.MBCategorySoap addCategory(
94          long plid, long parentCategoryId, java.lang.String name,
95          java.lang.String description, java.lang.String[] communityPermissions,
96          java.lang.String[] guestPermissions) throws RemoteException {
97          try {
98              com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
99                      parentCategoryId, name, description, communityPermissions,
100                     guestPermissions);
101 
102             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
103         }
104         catch (Exception e) {
105             _log.error(e, e);
106 
107             throw new RemoteException(e.getMessage());
108         }
109     }
110 
111     public static void deleteCategory(long categoryId)
112         throws RemoteException {
113         try {
114             MBCategoryServiceUtil.deleteCategory(categoryId);
115         }
116         catch (Exception e) {
117             _log.error(e, e);
118 
119             throw new RemoteException(e.getMessage());
120         }
121     }
122 
123     public static com.liferay.portlet.messageboards.model.MBCategorySoap[] getCategories(
124         long groupId, long parentCategoryId, int start, int end)
125         throws RemoteException {
126         try {
127             java.util.List<com.liferay.portlet.messageboards.model.MBCategory> returnValue =
128                 MBCategoryServiceUtil.getCategories(groupId, parentCategoryId,
129                     start, end);
130 
131             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModels(returnValue);
132         }
133         catch (Exception e) {
134             _log.error(e, e);
135 
136             throw new RemoteException(e.getMessage());
137         }
138     }
139 
140     public static int getCategoriesCount(long groupId, long parentCategoryId)
141         throws RemoteException {
142         try {
143             int returnValue = MBCategoryServiceUtil.getCategoriesCount(groupId,
144                     parentCategoryId);
145 
146             return returnValue;
147         }
148         catch (Exception e) {
149             _log.error(e, e);
150 
151             throw new RemoteException(e.getMessage());
152         }
153     }
154 
155     public static com.liferay.portlet.messageboards.model.MBCategorySoap getCategory(
156         long categoryId) throws RemoteException {
157         try {
158             com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.getCategory(categoryId);
159 
160             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
161         }
162         catch (Exception e) {
163             _log.error(e, e);
164 
165             throw new RemoteException(e.getMessage());
166         }
167     }
168 
169     public static void subscribeCategory(long categoryId)
170         throws RemoteException {
171         try {
172             MBCategoryServiceUtil.subscribeCategory(categoryId);
173         }
174         catch (Exception e) {
175             _log.error(e, e);
176 
177             throw new RemoteException(e.getMessage());
178         }
179     }
180 
181     public static void unsubscribeCategory(long categoryId)
182         throws RemoteException {
183         try {
184             MBCategoryServiceUtil.unsubscribeCategory(categoryId);
185         }
186         catch (Exception e) {
187             _log.error(e, e);
188 
189             throw new RemoteException(e.getMessage());
190         }
191     }
192 
193     public static com.liferay.portlet.messageboards.model.MBCategorySoap updateCategory(
194         long categoryId, long parentCategoryId, java.lang.String name,
195         java.lang.String description, boolean mergeWithParentCategory)
196         throws RemoteException {
197         try {
198             com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.updateCategory(categoryId,
199                     parentCategoryId, name, description, mergeWithParentCategory);
200 
201             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
202         }
203         catch (Exception e) {
204             _log.error(e, e);
205 
206             throw new RemoteException(e.getMessage());
207         }
208     }
209 
210     private static Log _log = LogFactoryUtil.getLog(MBCategoryServiceSoap.class);
211 }