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    }