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    }