001 /** 002 * Copyright (c) 2000-2013 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.Propagation; 021 import com.liferay.portal.kernel.transaction.Transactional; 022 import com.liferay.portal.service.BaseLocalService; 023 024 /** 025 * The interface for the social activity interpreter local service. 026 * 027 * <p> 028 * 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. 029 * </p> 030 * 031 * @author Brian Wing Shun Chan 032 * @see SocialActivityInterpreterLocalServiceUtil 033 * @see com.liferay.portlet.social.service.base.SocialActivityInterpreterLocalServiceBaseImpl 034 * @see com.liferay.portlet.social.service.impl.SocialActivityInterpreterLocalServiceImpl 035 * @generated 036 */ 037 @Transactional(isolation = Isolation.PORTAL, rollbackFor = { 038 PortalException.class, SystemException.class}) 039 public interface SocialActivityInterpreterLocalService extends BaseLocalService { 040 /* 041 * NOTE FOR DEVELOPERS: 042 * 043 * 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. 044 */ 045 046 /** 047 * Returns the Spring bean ID for this bean. 048 * 049 * @return the Spring bean ID for this bean 050 */ 051 public java.lang.String getBeanIdentifier(); 052 053 /** 054 * Sets the Spring bean ID for this bean. 055 * 056 * @param beanIdentifier the Spring bean ID for this bean 057 */ 058 public void setBeanIdentifier(java.lang.String beanIdentifier); 059 060 /** 061 * Adds the activity interpreter to the list of available interpreters. 062 * 063 * @param activityInterpreter the activity interpreter 064 */ 065 public void addActivityInterpreter( 066 com.liferay.portlet.social.model.SocialActivityInterpreter activityInterpreter); 067 068 /** 069 * Removes the activity interpreter from the list of available interpreters. 070 * 071 * @param activityInterpreter the activity interpreter 072 */ 073 public void deleteActivityInterpreter( 074 com.liferay.portlet.social.model.SocialActivityInterpreter activityInterpreter); 075 076 @Transactional(propagation = Propagation.SUPPORTS, readOnly = true) 077 public java.util.Map<java.lang.String, java.util.List<com.liferay.portlet.social.model.SocialActivityInterpreter>> getActivityInterpreters(); 078 079 /** 080 * @deprecated As of 6.2.0, replaced by {@link #interpret(String, 081 SocialActivity, ServiceContext)} 082 */ 083 public com.liferay.portlet.social.model.SocialActivityFeedEntry interpret( 084 com.liferay.portlet.social.model.SocialActivity activity, 085 com.liferay.portal.theme.ThemeDisplay themeDisplay); 086 087 /** 088 * Creates a human readable activity feed entry for the activity using an 089 * available compatible activity interpreter. 090 * 091 * <p> 092 * This method finds the appropriate interpreter for the activity by going 093 * through the available interpreters and asking them if they can handle the 094 * asset type of the activity. 095 * </p> 096 * 097 * @param activity the activity to be translated to human readable form 098 * @return the activity feed that is a human readable form of the activity 099 record or <code>null</code> if a compatible interpreter is not 100 found 101 */ 102 public com.liferay.portlet.social.model.SocialActivityFeedEntry interpret( 103 java.lang.String selector, 104 com.liferay.portlet.social.model.SocialActivity activity, 105 com.liferay.portal.service.ServiceContext serviceContext); 106 107 public com.liferay.portlet.social.model.SocialActivityFeedEntry interpret( 108 java.lang.String selector, 109 com.liferay.portlet.social.model.SocialActivitySet activitySet, 110 com.liferay.portal.service.ServiceContext serviceContext); 111 112 public void updateActivitySet(long activityId) 113 throws com.liferay.portal.kernel.exception.PortalException, 114 com.liferay.portal.kernel.exception.SystemException; 115 }