001    /**
002     * Copyright (c) 2000-2010 Liferay, Inc. All rights reserved.
003     *
004     * The contents of this file are subject to the terms of the Liferay Enterprise
005     * Subscription License ("License"). You may not use this file except in
006     * compliance with the License. You can obtain a copy of the License by
007     * contacting Liferay, Inc. See the License for the specific language governing
008     * permissions and limitations under the License, including but not limited to
009     * distribution rights of the Software.
010     *
011     *
012     *
013     */
014    
015    package com.liferay.portal.service.http;
016    
017    import com.liferay.portal.kernel.log.Log;
018    import com.liferay.portal.kernel.log.LogFactoryUtil;
019    import com.liferay.portal.service.UserGroupServiceUtil;
020    
021    import java.rmi.RemoteException;
022    
023    /**
024     * <p>
025     * This class provides a SOAP utility for the
026     * {@link com.liferay.portal.service.UserGroupServiceUtil} service utility. The
027     * static methods of this class calls the same methods of the service utility.
028     * However, the signatures are different because it is difficult for SOAP to
029     * support certain types.
030     * </p>
031     *
032     * <p>
033     * ServiceBuilder follows certain rules in translating the methods. For example,
034     * if the method in the service utility returns a {@link java.util.List}, that
035     * is translated to an array of {@link com.liferay.portal.model.UserGroupSoap}.
036     * If the method in the service utility returns a
037     * {@link com.liferay.portal.model.UserGroup}, that is translated to a
038     * {@link com.liferay.portal.model.UserGroupSoap}. Methods that SOAP cannot
039     * safely wire are skipped.
040     * </p>
041     *
042     * <p>
043     * The benefits of using the SOAP utility is that it is cross platform
044     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
045     * even Perl, to call the generated services. One drawback of SOAP is that it is
046     * slow because it needs to serialize all calls into a text format (XML).
047     * </p>
048     *
049     * <p>
050     * You can see a list of services at
051     * http://localhost:8080/tunnel-web/secure/axis. Set the property
052     * <b>tunnel.servlet.hosts.allowed</b> in portal.properties to configure
053     * security.
054     * </p>
055     *
056     * <p>
057     * The SOAP utility is only generated for remote services.
058     * </p>
059     *
060     * @author    Brian Wing Shun Chan
061     * @see       UserGroupServiceHttp
062     * @see       com.liferay.portal.model.UserGroupSoap
063     * @see       com.liferay.portal.service.UserGroupServiceUtil
064     * @generated
065     */
066    public class UserGroupServiceSoap {
067            public static void addGroupUserGroups(long groupId, long[] userGroupIds)
068                    throws RemoteException {
069                    try {
070                            UserGroupServiceUtil.addGroupUserGroups(groupId, userGroupIds);
071                    }
072                    catch (Exception e) {
073                            _log.error(e, e);
074    
075                            throw new RemoteException(e.getMessage());
076                    }
077            }
078    
079            public static com.liferay.portal.model.UserGroupSoap addUserGroup(
080                    java.lang.String name, java.lang.String description)
081                    throws RemoteException {
082                    try {
083                            com.liferay.portal.model.UserGroup returnValue = UserGroupServiceUtil.addUserGroup(name,
084                                            description);
085    
086                            return com.liferay.portal.model.UserGroupSoap.toSoapModel(returnValue);
087                    }
088                    catch (Exception e) {
089                            _log.error(e, e);
090    
091                            throw new RemoteException(e.getMessage());
092                    }
093            }
094    
095            public static void deleteUserGroup(long userGroupId)
096                    throws RemoteException {
097                    try {
098                            UserGroupServiceUtil.deleteUserGroup(userGroupId);
099                    }
100                    catch (Exception e) {
101                            _log.error(e, e);
102    
103                            throw new RemoteException(e.getMessage());
104                    }
105            }
106    
107            public static com.liferay.portal.model.UserGroupSoap getUserGroup(
108                    long userGroupId) throws RemoteException {
109                    try {
110                            com.liferay.portal.model.UserGroup returnValue = UserGroupServiceUtil.getUserGroup(userGroupId);
111    
112                            return com.liferay.portal.model.UserGroupSoap.toSoapModel(returnValue);
113                    }
114                    catch (Exception e) {
115                            _log.error(e, e);
116    
117                            throw new RemoteException(e.getMessage());
118                    }
119            }
120    
121            public static com.liferay.portal.model.UserGroupSoap getUserGroup(
122                    java.lang.String name) throws RemoteException {
123                    try {
124                            com.liferay.portal.model.UserGroup returnValue = UserGroupServiceUtil.getUserGroup(name);
125    
126                            return com.liferay.portal.model.UserGroupSoap.toSoapModel(returnValue);
127                    }
128                    catch (Exception e) {
129                            _log.error(e, e);
130    
131                            throw new RemoteException(e.getMessage());
132                    }
133            }
134    
135            public static com.liferay.portal.model.UserGroupSoap[] getUserUserGroups(
136                    long userId) throws RemoteException {
137                    try {
138                            java.util.List<com.liferay.portal.model.UserGroup> returnValue = UserGroupServiceUtil.getUserUserGroups(userId);
139    
140                            return com.liferay.portal.model.UserGroupSoap.toSoapModels(returnValue);
141                    }
142                    catch (Exception e) {
143                            _log.error(e, e);
144    
145                            throw new RemoteException(e.getMessage());
146                    }
147            }
148    
149            public static void unsetGroupUserGroups(long groupId, long[] userGroupIds)
150                    throws RemoteException {
151                    try {
152                            UserGroupServiceUtil.unsetGroupUserGroups(groupId, userGroupIds);
153                    }
154                    catch (Exception e) {
155                            _log.error(e, e);
156    
157                            throw new RemoteException(e.getMessage());
158                    }
159            }
160    
161            public static com.liferay.portal.model.UserGroupSoap updateUserGroup(
162                    long userGroupId, java.lang.String name, java.lang.String description)
163                    throws RemoteException {
164                    try {
165                            com.liferay.portal.model.UserGroup returnValue = UserGroupServiceUtil.updateUserGroup(userGroupId,
166                                            name, description);
167    
168                            return com.liferay.portal.model.UserGroupSoap.toSoapModel(returnValue);
169                    }
170                    catch (Exception e) {
171                            _log.error(e, e);
172    
173                            throw new RemoteException(e.getMessage());
174                    }
175            }
176    
177            private static Log _log = LogFactoryUtil.getLog(UserGroupServiceSoap.class);
178    }