package org.sakaiproject.profile2.logic;
import java.util.Map;
import org.sakaiproject.profile2.model.ExternalIntegrationInfo;
/**
* An interface for dealing with external integrations in Profile2
*
* @author Steve Swinsburg (steve.swinsburg@gmail.com)
*
*/
public interface ProfileExternalIntegrationLogic {
/**
* Get the ExternalIntegrationInfo record for a user or an empty record if none.
* @param userUuid
* @return
*/
public ExternalIntegrationInfo getExternalIntegrationInfo(final String userUuid);
/**
* Update a user's ExternalIntegrationInfo
* @param info ExternalIntegrationInfo object for the user
* @return
*/
public boolean updateExternalIntegrationInfo(ExternalIntegrationInfo info);
/**
* Returns a map of the Twitter OAuth consumer 'key' and 'secret'
* @return
*/
public Map<String,String> getTwitterOAuthConsumerDetails();
/**
* Gets the Twitter name associated with the stored details, if any.
* @param info ExternalIntegrationInfo object for the user
* @return name or null if none/error
*/
public String getTwitterName(ExternalIntegrationInfo info);
/**
* Check if the stored Twitter credentials are valid.
* @param info ExternalIntegrationInfo object for the user
* @return true if valid, false if not/error
*/
public boolean validateTwitterCredentials(ExternalIntegrationInfo info);
/**
* Send a message to twitter ( runs in a separate thread)
*
* <p>Will only run if twitter integration is enabled globally (ie via sakai.properties)
* and if the user has linked their account.</p>
*
* <p>Messages longer than 140 chars will be truncated to 140 chars. This is also validated client side.</p>
*
* @param userUuid uuid of the user
* @param message the message
*/
public void sendMessageToTwitter(final String userUuid, String message);
}