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    }