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