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 }