Pool (TrueZIP Kernel 7.0-rc1 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

TrueZIP Kernel 7.0-rc1

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

de.schlichtherle.truezip.util
Interface Pool<R,E extends Exception>

All Known Implementing Classes:: ByteArrayIOPool, IOCache.InputBufferPool, IOCache.OutputBufferPool, IOCache.WriteBackOutputBufferPool, IOCache.WriteThroughOutputBufferPool

An interface for pooling strategies.

Implementations must be thread-safe. However, this does not necessarily apply to the implementation of its managed resources.

Nested Class Summary
`static interface`	`Pool.Releasable<E extends Exception>` This interface is designed to be used with Pools which enable their resources to release itself.

Method Summary
`R`	`allocate()` Allocates a resource from this pool.
`void`	`release(R resource)` Releases a previously allocated resource to this pool.

Method Detail

@NonNull
R allocate()
           throws E extends Exception

Allocates a resource from this pool.

void release(@NonNull
             R resource)
             throws E extends Exception

Releases a previously allocated resource to this pool. Implementations may throw an IllegalArgumentException or an IllegalStateException upon the conditions explained below.

Parameters:: resource - a resource.
Throws:: IllegalArgumentException - if the given resource has not been allocated by this pool and the implementation doesn't tolerate this.; IllegalStateException - if the given resource has already been released to this pool and the implementation doesn't tolerate this.; Exception - if releasing the resource failed for any other reason.