org.jacorb.orb

Interface IBufferManager

All Known Implementing Classes:

AbstractBufferManager, BufferManager, JDK15NonSyncBufferManager

public interface IBufferManager

A BufferManager is used to share a pool of buffers and to implement a buffer allocation policy. This reduces the number of memory allocations and deallocations and the overall memory footprint. Buffers are generally created on demand.

Author:

Gerald Brose

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	getBuffer(int size) getBuffer returns a new buffer.
byte[]	getExpandedBuffer(int requiredSize) getExpandedBuffer returns a new buffer which size will be calculated according to BufferManager expansion policy.
byte[]	getPreferredMemoryBuffer()
void	release() release all resources that are held by this buffer
void	returnBuffer(byte[] buf) equals returnBuffer(buffer, false)
void	returnBuffer(byte[] buffer, boolean cdrStr)

Method Detail

getPreferredMemoryBuffer

byte[] getPreferredMemoryBuffer()

Returns:

a buffer that has a pre-configured size

See Also:

getBuffer(int)

returnBuffer

void returnBuffer(byte[] buf)

equals returnBuffer(buffer, false)

See Also:

returnBuffer(byte[], boolean)

returnBuffer

void returnBuffer(byte[] buffer,
                boolean cdrStr)

Parameters:

buffer - a byte[] value

cdrStr - a boolean value value to denote if CDROuputStream is caller (may use cache in this situation)

getBuffer

byte[] getBuffer(int size)

getBuffer returns a new buffer.

Parameters:

size - an int value

Returns:

a byte[] value

getExpandedBuffer

byte[] getExpandedBuffer(int requiredSize)

getExpandedBuffer returns a new buffer which size will be calculated according to BufferManager expansion policy.

Parameters:

requiredSize - an int value

Returns:

a byte[] value

release

void release()

release all resources that are held by this buffer