org.apache.commons.collections.buffer
Class SynchronizedBuffer

java.lang.Object
  |
  +--org.apache.commons.collections.collection.SynchronizedCollection
        |
        +--org.apache.commons.collections.buffer.SynchronizedBuffer

All Implemented Interfaces:

Buffer, java.util.Collection, java.io.Serializable

Direct Known Subclasses:

BlockingBuffer

public class SynchronizedBuffer

extends SynchronizedCollection

implements Buffer

Decorates another Buffer to synchronize its behaviour for a multi-threaded environment.

Methods are synchronized, then forwarded to the decorated buffer.

This class is Serializable from Commons Collections 3.1.

Since:

Commons Collections 3.0

Version:

$Revision: 1.6 $ $Date: 2004/06/03 22:02:13 $

Author:

Stephen Colebourne

See Also:

Serialized Form

Method Summary

static Buffer	decorate(Buffer buffer) Factory method to create a synchronized buffer.
java.lang.Object	get() Gets the next object from the buffer without removing it.
java.lang.Object	remove() Gets and removes the next object from the buffer.

Methods inherited from class org.apache.commons.collections.collection.SynchronizedCollection

add, addAll, clear, contains, containsAll, decorate, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Method Detail

decorate

public static Buffer decorate(Buffer buffer)

Factory method to create a synchronized buffer.

Parameters:

buffer - the buffer to decorate, must not be null

Returns:

a new synchronized Buffer

Throws:

java.lang.IllegalArgumentException - if buffer is null

get

public java.lang.Object get()

Description copied from interface: Buffer

Gets the next object from the buffer without removing it.

Specified by:

get in interface Buffer

Returns:

the next object in the buffer, which is not removed

remove

public java.lang.Object remove()

Description copied from interface: Buffer

Gets and removes the next object from the buffer.

Specified by:

remove in interface Buffer

Returns:

the next object in the buffer, which is also removed