ibis.constellation.util

Interface ByteBuffers

public interface ByteBuffers

When an object implements this interface, it is assumed to contain ByteBuffers, which are not Serializable, but may need to be passed on to another node anyway. The methods in this interface allow the object to either pass on its byte buffers to the layer below, or to obtain its byte buffers from the layer below. This mechanism may also provide a fast path for direct byte buffers. Constellation enables this interface for events and activities. When constellation serializes an event or activity, after serialization it will call pushByteBuffers(List) to obtain any ByteBuffers to be transferred, and transfer them. On the other side, it will, after deserialization, call popByteBuffers(List) to pop the corresponding ByteBuffers from the list.

Method Summary

Modifier and Type	Method and Description
void	popByteBuffers(java.util.List<java.nio.ByteBuffer> list) Handle for passing on byte buffers to the object.
void	pushByteBuffers(java.util.List<java.nio.ByteBuffer> list) Handle for obtaining the byte buffers from the object.

Method Detail

pushByteBuffers

void pushByteBuffers(java.util.List<java.nio.ByteBuffer> list)

Handle for obtaining the byte buffers from the object. When called, the object is supposed to add its ByteBuffers to the list. When this method gets called, the object is supposed to have been serialized already. Note: an application is not supposed to call this method. Constellation is responsible for that.

Parameters:

list - the list to add byte buffers to.

popByteBuffers

void popByteBuffers(java.util.List<java.nio.ByteBuffer> list)

Handle for passing on byte buffers to the object. The object may use the byte buffers in the list directly, i.e. it does not have to copy them. ByteBuffers should be removed from the head of the list. When this method gets called, the serializable data of the object is supposed to have been read already. Note: an application is not supposed to call this method. Constellation is responsible for that.

Parameters:

list - the list to obtain buffers from.