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.messageboards.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.messageboards.service.MBCategoryServiceUtil;
26  
27  import java.rmi.RemoteException;
28  
29  /**
30   * <a href="MBCategoryServiceSoap.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.messageboards.service.MBCategoryServiceUtil</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.messageboards.model.MBCategorySoap</code>. If the method in the
50   * service utility returns a <code>com.liferay.portlet.messageboards.model.MBCategory</code>,
51   * that is translated to a <code>com.liferay.portlet.messageboards.model.MBCategorySoap</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.messageboards.model.MBCategorySoap
76   * @see com.liferay.portlet.messageboards.service.MBCategoryServiceUtil
77   * @see com.liferay.portlet.messageboards.service.http.MBCategoryServiceHttp
78   *
79   */
80  public class MBCategoryServiceSoap {
81      public static com.liferay.portlet.messageboards.model.MBCategorySoap 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.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
87                      parentCategoryId, name, description,
88                      addCommunityPermissions, addGuestPermissions);
89  
90              return com.liferay.portlet.messageboards.model.MBCategorySoap.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.messageboards.model.MBCategorySoap 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.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
105                     parentCategoryId, name, description, communityPermissions,
106                     guestPermissions);
107 
108             return com.liferay.portlet.messageboards.model.MBCategorySoap.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             MBCategoryServiceUtil.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.messageboards.model.MBCategorySoap getCategory(
130         long categoryId) throws RemoteException {
131         try {
132             com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.getCategory(categoryId);
133 
134             return com.liferay.portlet.messageboards.model.MBCategorySoap.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.messageboards.model.MBCategorySoap[] getCategories(
144         long groupId, long parentCategoryId, int start, int end)
145         throws RemoteException {
146         try {
147             java.util.List<com.liferay.portlet.messageboards.model.MBCategory> returnValue =
148                 MBCategoryServiceUtil.getCategories(groupId, parentCategoryId,
149                     start, end);
150 
151             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModels(returnValue);
152         }
153         catch (Exception e) {
154             _log.error(e, e);
155 
156             throw new RemoteException(e.getMessage());
157         }
158     }
159 
160     public static int getCategoriesCount(long groupId, long parentCategoryId)
161         throws RemoteException {
162         try {
163             int returnValue = MBCategoryServiceUtil.getCategoriesCount(groupId,
164                     parentCategoryId);
165 
166             return returnValue;
167         }
168         catch (Exception e) {
169             _log.error(e, e);
170 
171             throw new RemoteException(e.getMessage());
172         }
173     }
174 
175     public static void subscribeCategory(long categoryId)
176         throws RemoteException {
177         try {
178             MBCategoryServiceUtil.subscribeCategory(categoryId);
179         }
180         catch (Exception e) {
181             _log.error(e, e);
182 
183             throw new RemoteException(e.getMessage());
184         }
185     }
186 
187     public static void unsubscribeCategory(long categoryId)
188         throws RemoteException {
189         try {
190             MBCategoryServiceUtil.unsubscribeCategory(categoryId);
191         }
192         catch (Exception e) {
193             _log.error(e, e);
194 
195             throw new RemoteException(e.getMessage());
196         }
197     }
198 
199     public static com.liferay.portlet.messageboards.model.MBCategorySoap updateCategory(
200         long categoryId, long parentCategoryId, java.lang.String name,
201         java.lang.String description, boolean mergeWithParentCategory)
202         throws RemoteException {
203         try {
204             com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.updateCategory(categoryId,
205                     parentCategoryId, name, description, mergeWithParentCategory);
206 
207             return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
208         }
209         catch (Exception e) {
210             _log.error(e, e);
211 
212             throw new RemoteException(e.getMessage());
213         }
214     }
215 
216     private static Log _log = LogFactoryUtil.getLog(MBCategoryServiceSoap.class);
217 }