Package com.rabbitmq.tools

Class Tracer

java.lang.Object

com.rabbitmq.tools.Tracer

All Implemented Interfaces:

Runnable

public class Tracer
extends Object
implements Runnable

AMQP Protocol Analyzer program. Listens on a port (in-port) and when a connection arrives, makes an outbound connection to a host and port (out-port). Relays frames from the in-port to the out-port. Commands are decoded and printed to a supplied Tracer.Logger.

The stand-alone program (main(String[])) prints to System.out, using a private Tracer.AsyncLogger instance. When the connection closes the program listens for a subsequent connection and traces that to the same Tracer.Logger. This continues until the program is interrupted.

Options for controlling, for example, whether command bodies are decoded, are obtained from System.properties, and are reported to the console before starting the trace.

A Tracer object may be instantiated, using one of the constructors

• Tracer(int listenPort, String id, String host, int port, Logger logger, Properties props)
• Tracer(String id)
• Tracer(String id, Properties props)

  where the missing parameters default as follows:

  • listenPort defaults to 5673
  • host defaults to localhost
  • port defaults to 5672
  • logger defaults to new AsyncLogger(System.out)
  and
  • props defaults to System.getProperties()

These constructors block waiting for a connection to arrive on the listenPort. Tracing does not begin until the tracer is start()ed which Tracer.Logger.start()s the supplied logger and creates and starts a Thread for relaying and deconstructing the frames.

The properties specified in props are used at start() time and may be modified before this call.

See Also:

• Tracer.Logger
• Tracer.AsyncLogger

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Tracer.AsyncLogger	A Tracer.Logger designed to print Strings to a designated OutputStream on a private thread.
static interface	Tracer.Logger	Logging strings to an outputStream.

Constructor Summary

Constructors

Constructor	Description
Tracer(int listenPort, String id, String host, int port, Tracer.Logger logger, Properties props)
Tracer(String id)
Tracer(String id, Properties props)

Method Summary

Modifier and Type	Method	Description
void	log(String message)
void	logException(Exception e)
static void	main(String[] args)
void	run()
void	start()

Methods inherited from class java.lang.Object

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

Constructor Details

Tracer

public Tracer(int listenPort,
 String id,
 String host,
 int port,
 Tracer.Logger logger,
 Properties props)
       throws IOException

Throws:

IOException

Tracer

public Tracer(String id)
       throws IOException

Throws:

IOException

Tracer

public Tracer(String id,
 Properties props)
       throws IOException

Throws:

IOException

Method Details

main

public static void main(String[] args)

start

public void start()

run

public void run()

Specified by:

run in interface Runnable

log

public void log(String message)

logException

public void logException(Exception e)