Bug 37904

When the BoundedFIFO is full the AsynchAppender will wait for ever for the
Dispatcher to remove an element from the buffer. This might seem reasonable as
this will not happen very often, but the following problem occurred in our
production environment:

We wanted to send a mail for certain exceptions. However, the SMTP server was
incorrectly configured which caused the Dispatcher thread to hang for several
minutes for each event. The buffer quickly filled up and then the AsynchAppender
also waited several minutes until all exceptions had been processed.

This was quite difficult to debug since the server seemed to work fine and only
slowed down a while after the error occurred and the file logging worked fine.
We did not realize that the fact that we did not get the email was related to
the server slowing down or hanging. As the server only hang during a couple of
minutes it took a while until we managed to get a thread dump.

The purpose of using AsynchAppender is to avoid blocking the current thread,
therefore I think that the AsynchAppender should handle the buffer full
situation better.

Two different solution proposals:
1) Log something when the buffer is full. This will make this condition easier
to find and will probably only occur in exceptional cases.
2) Limit the time to wait on the buffer. Log and give up when this limit is
exceeded. This will have some extra overhead, but the server will not be blocked
because of incorrect configuration. The timeout should be possible to configure.  

1) Log something when the buffer is full:
      while (bf.isFull()) {
        try {
          LogLog.warn("AsynchAppender buffer is full!!");
          bf.wait();

2) Limit the time to wait on the buffer: 
      long before = System.currentTimeMillis();
      while (bf.isFull()) {
        try {
          //LogLog.debug("Waiting for free space in buffer, "+bf.length());
          bf.wait(this.bufferTimeout);
          if (System.currentTimeMillis()-before >= this.bufferTimeout) {
             LogLog.error("AsynchAppender failed to log event within specified
timeout. event=" + event);
	     return;
          }


(The same problem exists in 1.3)