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.social.service; 016 017 import com.liferay.portal.kernel.exception.PortalException; 018 import com.liferay.portal.kernel.exception.SystemException; 019 import com.liferay.portal.kernel.transaction.Isolation; 020 import com.liferay.portal.kernel.transaction.Transactional; 021 022 /** 023 * The interface for the social activity interpreter local service. 024 * 025 * <p> 026 * This is a local service. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM. 027 * </p> 028 * 029 * @author Brian Wing Shun Chan 030 * @see SocialActivityInterpreterLocalServiceUtil 031 * @see com.liferay.portlet.social.service.base.SocialActivityInterpreterLocalServiceBaseImpl 032 * @see com.liferay.portlet.social.service.impl.SocialActivityInterpreterLocalServiceImpl 033 * @generated 034 */ 035 @Transactional(isolation = Isolation.PORTAL, rollbackFor = { 036 PortalException.class, SystemException.class}) 037 public interface SocialActivityInterpreterLocalService { 038 /* 039 * NOTE FOR DEVELOPERS: 040 * 041 * Never modify or reference this interface directly. Always use {@link SocialActivityInterpreterLocalServiceUtil} to access the social activity interpreter local service. Add custom service methods to {@link com.liferay.portlet.social.service.impl.SocialActivityInterpreterLocalServiceImpl} and rerun ServiceBuilder to automatically copy the method declarations to this interface. 042 */ 043 044 /** 045 * Returns the Spring bean ID for this bean. 046 * 047 * @return the Spring bean ID for this bean 048 */ 049 public java.lang.String getBeanIdentifier(); 050 051 /** 052 * Sets the Spring bean ID for this bean. 053 * 054 * @param beanIdentifier the Spring bean ID for this bean 055 */ 056 public void setBeanIdentifier(java.lang.String beanIdentifier); 057 058 /** 059 * Adds the activity interpreter to the list of available interpreters. 060 * 061 * @param activityInterpreter the activity interpreter 062 */ 063 public void addActivityInterpreter( 064 com.liferay.portlet.social.model.SocialActivityInterpreter activityInterpreter); 065 066 /** 067 * Removes the activity interpreter from the list of available interpreters. 068 * 069 * @param activityInterpreter the activity interpreter 070 */ 071 public void deleteActivityInterpreter( 072 com.liferay.portlet.social.model.SocialActivityInterpreter activityInterpreter); 073 074 /** 075 * Creates a human readable activity feed entry for the activity using an 076 * available compatible activity interpreter. 077 * 078 * <p> 079 * This method finds the appropriate interpreter for the activity by going 080 * through the available interpreters and asking them if they can handle the 081 * asset type of the activity. 082 * </p> 083 * 084 * @param activity the activity to be translated to human readable form 085 * @param themeDisplay the theme display needed by interpreters to create 086 links and get localized text fragments 087 * @return the activity feed that is a human readable form of the activity 088 record or <code>null</code> if a compatible interpreter is not 089 found 090 */ 091 public com.liferay.portlet.social.model.SocialActivityFeedEntry interpret( 092 com.liferay.portlet.social.model.SocialActivity activity, 093 com.liferay.portal.theme.ThemeDisplay themeDisplay); 094 }