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