lumis.collaboration.chat
Interface IChatManager

Package class diagram package IChatManager
All Known Implementing Classes:
ChatManager

@StableMinor(version="5.5",
             sinceVersion="4.0")
public interface IChatManager

Interface for managing Chat Objects

Since:
4.0.5

Method Summary
 void addConversation(SessionConfig sessionConfig, ChatConversationConfig conversationConfig, ITransaction transaction)
          Adds a chat conversation.
 void addMessage(SessionConfig sessionConfig, ChatMessageConfig messageConfig, ITransaction transaction)
          Adds a chat message to a conversation.
 void addUser(SessionConfig sessionConfig, ChatUserConfig userConfig, ITransaction transaction)
          Adds a chat user
 void closeExpiredConversations(SessionConfig sessionConfig, ITransaction transaction)
          closes expired conversations.
 void deleteConversation(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Deletes the given chat conversation.
 void deleteMessage(SessionConfig sessionConfig, String messageId, ITransaction transaction)
          Deletes the given message Id from its conversation.
 void deleteUser(SessionConfig sessionConfig, String userId, ITransaction transaction)
          Deletes the given user.
 Collection<ChatUserConfig> getActiveUsers(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Returns all the active chat users given the conversation id
 ChatConversationConfig getConversation(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Returns a chat conversation config object.
 List<ChatMessageConfig> getLatestMessages(SessionConfig sessionConfig, String conversationId, String chatUserId, int maxMessages, boolean getMessagesToModerate, Date greaterThanDate, ITransaction transaction)
          Deprecated. Since 4.0.11 this method was replaced by getLatestMessages(SessionConfig, String, String, int, int, boolean, Date, ITransaction).
 List<ChatMessageConfig> getLatestMessages(SessionConfig sessionConfig, String conversationId, String chatUserId, int firstMessageIndex, int maxMessages, boolean getMessagesToModerate, Date greaterThanDate, ITransaction transaction)
          Returns up to maxMessages messageConfigs for a given conversationId.
 int getLatestMessagesCount(SessionConfig sessionConfig, String conversationId, String chatUserId, boolean getMessagesToModerate, Date greaterThanDate, ITransaction transaction)
          Returns the number of messages that exists and would be available for the #getLatestMessages(String, String, int, int, boolean, Date, ITransaction) method.
 ChatMessageConfig getMessage(SessionConfig sessionConfig, String messageId, ITransaction transaction)
          Returns a message config object.
 Collection<ChatMessageConfig> getMessages(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Returns all the messages for a given conversationId.
 String getMessagesXml(SessionConfig sessionConfig, Collection<ChatMessageConfig> chatMessageConfigs, boolean getMessagesToModerate, List<IResource> resources, ITransaction transaction)
          Returns the xml for the given messages.
 ChatUserConfig getUser(SessionConfig sessionConfig, String id, ITransaction transaction)
          Returns a chat user given the chat user id
 ChatUserConfig getUser(SessionConfig sessionConfig, String userId, String conversationId, String userSessionId, ITransaction transaction)
          Returns a chat user given the portal user id, conversation id and optionally the user sessionId
 Collection<ChatUserConfig> getUsers(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Returns all the chat users given the conversation id
 void openStartedConversations(SessionConfig sessionConfig, ITransaction transaction)
          Opens the conversations whose startTime has already been reached.
 boolean reachedUserLimit(SessionConfig sessionConfig, String conversationId, ITransaction transaction)
          Returns true if the conversation has reached its user limit
 void updateActiveUserState(SessionConfig sessionConfig, ITransaction transaction)
          Checks if any of the active users have not updated their last acces date.
 void updateLastAccess(SessionConfig sessionConfig, String chatUserId, ITransaction transaction)
          Updates the last access date for the given chat user.
 void userLeftConversation(SessionConfig sessionConfig, ChatUserConfig chatUserConfig, ITransaction transaction)
          Method to indicate that a user left the conversation
 

Method Detail

addUser

void addUser(SessionConfig sessionConfig,
             ChatUserConfig userConfig,
             ITransaction transaction)
             throws PortalException
Adds a chat user

Parameters:
sessionConfig -
userConfig -
transaction -
Throws:
PortalException

getUser

ChatUserConfig getUser(SessionConfig sessionConfig,
                       String id,
                       ITransaction transaction)
                       throws PortalException
Returns a chat user given the chat user id

Parameters:
sessionConfig -
userConfig -
transaction -
Throws:
PortalException

getUser

ChatUserConfig getUser(SessionConfig sessionConfig,
                       String userId,
                       String conversationId,
                       String userSessionId,
                       ITransaction transaction)
                       throws PortalException
Returns a chat user given the portal user id, conversation id and optionally the user sessionId

Parameters:
sessionConfig -
userId -
conversationId -
userSessionId -
transaction -
Returns:
Throws:
PortalException

getUsers

Collection<ChatUserConfig> getUsers(SessionConfig sessionConfig,
                                    String conversationId,
                                    ITransaction transaction)
                                    throws PortalException
Returns all the chat users given the conversation id

Parameters:
sessionConfig -
conversationId -
transaction -
Returns:
Throws:
PortalException

getActiveUsers

Collection<ChatUserConfig> getActiveUsers(SessionConfig sessionConfig,
                                          String conversationId,
                                          ITransaction transaction)
                                          throws PortalException
Returns all the active chat users given the conversation id

Parameters:
sessionConfig -
conversationId -
transaction -
Returns:
Throws:
PortalException

updateActiveUserState

void updateActiveUserState(SessionConfig sessionConfig,
                           ITransaction transaction)
                           throws PortalException
Checks if any of the active users have not updated their last acces date. If not, change their state to inactive

Parameters:
sessionConfig -
transaction -
Throws:
PortalException

deleteUser

void deleteUser(SessionConfig sessionConfig,
                String userId,
                ITransaction transaction)
                throws PortalException
Deletes the given user.

Parameters:
sessionConfig -
conversationId -
transaction -
Throws:
PortalException

reachedUserLimit

boolean reachedUserLimit(SessionConfig sessionConfig,
                         String conversationId,
                         ITransaction transaction)
                         throws PortalException
Returns true if the conversation has reached its user limit

Parameters:
sessionConfig -
conversationId -
transaction -
Returns:
Throws:
PortalException

addConversation

void addConversation(SessionConfig sessionConfig,
                     ChatConversationConfig conversationConfig,
                     ITransaction transaction)
                     throws PortalException
Adds a chat conversation.

Parameters:
sessionConfig -
conversationConfig -
transaction -
Throws:
PortalException

getConversation

ChatConversationConfig getConversation(SessionConfig sessionConfig,
                                       String conversationId,
                                       ITransaction transaction)
                                       throws PortalException
Returns a chat conversation config object.

Parameters:
sessionConfig -
conversationConfig -
transaction -
Throws:
PortalException

deleteConversation

void deleteConversation(SessionConfig sessionConfig,
                        String conversationId,
                        ITransaction transaction)
                        throws PortalException
Deletes the given chat conversation.

Parameters:
sessionConfig -
conversationId -
transaction -
Throws:
PortalException

openStartedConversations

void openStartedConversations(SessionConfig sessionConfig,
                              ITransaction transaction)
                              throws PortalException
Opens the conversations whose startTime has already been reached.

Parameters:
sessionConfig - the user session information.
transaction - the transaction for persistence access.
Throws:
PortalException
Since:
4.0.11

closeExpiredConversations

void closeExpiredConversations(SessionConfig sessionConfig,
                               ITransaction transaction)
                               throws PortalException
closes expired conversations.

Parameters:
sessionConfig -
transaction -
Throws:
PortalException

addMessage

void addMessage(SessionConfig sessionConfig,
                ChatMessageConfig messageConfig,
                ITransaction transaction)
                throws PortalException
Adds a chat message to a conversation.

Parameters:
sessionConfig -
messageConfig -
transaction -
Throws:
PortalException

getMessage

ChatMessageConfig getMessage(SessionConfig sessionConfig,
                             String messageId,
                             ITransaction transaction)
                             throws PortalException
Returns a message config object.

Parameters:
sessionConfig -
messageConfig -
transaction -
Throws:
PortalException

getMessages

Collection<ChatMessageConfig> getMessages(SessionConfig sessionConfig,
                                          String conversationId,
                                          ITransaction transaction)
                                          throws PortalException
Returns all the messages for a given conversationId. The messages are returned ordered by creation date.

Parameters:
sessionConfig -
messageId -
transaction -
Returns:
Throws:
PortalException

getLatestMessages

@Deprecated
List<ChatMessageConfig> getLatestMessages(SessionConfig sessionConfig,
                                                     String conversationId,
                                                     String chatUserId,
                                                     int maxMessages,
                                                     boolean getMessagesToModerate,
                                                     Date greaterThanDate,
                                                     ITransaction transaction)
                                          throws PortalException
Deprecated. Since 4.0.11 this method was replaced by getLatestMessages(SessionConfig, String, String, int, int, boolean, Date, ITransaction).

Returns up to maxMessages messageConfigs for a given conversationId. If more than maxMessages exist, the most recent messages are returned. The messages are returned ordered by creation date.

Parameters:
sessionConfig - the user session information.
conversationId - the conversation identifier.
chatUserId - the chat user identifier. If null no private messages are returned. If specified the private messages for that user are returned.
maxMessages - the maximum number of messages to be returned.
getMessagesToModerate - if true the messages to moderate are also returned.
greaterThanDate - if not null, only the message with sent date-time greater than this argument are returned.
transaction - the transaction for persistence access.
Returns:
the messages.
Throws:
PortalException

getLatestMessages

List<ChatMessageConfig> getLatestMessages(SessionConfig sessionConfig,
                                          String conversationId,
                                          String chatUserId,
                                          int firstMessageIndex,
                                          int maxMessages,
                                          boolean getMessagesToModerate,
                                          Date greaterThanDate,
                                          ITransaction transaction)
                                          throws PortalException
Returns up to maxMessages messageConfigs for a given conversationId. If more than maxMessages exist, the most recent messages are returned. The messages returned start at the firstMessage zero-based index. The messages are returned ordered by descending sent date-time.

Parameters:
sessionConfig - the user session information.
conversationId - the conversation identifier.
chatUserId - the chat user identifier. If null no private messages are returned. If specified the private messages for that user are returned.
firstMessageIndex - the index of the first message to be returned. This index is zero based. May be used for pagination.
maxMessages - the maximum number of messages to be returned.
getMessagesToModerate - if true the messages to moderate are also returned.
greaterThanDate - if not null, only the message with sent date-time greater than this argument are returned.
transaction - the transaction for persistence access.
Returns:
the list of messages.
Throws:
PortalException
Since:
4.0.11

getMessagesXml

String getMessagesXml(SessionConfig sessionConfig,
                      Collection<ChatMessageConfig> chatMessageConfigs,
                      boolean getMessagesToModerate,
                      List<IResource> resources,
                      ITransaction transaction)
                      throws PortalException
Returns the xml for the given messages. The collection's iterator ordering will be used.

Parameters:
sessionConfig - the user session information.
chatMessageConfigs - the messages collection.
getMessagesToModerate - if true the messages to moderate are also returned.
resources - resources used for localization.
transaction - the transaction for persistence access.
Returns:
the xml.
Throws:
PortalException
Since:
4.0.11

getLatestMessagesCount

int getLatestMessagesCount(SessionConfig sessionConfig,
                           String conversationId,
                           String chatUserId,
                           boolean getMessagesToModerate,
                           Date greaterThanDate,
                           ITransaction transaction)
                           throws PortalException
Returns the number of messages that exists and would be available for the #getLatestMessages(String, String, int, int, boolean, Date, ITransaction) method.

Parameters:
sessionConfig - the user session information.
conversationId - the conversation identifier.
chatUserId - the chat user identifier. If null no private messages are returned. If specified the private messages for that user are returned.
getMessagesToModerate - if true the messages to moderate are also returned.
greaterThanDate - if not null, only the message with sent date-time greater than this argument are returned.
transaction - the transaction for persistence access.
Returns:
the number of messages.
Throws:
PortalException
Since:
4.0.11

deleteMessage

void deleteMessage(SessionConfig sessionConfig,
                   String messageId,
                   ITransaction transaction)
                   throws PortalException
Deletes the given message Id from its conversation.

Parameters:
sessionConfig -
messageId -
transaction -
Throws:
PortalException

updateLastAccess

void updateLastAccess(SessionConfig sessionConfig,
                      String chatUserId,
                      ITransaction transaction)
                      throws PortalException
Updates the last access date for the given chat user.

Parameters:
sessionConfig -
transaction -
Throws:
PortalException

userLeftConversation

void userLeftConversation(SessionConfig sessionConfig,
                          ChatUserConfig chatUserConfig,
                          ITransaction transaction)
                          throws PortalException
Method to indicate that a user left the conversation

Parameters:
sessionConfig -
chatUserConfig -
transaction -
Throws:
PortalException


Lumisportal  5.5.0.091130 - Copyright © 2001-2007, Lumis. All Rights Reserved.