001    /**
002     * Copyright (c) 2000-2012 Liferay, Inc. All rights reserved.
003     *
004     * This library is free software; you can redistribute it and/or modify it under
005     * the terms of the GNU Lesser General Public License as published by the Free
006     * Software Foundation; either version 2.1 of the License, or (at your option)
007     * any later version.
008     *
009     * This library is distributed in the hope that it will be useful, but WITHOUT
010     * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
011     * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
012     * details.
013     */
014    
015    package com.liferay.portlet.trash.service.http;
016    
017    import com.liferay.portal.kernel.log.Log;
018    import com.liferay.portal.kernel.log.LogFactoryUtil;
019    
020    import com.liferay.portlet.trash.service.TrashEntryServiceUtil;
021    
022    import java.rmi.RemoteException;
023    
024    /**
025     * <p>
026     * This class provides a SOAP utility for the
027     * {@link com.liferay.portlet.trash.service.TrashEntryServiceUtil} service utility. The
028     * static methods of this class calls the same methods of the service utility.
029     * However, the signatures are different because it is difficult for SOAP to
030     * support certain types.
031     * </p>
032     *
033     * <p>
034     * ServiceBuilder follows certain rules in translating the methods. For example,
035     * if the method in the service utility returns a {@link java.util.List}, that
036     * is translated to an array of {@link com.liferay.portlet.trash.model.TrashEntrySoap}.
037     * If the method in the service utility returns a
038     * {@link com.liferay.portlet.trash.model.TrashEntry}, that is translated to a
039     * {@link com.liferay.portlet.trash.model.TrashEntrySoap}. Methods that SOAP cannot
040     * safely wire are skipped.
041     * </p>
042     *
043     * <p>
044     * The benefits of using the SOAP utility is that it is cross platform
045     * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and
046     * even Perl, to call the generated services. One drawback of SOAP is that it is
047     * slow because it needs to serialize all calls into a text format (XML).
048     * </p>
049     *
050     * <p>
051     * You can see a list of services at http://localhost:8080/api/axis. Set the
052     * property <b>axis.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       TrashEntryServiceHttp
062     * @see       com.liferay.portlet.trash.model.TrashEntrySoap
063     * @see       com.liferay.portlet.trash.service.TrashEntryServiceUtil
064     * @generated
065     */
066    public class TrashEntryServiceSoap {
067            /**
068            * Deletes the trash entries with the matching group ID considering
069            * permissions.
070            *
071            * @param groupId the primary key of the group
072            * @throws PrincipalException if a principal exception occurred
073            * @throws SystemException if a system exception occurred
074            */
075            public static void deleteEntries(long groupId) throws RemoteException {
076                    try {
077                            TrashEntryServiceUtil.deleteEntries(groupId);
078                    }
079                    catch (Exception e) {
080                            _log.error(e, e);
081    
082                            throw new RemoteException(e.getMessage());
083                    }
084            }
085    
086            /**
087            * Returns the trash entries with the matching group ID.
088            *
089            * @param groupId the primary key of the group
090            * @return the matching trash entries
091            * @throws PrincipalException if a principal exception occurred
092            * @throws SystemException if a system exception occurred
093            */
094            public static com.liferay.portlet.trash.model.TrashEntryList getEntries(
095                    long groupId) throws RemoteException {
096                    try {
097                            com.liferay.portlet.trash.model.TrashEntryList returnValue = TrashEntryServiceUtil.getEntries(groupId);
098    
099                            return returnValue;
100                    }
101                    catch (Exception e) {
102                            _log.error(e, e);
103    
104                            throw new RemoteException(e.getMessage());
105                    }
106            }
107    
108            /**
109            * Returns a range of all the trash entries matching the group ID.
110            *
111            * @param groupId the primary key of the group
112            * @param start the lower bound of the range of trash entries to return
113            * @param end the upper bound of the range of trash entries to return (not
114            inclusive)
115            * @param obc the comparator to order the trash entries (optionally
116            <code>null</code>)
117            * @return the range of matching trash entries ordered by comparator
118            <code>obc</code>
119            * @throws PrincipalException if a system exception occurred
120            * @throws SystemException if a system exception occurred
121            */
122            public static com.liferay.portlet.trash.model.TrashEntryList getEntries(
123                    long groupId, int start, int end,
124                    com.liferay.portal.kernel.util.OrderByComparator obc)
125                    throws RemoteException {
126                    try {
127                            com.liferay.portlet.trash.model.TrashEntryList returnValue = TrashEntryServiceUtil.getEntries(groupId,
128                                            start, end, obc);
129    
130                            return returnValue;
131                    }
132                    catch (Exception e) {
133                            _log.error(e, e);
134    
135                            throw new RemoteException(e.getMessage());
136                    }
137            }
138    
139            private static Log _log = LogFactoryUtil.getLog(TrashEntryServiceSoap.class);
140    }