Package org.dellroad.msrp

Interface SessionListener

public interface SessionListener

Callback interface for MSRP Sessions.

Method Summary

Modifier and Type	Method	Description
void	sessionClosed(Session session, Exception cause)	Notification that a Session has been closed or failed due to an error.
void	sessionReceivedMessage(Session session, List<MsrpUri> fromPath, String messageId, byte[] content, String contentType, SortedSet<Header> headers, boolean successReport, boolean failureReport)	Notification that an MSRP message has been received in a session.

Method Detail

sessionClosed

void sessionClosed(Session session,
                   Exception cause)

Notification that a Session has been closed or failed due to an error.

Parameters:

session - the session that closed

cause - the error that occurred, or null if the session was closed manually by the application

sessionReceivedMessage

void sessionReceivedMessage(Session session,
                            List<MsrpUri> fromPath,
                            String messageId,
                            byte[] content,
                            String contentType,
                            SortedSet<Header> headers,
                            boolean successReport,
                            boolean failureReport)

Notification that an MSRP message has been received in a session.

Note that this method is responsible for (eventually) triggering a success or failure report depending on successReport and/or failureReport.

Parameters:

session - the session on which the message was received

fromPath - the path that the message took to get here

messageId - sender's unique ID for this message

content - message content, or null if message contained no content

contentType - message content type, or null if message contained no content

headers - other headers (including any MIME headers) sorted by name

successReport - whether a success report is requested by the sender

failureReport - whether a failure report is requested by the sender

See Also:

Session.sendSuccessReport(), Session.sendFailureReport()