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; 016 017 import com.liferay.portal.kernel.exception.PortalException; 018 import com.liferay.portal.kernel.exception.SystemException; 019 import com.liferay.portal.kernel.jsonwebservice.JSONWebService; 020 import com.liferay.portal.kernel.transaction.Isolation; 021 import com.liferay.portal.kernel.transaction.Propagation; 022 import com.liferay.portal.kernel.transaction.Transactional; 023 import com.liferay.portal.security.ac.AccessControlled; 024 import com.liferay.portal.service.BaseService; 025 026 /** 027 * The interface for the trash entry remote service. 028 * 029 * <p> 030 * This is a remote service. Methods of this service are expected to have security checks based on the propagated JAAS credentials because this service can be accessed remotely. 031 * </p> 032 * 033 * @author Brian Wing Shun Chan 034 * @see TrashEntryServiceUtil 035 * @see com.liferay.portlet.trash.service.base.TrashEntryServiceBaseImpl 036 * @see com.liferay.portlet.trash.service.impl.TrashEntryServiceImpl 037 * @generated 038 */ 039 @AccessControlled 040 @JSONWebService 041 @Transactional(isolation = Isolation.PORTAL, rollbackFor = { 042 PortalException.class, SystemException.class}) 043 public interface TrashEntryService extends BaseService { 044 /* 045 * NOTE FOR DEVELOPERS: 046 * 047 * Never modify or reference this interface directly. Always use {@link TrashEntryServiceUtil} to access the trash entry remote service. Add custom service methods to {@link com.liferay.portlet.trash.service.impl.TrashEntryServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface. 048 */ 049 050 /** 051 * Returns the Spring bean ID for this bean. 052 * 053 * @return the Spring bean ID for this bean 054 */ 055 public java.lang.String getBeanIdentifier(); 056 057 /** 058 * Sets the Spring bean ID for this bean. 059 * 060 * @param beanIdentifier the Spring bean ID for this bean 061 */ 062 public void setBeanIdentifier(java.lang.String beanIdentifier); 063 064 /** 065 * Deletes the trash entries with the matching group ID considering 066 * permissions. 067 * 068 * @param groupId the primary key of the group 069 * @throws PrincipalException if a principal exception occurred 070 * @throws SystemException if a system exception occurred 071 */ 072 public void deleteEntries(long groupId) 073 throws com.liferay.portal.kernel.exception.SystemException, 074 com.liferay.portal.security.auth.PrincipalException; 075 076 /** 077 * Returns the trash entries with the matching group ID. 078 * 079 * @param groupId the primary key of the group 080 * @return the matching trash entries 081 * @throws PrincipalException if a principal exception occurred 082 * @throws SystemException if a system exception occurred 083 */ 084 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 085 public com.liferay.portlet.trash.model.TrashEntryList getEntries( 086 long groupId) 087 throws com.liferay.portal.kernel.exception.SystemException, 088 com.liferay.portal.security.auth.PrincipalException; 089 090 /** 091 * Returns a range of all the trash entries matching the group ID. 092 * 093 * @param groupId the primary key of the group 094 * @param start the lower bound of the range of trash entries to return 095 * @param end the upper bound of the range of trash entries to return (not 096 inclusive) 097 * @param obc the comparator to order the trash entries (optionally 098 <code>null</code>) 099 * @return the range of matching trash entries ordered by comparator 100 <code>obc</code> 101 * @throws PrincipalException if a system exception occurred 102 * @throws SystemException if a system exception occurred 103 */ 104 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 105 public com.liferay.portlet.trash.model.TrashEntryList getEntries( 106 long groupId, int start, int end, 107 com.liferay.portal.kernel.util.OrderByComparator obc) 108 throws com.liferay.portal.kernel.exception.SystemException, 109 com.liferay.portal.security.auth.PrincipalException; 110 }