org.erights.e.develop.trace
Interface TraceMessageAcceptor

All Known Implementing Classes:

TraceBuffer, TraceLog

interface TraceMessageAcceptor

Method Summary

void	accept(TraceMessage message) Accept a message and do whatever is appropriate to make it visible to a user, either now or later.
void	setupIsComplete() After this call, the TraceMessageAcceptor must obey settings from the environment.

Method Detail

accept

public void accept(TraceMessage message)

Accept a message and do whatever is appropriate to make it visible to a user, either now or later.

Note that this method should be called AFTER the message passes a priority threshold check. MessageAcceptors don't know about priorities.

The TraceMessageAcceptor is allowed to unilaterally discard the message. Generally, this is done only if it was turned off by another thread.

setupIsComplete

public void setupIsComplete()

After this call, the TraceMessageAcceptor must obey settings from the environment. Before this call, it must defer taking any visible action, because it can't yet know what action is appropriate. Note that the message acceptor may (is encouraged to) accept messages before setup is complete, because some of those trace messages might be useful.

It is an error to call this method more than once.