org.eclipse.jetty.util

Class CountingCallback

java.lang.Object

org.eclipse.jetty.util.CountingCallback

All Implemented Interfaces:

Callback

public class CountingCallback
extends Object
implements Callback

A callback wrapper that succeeds the wrapped callback when the count is reached, or on first failure.

This callback is particularly useful when an async operation is split into multiple parts, for example when an original byte buffer that needs to be written, along with a callback, is split into multiple byte buffers, since it allows the original callback to be wrapped and notified only when the last part has been processed.

Example:

 public void process(EndPoint endPoint, ByteBuffer buffer, Callback callback)
 {
     ByteBuffer[] buffers = split(buffer);
     CountCallback countCallback = new CountCallback(callback, buffers.length);
     endPoint.write(countCallback, buffers);
 }
 

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.Callback

Callback.Adapter

Constructor Summary

Constructors

Constructor and Description
CountingCallback(Callback callback, int count)

Method Summary

Methods

Modifier and Type	Method and Description
void	failed(Throwable failure) Callback invoked when the operation fails.
void	succeeded() Callback invoked when the operation completes.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

CountingCallback

public CountingCallback(Callback callback,
                int count)

Method Detail

succeeded

public void succeeded()

Description copied from interface: Callback

Callback invoked when the operation completes.

Specified by:

succeeded in interface Callback

See Also:

Callback.failed(Throwable)

failed

public void failed(Throwable failure)

Description copied from interface: Callback

Callback invoked when the operation fails.

Specified by:

failed in interface Callback

Parameters:

failure - the reason for the operation failure

toString

public String toString()

Overrides:

toString in class Object