Package rocks.xmpp.core.session.debug

Interface XmppDebugger

All Superinterfaces:

ReaderInterceptor, WriterInterceptor

All Known Implementing Classes:

ConsoleDebugger

public interface XmppDebugger
extends ReaderInterceptor, WriterInterceptor

A debugger interface, which allows to implement custom debugger implementation to log XMPP traffic.

Method Summary

Modifier and Type	Method	Description
InputStream	createInputStream(InputStream inputStream)	Creates a new input stream from the actual input stream.
OutputStream	createOutputStream(OutputStream outputStream)	Creates a new output stream from the actual output stream.
void	initialize(XmppSession xmppSession)	This method is called when a new XMPP session is initialized.
default void	process(Reader reader, Consumer<StreamElement> streamElement, ReaderInterceptorChain chain)
default void	process(StreamElement streamElement, Writer writer, WriterInterceptorChain chain)
void	readStanza(String xml, Object streamElement)	This method is called, whenever a stream element is read.
void	writeStanza(String xml, Object streamElement)	This method is called, whenever a stream element is written.

Method Detail

initialize

void initialize(XmppSession xmppSession)

This method is called when a new XMPP session is initialized.

Parameters:

xmppSession - The XMPP session.

writeStanza

void writeStanza(String xml,
                 Object streamElement)

This method is called, whenever a stream element is written.

Parameters:

xml - The xml representation of the stream element.

streamElement - The stream element. Maybe null, if no stream element, but an opening or closing stream element is written.

readStanza

void readStanza(String xml,
                Object streamElement)

This method is called, whenever a stream element is read.

Parameters:

xml - The xml representation of the stream element.

streamElement - The stream element. Maybe null, if no stream element, but an opening or closing stream element is read.

createOutputStream

OutputStream createOutputStream(OutputStream outputStream)

Creates a new output stream from the actual output stream. This is useful is you want to log the actually written bytes. In this case you could fork the output stream and return the new forked stream.

Parameters:

outputStream - The actual output stream.

Returns:

The (forked) output stream.

createInputStream

InputStream createInputStream(InputStream inputStream)

Creates a new input stream from the actual input stream. This is useful is you want to log the actually read bytes. In this case you could fork the input stream and return the new forked stream.

Parameters:

inputStream - The actual input stream.

Returns:

The (forked) input stream.

process

default void process(StreamElement streamElement,
                     Writer writer,
                     WriterInterceptorChain chain)
              throws Exception

Specified by:

process in interface WriterInterceptor

Throws:

Exception

process

default void process(Reader reader,
                     Consumer<StreamElement> streamElement,
                     ReaderInterceptorChain chain)
              throws Exception

Specified by:

process in interface ReaderInterceptor

Throws:

Exception