org.jivesoftware.smack.debugger

Class SmackDebugger

java.lang.Object

org.jivesoftware.smack.debugger.SmackDebugger

Direct Known Subclasses:

AbstractDebugger, EnhancedDebugger, LiteDebugger, SLF4JSmackDebugger

public abstract class SmackDebugger
extends Object

Interface that allows for implementing classes to debug XML traffic. That is a GUI window that displays XML traffic.

Every implementation of this interface must have a public constructor with the following arguments: XMPPConnection, Writer, Reader.

Field Summary

Fields

Modifier and Type	Field and Description
protected XMPPConnection	connection

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SmackDebugger(XMPPConnection connection)

Method Summary

Modifier and Type	Method and Description
abstract Reader	newConnectionReader(Reader reader) Returns a new special Reader that wraps the new connection Reader.
abstract Writer	newConnectionWriter(Writer writer) Returns a new special Writer that wraps the new connection Writer.
abstract void	onIncomingStreamElement(TopLevelStreamElement streamElement) Used by the connection to notify about an incoming top level stream element.
abstract void	onOutgoingStreamElement(TopLevelStreamElement streamElement) Used by the connection to notify about a outgoing top level stream element.
abstract void	userHasLogged(EntityFullJid user) Called when a user has logged in to the server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

connection

protected final XMPPConnection connection

Constructor Detail

SmackDebugger

protected SmackDebugger(XMPPConnection connection)

Method Detail

userHasLogged

public abstract void userHasLogged(EntityFullJid user)

Called when a user has logged in to the server. The user could be an anonymous user, this means that the user would be of the form host/resource instead of the form user@host/resource.

Parameters:

user - the user@host/resource that has just logged in

newConnectionReader

public abstract Reader newConnectionReader(Reader reader)

Returns a new special Reader that wraps the new connection Reader. The connection has been secured so the connection is using a new reader and writer. The debugger needs to wrap the new reader and writer to keep being notified of the connection traffic.

Parameters:

reader - connection reader.

Returns:

a new special Reader that wraps the new connection Reader.

newConnectionWriter

public abstract Writer newConnectionWriter(Writer writer)

Returns a new special Writer that wraps the new connection Writer. The connection has been secured so the connection is using a new reader and writer. The debugger needs to wrap the new reader and writer to keep being notified of the connection traffic.

Parameters:

writer - connection writer.

Returns:

a new special Writer that wraps the new connection Writer.

onIncomingStreamElement

public abstract void onIncomingStreamElement(TopLevelStreamElement streamElement)

Used by the connection to notify about an incoming top level stream element.

This method is invoked right after the incoming stream was parsed.

Parameters:

streamElement - the incoming top level stream element.

onOutgoingStreamElement

public abstract void onOutgoingStreamElement(TopLevelStreamElement streamElement)

Used by the connection to notify about a outgoing top level stream element.

This method is invoked right before the element is serialized to XML and put into the outgoing stream.

Parameters:

streamElement - the outgoing top level stream element.