| MBCategoryServiceSoap.java |
1 /**
2 * Copyright (c) 2000-2008 Liferay, Inc. All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a copy
5 * of this software and associated documentation files (the "Software"), to deal
6 * in the Software without restriction, including without limitation the rights
7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 * copies of the Software, and to permit persons to whom the Software is
9 * furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20 * SOFTWARE.
21 */
22
23 package com.liferay.portlet.messageboards.service.http;
24
25 import com.liferay.portal.kernel.log.Log;
26 import com.liferay.portal.kernel.log.LogFactoryUtil;
27
28 import com.liferay.portlet.messageboards.service.MBCategoryServiceUtil;
29
30 import java.rmi.RemoteException;
31
32 /**
33 * <a href="MBCategoryServiceSoap.java.html"><b><i>View Source</i></b></a>
34 *
35 * <p>
36 * ServiceBuilder generated this class. Modifications in this class will be
37 * overwritten the next time is generated.
38 * </p>
39 *
40 * <p>
41 * This class provides a SOAP utility for the
42 * <code>com.liferay.portlet.messageboards.service.MBCategoryServiceUtil</code> service
43 * utility. The static methods of this class calls the same methods of the
44 * service utility. However, the signatures are different because it is
45 * difficult for SOAP to support certain types.
46 * </p>
47 *
48 * <p>
49 * ServiceBuilder follows certain rules in translating the methods. For example,
50 * if the method in the service utility returns a <code>java.util.List</code>,
51 * that is translated to an array of
52 * <code>com.liferay.portlet.messageboards.model.MBCategorySoap</code>. If the method in the
53 * service utility returns a <code>com.liferay.portlet.messageboards.model.MBCategory</code>,
54 * that is translated to a <code>com.liferay.portlet.messageboards.model.MBCategorySoap</code>.
55 * Methods that SOAP cannot safely wire are skipped.
56 * </p>
57 *
58 * <p>
59 * The benefits of using the SOAP utility is that it is cross platform
60 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
61 * even Perl, to call the generated services. One drawback of SOAP is that it is
62 * slow because it needs to serialize all calls into a text format (XML).
63 * </p>
64 *
65 * <p>
66 * You can see a list of services at
67 * http://localhost:8080/tunnel-web/secure/axis. Set the property
68 * <code>tunnel.servlet.hosts.allowed</code> in portal.properties to configure
69 * security.
70 * </p>
71 *
72 * <p>
73 * The SOAP utility is only generated for remote services.
74 * </p>
75 *
76 * @author Brian Wing Shun Chan
77 *
78 * @see com.liferay.portlet.messageboards.service.MBCategoryServiceUtil
79 * @see com.liferay.portlet.messageboards.service.http.MBCategoryServiceHttp
80 * @see com.liferay.portlet.messageboards.service.model.MBCategorySoap
81 *
82 */
83 public class MBCategoryServiceSoap {
84 public static com.liferay.portlet.messageboards.model.MBCategorySoap addCategory(
85 long plid, long parentCategoryId, java.lang.String name,
86 java.lang.String description, boolean addCommunityPermissions,
87 boolean addGuestPermissions) throws RemoteException {
88 try {
89 com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
90 parentCategoryId, name, description,
91 addCommunityPermissions, addGuestPermissions);
92
93 return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
94 }
95 catch (Exception e) {
96 _log.error(e, e);
97
98 throw new RemoteException(e.getMessage());
99 }
100 }
101
102 public static com.liferay.portlet.messageboards.model.MBCategorySoap addCategory(
103 long plid, long parentCategoryId, java.lang.String name,
104 java.lang.String description, java.lang.String[] communityPermissions,
105 java.lang.String[] guestPermissions) throws RemoteException {
106 try {
107 com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.addCategory(plid,
108 parentCategoryId, name, description, communityPermissions,
109 guestPermissions);
110
111 return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
112 }
113 catch (Exception e) {
114 _log.error(e, e);
115
116 throw new RemoteException(e.getMessage());
117 }
118 }
119
120 public static void deleteCategory(long categoryId)
121 throws RemoteException {
122 try {
123 MBCategoryServiceUtil.deleteCategory(categoryId);
124 }
125 catch (Exception e) {
126 _log.error(e, e);
127
128 throw new RemoteException(e.getMessage());
129 }
130 }
131
132 public static com.liferay.portlet.messageboards.model.MBCategorySoap getCategory(
133 long categoryId) throws RemoteException {
134 try {
135 com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.getCategory(categoryId);
136
137 return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
138 }
139 catch (Exception e) {
140 _log.error(e, e);
141
142 throw new RemoteException(e.getMessage());
143 }
144 }
145
146 public static com.liferay.portlet.messageboards.model.MBCategorySoap[] getCategories(
147 long groupId, long parentCategoryId, int begin, int end)
148 throws RemoteException {
149 try {
150 java.util.List<com.liferay.portlet.messageboards.model.MBCategory> returnValue =
151 MBCategoryServiceUtil.getCategories(groupId, parentCategoryId,
152 begin, end);
153
154 return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModels(returnValue);
155 }
156 catch (Exception e) {
157 _log.error(e, e);
158
159 throw new RemoteException(e.getMessage());
160 }
161 }
162
163 public static int getCategoriesCount(long groupId, long parentCategoryId)
164 throws RemoteException {
165 try {
166 int returnValue = MBCategoryServiceUtil.getCategoriesCount(groupId,
167 parentCategoryId);
168
169 return returnValue;
170 }
171 catch (Exception e) {
172 _log.error(e, e);
173
174 throw new RemoteException(e.getMessage());
175 }
176 }
177
178 public static void subscribeCategory(long categoryId)
179 throws RemoteException {
180 try {
181 MBCategoryServiceUtil.subscribeCategory(categoryId);
182 }
183 catch (Exception e) {
184 _log.error(e, e);
185
186 throw new RemoteException(e.getMessage());
187 }
188 }
189
190 public static void unsubscribeCategory(long categoryId)
191 throws RemoteException {
192 try {
193 MBCategoryServiceUtil.unsubscribeCategory(categoryId);
194 }
195 catch (Exception e) {
196 _log.error(e, e);
197
198 throw new RemoteException(e.getMessage());
199 }
200 }
201
202 public static com.liferay.portlet.messageboards.model.MBCategorySoap updateCategory(
203 long categoryId, long parentCategoryId, java.lang.String name,
204 java.lang.String description, boolean mergeWithParentCategory)
205 throws RemoteException {
206 try {
207 com.liferay.portlet.messageboards.model.MBCategory returnValue = MBCategoryServiceUtil.updateCategory(categoryId,
208 parentCategoryId, name, description, mergeWithParentCategory);
209
210 return com.liferay.portlet.messageboards.model.MBCategorySoap.toSoapModel(returnValue);
211 }
212 catch (Exception e) {
213 _log.error(e, e);
214
215 throw new RemoteException(e.getMessage());
216 }
217 }
218
219 private static Log _log = LogFactoryUtil.getLog(MBCategoryServiceSoap.class);
220 }