Interface ConversationListener
-
public interface ConversationListenerInterface that can be used to retrieve status updates for a conversation. One or more listeners can be registered to retrieve status updates on the conversation's various attributes.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidonConversationActiveStatusChanged(Conversation conversation, boolean isActive)Called to report that the conversation's active status has changed in response to a local or remote operation.voidonConversationCapabilitiesChanged(Conversation conversation)Called to report that one or more of the capabilities of the conversation has changed.voidonConversationClosedStatusChanged(Conversation conversation, boolean isClosed)Called to report that the closed state of the conversation has changed in response to a local or remote operation.voidonConversationLastAccessTimeChanged(Conversation conversation, java.util.Date time)Called to report that the last accessed time of the conversation has changed in response to messages in the conversation being marked as read, or by an explicit invocation of theConversation.setLastAccessTime(MessagingCompletionHandler)method.voidonConversationLastUpdatedTimeChanged(Conversation conversation, java.util.Date time)Called to report that the last updated time of the conversation has changed.voidonConversationLatestEntryTimeChanged(Conversation conversation, java.util.Date time)Called to report that the latest entry time of the conversation has changed in response to new messages being added to the conversation.voidonConversationMessagesAdded(Conversation conversation, java.util.List<Message> messages)Called to report that one or more messages have been added to the conversation.voidonConversationMessagesRemoved(Conversation conversation, java.util.List<Message> messages)Called to report that one or more messages have been removed from the conversation.voidonConversationMultiPartyStatusChanged(Conversation conversation, boolean isMultiParty)Called to report that the isMultiparty state of the conversation has changed in response to new participants being added or existing participants being removed.voidonConversationParticipantsAdded(Conversation conversation, java.util.List<MessagingParticipant> addedParticipants)Called to report that one or more participants have been added to the conversation.voidonConversationParticipantsRemoved(Conversation conversation, java.util.List<MessagingParticipant> removedParticipants)Called to report that one or more participants have been removed from the conversation.voidonConversationPreviewTextChanged(Conversation conversation, java.lang.String previewText)Called to report that the preview text for the conversation has changed.voidonConversationSensitivityChanged(Conversation conversation, SensitivityLevel sensitivity)Called to report that the sensitivity of the conversation has changed via either a local or remote operation.voidonConversationStatusChanged(Conversation conversation, ConversationStatus status)Called to report that resource status of the conversation has changed.voidonConversationSubjectChanged(Conversation conversation, java.lang.String subject)Called to report that the subject of the conversation has changed via either a local or remote operation.voidonConversationTotalAttachmentCountChanged(Conversation conversation, int totalAttachmentCount)Called to report that the total number of attachments in the conversation has changed.voidonConversationTotalMessageCountChanged(Conversation conversation, int totalMsgCount)Called to report that the total number of messages in the conversation has changed.voidonConversationTotalUnreadAttachmentCountChanged(Conversation conversation, int totalUnreadAttachmentCount)Called to report that total number of unread attachments in the conversation has changed.voidonConversationTotalUnreadMessageCountChanged(Conversation conversation, int totalUnreadMsgCount)Called to report that the number of unread messages in the conversation has changed.voidonConversationTypeChanged(Conversation conversation, ConversationType conversationType)Called to report that the type of the conversation has changed.
-
-
-
Method Detail
-
onConversationActiveStatusChanged
void onConversationActiveStatusChanged(Conversation conversation, boolean isActive)
Called to report that the conversation's active status has changed in response to a local or remote operation.- Parameters:
conversation- theConversationfor which the active state has changed.isActive- the new value of the isActive flag.- See Also:
Conversation.isActive()
-
onConversationClosedStatusChanged
void onConversationClosedStatusChanged(Conversation conversation, boolean isClosed)
Called to report that the closed state of the conversation has changed in response to a local or remote operation.- Parameters:
conversation- theConversationfor which the closed state has changed.isClosed- the new value of the isClosed flag.- See Also:
Conversation.isClosed()
-
onConversationMultiPartyStatusChanged
void onConversationMultiPartyStatusChanged(Conversation conversation, boolean isMultiParty)
Called to report that the isMultiparty state of the conversation has changed in response to new participants being added or existing participants being removed.- Parameters:
conversation- theConversationfor which the multi party state has changed.isMultiParty- the new value of the isMultiParty flag.- See Also:
Conversation.isMultiParty()
-
onConversationLastAccessTimeChanged
void onConversationLastAccessTimeChanged(Conversation conversation, java.util.Date time)
Called to report that the last accessed time of the conversation has changed in response to messages in the conversation being marked as read, or by an explicit invocation of theConversation.setLastAccessTime(MessagingCompletionHandler)method.- Parameters:
conversation- theConversationfor which the last accessed time has changed.time- the newDatetime.- See Also:
Conversation.getLastAccessedTime()
-
onConversationLastUpdatedTimeChanged
void onConversationLastUpdatedTimeChanged(Conversation conversation, java.util.Date time)
Called to report that the last updated time of the conversation has changed.- Parameters:
conversation- theConversationfor which the time has changed.time- the new time.- See Also:
Conversation.getLastUpdatedTime()
-
onConversationLatestEntryTimeChanged
void onConversationLatestEntryTimeChanged(Conversation conversation, java.util.Date time)
Called to report that the latest entry time of the conversation has changed in response to new messages being added to the conversation.- Parameters:
conversation- theConversationfor which the time has changed.time- the new time.- See Also:
Conversation.getLastEntryTime()
-
onConversationStatusChanged
void onConversationStatusChanged(Conversation conversation, ConversationStatus status)
Called to report that resource status of the conversation has changed.- Parameters:
conversation- theConversationfor which the status has changed.status- theConversationStatusnew value of the resource status.
-
onConversationPreviewTextChanged
void onConversationPreviewTextChanged(Conversation conversation, java.lang.String previewText)
Called to report that the preview text for the conversation has changed.- Parameters:
conversation- theConversationfor which the preview text changed.previewText- the new value of the preview text.
-
onConversationTotalMessageCountChanged
void onConversationTotalMessageCountChanged(Conversation conversation, int totalMsgCount)
Called to report that the total number of messages in the conversation has changed.- Parameters:
conversation- theConversationfor which the total number of messages have changed.totalMsgCount- the new value representing the total message count.- See Also:
Conversation.getTotalMessageCount()
-
onConversationTotalAttachmentCountChanged
void onConversationTotalAttachmentCountChanged(Conversation conversation, int totalAttachmentCount)
Called to report that the total number of attachments in the conversation has changed.- Parameters:
conversation- theConversationconversation for which the total number of attachment has changed.totalAttachmentCount- the new value representing the total attachment count.
-
onConversationTotalUnreadMessageCountChanged
void onConversationTotalUnreadMessageCountChanged(Conversation conversation, int totalUnreadMsgCount)
Called to report that the number of unread messages in the conversation has changed.- Parameters:
conversation- theConversationfor which the total number of unread messages have changed.totalUnreadMsgCount- the new value representing the unread message count.
-
onConversationTotalUnreadAttachmentCountChanged
void onConversationTotalUnreadAttachmentCountChanged(Conversation conversation, int totalUnreadAttachmentCount)
Called to report that total number of unread attachments in the conversation has changed.- Parameters:
conversation- theConversationconversation for which the total number of unread attachment has changed.totalUnreadAttachmentCount- the new value representing the unread attachment count.
-
onConversationSensitivityChanged
void onConversationSensitivityChanged(Conversation conversation, SensitivityLevel sensitivity)
Called to report that the sensitivity of the conversation has changed via either a local or remote operation.- Parameters:
conversation- theConversationfor which the sensitivity has changed.sensitivity- the new sensitivity's value.
-
onConversationSubjectChanged
void onConversationSubjectChanged(Conversation conversation, java.lang.String subject)
Called to report that the subject of the conversation has changed via either a local or remote operation.- Parameters:
conversation- theConversationfor which the subject has changed.subject- the new subject's value.
-
onConversationTypeChanged
void onConversationTypeChanged(Conversation conversation, ConversationType conversationType)
Called to report that the type of the conversation has changed. This is called when a user changes the conversation's type.- Parameters:
conversation- theConversationconversation for which the type has changed.conversationType- theConversationTypenew type's value.
-
onConversationMessagesAdded
void onConversationMessagesAdded(Conversation conversation, java.util.List<Message> messages)
Called to report that one or more messages have been added to the conversation.- Parameters:
conversation- theConversationfor which messages were added.messages- the list ofMessagenew messages which have been added.
-
onConversationMessagesRemoved
void onConversationMessagesRemoved(Conversation conversation, java.util.List<Message> messages)
Called to report that one or more messages have been removed from the conversation.- Parameters:
conversation- theConversationfor which the messages were removed.messages- the new messages which have been removed.
-
onConversationParticipantsAdded
void onConversationParticipantsAdded(Conversation conversation, java.util.List<MessagingParticipant> addedParticipants)
Called to report that one or more participants have been added to the conversation.- Parameters:
conversation- theConversationfor which the participants were added.addedParticipants- new list ofMessagingParticipantadded to conversation.
-
onConversationParticipantsRemoved
void onConversationParticipantsRemoved(Conversation conversation, java.util.List<MessagingParticipant> removedParticipants)
Called to report that one or more participants have been removed from the conversation.- Parameters:
conversation- theConversationfrom which the participants were removed.removedParticipants- the list ofMessagingParticipantdeleted from the conversation.
-
onConversationCapabilitiesChanged
void onConversationCapabilitiesChanged(Conversation conversation)
Called to report that one or more of the capabilities of the conversation has changed. The application should query each of the capabilities and enable/disable elements of the user interface based on the new capability settings. Capabilities can change as a result of local or remote actions.- Parameters:
conversation- theConversationconversation that the callback is associated with.- See Also:
Conversation.getUpdateSubjectCapability(),Conversation.getUpdateLastAccessTimeCapability(),Conversation.getUpdateSensitivityCapability(),Conversation.getUpdateTypeCapability(),Conversation.getOlderContentCapability(),Conversation.getAddParticipantsCapability(),Conversation.getRemoveParticipantsCapability(),Conversation.getCreateMessageCapability(),Conversation.getMarkAllContentAsReadCapability(),Conversation.getLeaveCapability(),Conversation.getStartCapability(),Conversation.getRemoveCapability()
-
-