org.jtoolkit.essence.utils
Interface Factory<D,E>

All Superinterfaces:

java.io.Closeable, Named

All Known Implementing Classes:

Factory.AbstractFactory

public interface Factory<D,E>
extends java.io.Closeable, Named

A factory interface which creates object based on a description. These object can be returned to the factory for recycling and disposal.

Author:

Peter Lawrey

Nested Class Summary

static class

Factory.AbstractFactory<D,E> Base class for factory implementations.

Nested classes/interfaces inherited from interface org.jtoolkit.essence.utils.Named

Named.ContextSource<T>, Named.MapSource<T>, Named.Source<T>

Method Summary

E	acquire(D description) Create or recycle an object suitable for the description.
void	release(E element) Release, recycle or dispose of an object this factory created.

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface org.jtoolkit.essence.utils.Named

getName

Method Detail

acquire

@NotNull
E acquire(D description)
          throws java.lang.InterruptedException

Create or recycle an object suitable for the description.

Throws:

java.lang.InterruptedException

release

void release(@Nullable
             E element)

Release, recycle or dispose of an object this factory created.