Modifier and Type	Class and Description
private static class	ClosurePool.Handle Manages the lifecycle of a native closure.
private static class	ClosurePool.Magazine
private static class	ClosurePool.MagazineHolder
pack-priv static class	ClosurePool.Proxy This is a proxy passed to the native code, to be called by the native trampoline code.

Modifier and Type	Field and Description
private final CallContext	callContext
private final ConcurrentLinkedQueue<ClosurePool.Handle>	freeQueue
private final Set<ClosurePool.Magazine>	magazines
private static final Closure	NULL_CLOSURE
private final ConcurrentLinkedQueue<ClosurePool.Handle>	partialQueue

Access	Constructor and Description
pack-priv	ClosurePool(CallContext callContext)

Modifier and Type	Method and Description
private ClosurePool.Handle	allocateNewHandle()
public Closure.Handle	newClosureHandle(Closure closure)
pack-priv synchronized void	recycle(ClosurePool.Magazine magazine)
pack-priv void	recycle(ClosurePool.Magazine.Slot slot, ClosurePool.MagazineHolder holder)
private void	useMagazine(ClosurePool.Magazine m)

callContext	back to summary
private final CallContext callContext

freeQueue	back to summary
private final ConcurrentLinkedQueue<ClosurePool.Handle> freeQueue

magazines	back to summary
private final Set<ClosurePool.Magazine> magazines

NULL_CLOSURE	back to summary
private static final Closure NULL_CLOSURE

partialQueue	back to summary
private final ConcurrentLinkedQueue<ClosurePool.Handle> partialQueue

ClosurePool	back to summary
pack-priv ClosurePool(CallContext callContext)

allocateNewHandle	back to summary
private ClosurePool.Handle allocateNewHandle()

newClosureHandle	back to summary
public Closure.Handle newClosureHandle(Closure closure)

recycle	back to summary
pack-priv synchronized void recycle(ClosurePool.Magazine magazine)

recycle	back to summary
pack-priv void recycle(ClosurePool.Magazine.Slot slot, ClosurePool.MagazineHolder holder)

useMagazine	back to summary
private void useMagazine(ClosurePool.Magazine m)

private final Class ClosurePool.Handle

Class Inheritance

extends Object
implements Handle

java.lang.Object
com.kenai.jffi.ClosurePool.Handle

All Implemented Interfaces

com.kenai.jffi.Closure.Handle

Manages the lifecycle of a native closure. Implements Closure.Handle interface.

Field Summary

Modifier and Type	Field and Description
private volatile boolean	disposed
pack-priv final ClosurePool.MagazineHolder	holder Keep references to the closure pool so it does not get garbage collected until all closures using it do.
pack-priv final ClosurePool.Magazine.Slot	slot

Constructor Summary

Access	Constructor and Description
pack-priv	Handle(ClosurePool.Magazine.Slot THe magazine slot this handle belongs to slot, ClosurePool.MagazineHolder The magazine holder containing this handle holder) Creates a new Handle to lifecycle manager the native closure.

Method Summary

Modifier and Type	Method and Description
public synchronized void	dispose() Implements com.kenai.jffi.Closure.Handle.dispose. Releases the closure memory back to the operating system.
public void	free() Implements com.kenai.jffi.Closure.Handle.free. Deprecated
public long	getAddress() Implements com.kenai.jffi.Closure.Handle.getAddress. Gets the native code address of the closure.
public void	setAutoRelease(boolean If true, the closure memory is automatically managed, else the closure memory must be explicitly freed. autorelease) Implements com.kenai.jffi.Closure.Handle.setAutoRelease. Sets whether the closure memory should be released when the `Handle` is garbage collected or not.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

disposed	back to summary
private volatile boolean disposed

holder	back to summary
pack-priv final ClosurePool.MagazineHolder holder Keep references to the closure pool so it does not get garbage collected until all closures using it do.

slot	back to summary
pack-priv final ClosurePool.Magazine.Slot slot

Constructor Detail

Handle	back to summary
pack-priv Handle(ClosurePool.Magazine.Slot slot, ClosurePool.MagazineHolder holder) Creates a new Handle to lifecycle manager the native closure. Parameters slot:ClosurePool.Magazine.Slot THe magazine slot this handle belongs to holder:ClosurePool.MagazineHolder The magazine holder containing this handle

Handle

back to summary

pack-priv Handle(ClosurePool.Magazine.Slot slot, ClosurePool.MagazineHolder holder)

Creates a new Handle to lifecycle manager the native closure.

Parameters

slot:ClosurePool.Magazine.Slot: THe magazine slot this handle belongs to
holder:ClosurePool.MagazineHolder: The magazine holder containing this handle

Method Detail

dispose back to summary

dispose	back to summary
public synchronized void dispose() Implements com.kenai.jffi.Closure.Handle.dispose. Doc from com.kenai.jffi.Closure.Handle.dispose. Releases the closure memory back to the operating system. Although the closure trampoline memory will normally be released when the `Handle` is garbage collected, this may not happen for some time, and is non-deterministic. This allows explicit control over memory reclamation.

public synchronized void dispose()

Implements com.kenai.jffi.Closure.Handle.dispose.

Doc from com.kenai.jffi.Closure.Handle.dispose.

Releases the closure memory back to the operating system. Although the closure trampoline memory will normally be released when the Handle is garbage collected, this may not happen for some time, and is non-deterministic. This allows explicit control over memory reclamation.

free	back to summary
public void free() Implements com.kenai.jffi.Closure.Handle.free. Deprecated Annotations @Deprecated

free

back to summary

public void free()

Implements com.kenai.jffi.Closure.Handle.free.

Deprecated

Annotations

@Deprecated

getAddress	back to summary
public long getAddress() Implements com.kenai.jffi.Closure.Handle.getAddress. Doc from com.kenai.jffi.Closure.Handle.getAddress. Gets the native code address of the closure. This can be passed into a native function that takes a function pointer. Returns:long The native address of the closure code.

getAddress

back to summary

public long getAddress()

Implements com.kenai.jffi.Closure.Handle.getAddress.

Doc from com.kenai.jffi.Closure.Handle.getAddress.

Gets the native code address of the closure. This can be passed into a native function that takes a function pointer.

Returns:long: The native address of the closure code.

setAutoRelease back to summary

setAutoRelease	back to summary
public void setAutoRelease(boolean autorelease) Implements com.kenai.jffi.Closure.Handle.setAutoRelease. Doc from com.kenai.jffi.Closure.Handle.setAutoRelease. Sets whether the closure memory should be released when the `Handle` is garbage collected or not. Parameters autorelease:boolean If true, the closure memory is automatically managed, else the closure memory must be explicitly freed.

public void setAutoRelease(boolean autorelease)

Implements com.kenai.jffi.Closure.Handle.setAutoRelease.

Doc from com.kenai.jffi.Closure.Handle.setAutoRelease.

Sets whether the closure memory should be released when the Handle is garbage collected or not.

Parameters

autorelease:boolean: If true, the closure memory is automatically managed, else the closure memory must be explicitly freed.

com.kenai.jffi back to summary

private final Class ClosurePool.Magazine

Class Inheritance

extends Object

java.lang.Object
com.kenai.jffi.ClosurePool.Magazine

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	ClosurePool.Magazine.Slot

Field Summary

Modifier and Type	Field and Description
private final CallContext	ctx
private final Foreign	foreign A handle to the foreign interface to keep it alive as long as this object is alive
private int	freeCount
private static final MemoryIO	IO Store a reference to the MemoryIO accessor here for easy access
private final long	magazine
private int	next
private final ClosurePool.Magazine.Slot[]	slots

Constructor Summary

Access	Constructor and Description
pack-priv	Magazine(CallContext ctx)

Method Summary

Modifier and Type	Method and Description
protected void	finalize() Overrides java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
pack-priv ClosurePool.Magazine.Slot	get()
pack-priv boolean	isEmpty()
pack-priv boolean	isFull()
pack-priv void	recycle()

Inherited from java.lang.Object:: clone equals getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ctx	back to summary
private final CallContext ctx

foreign	back to summary
private final Foreign foreign A handle to the foreign interface to keep it alive as long as this object is alive Annotations @SuppressWarnings:FieldCanBeLocal, UnusedDeclaration

freeCount	back to summary
private int freeCount

IO	back to summary
private static final MemoryIO IO Store a reference to the MemoryIO accessor here for easy access

magazine	back to summary
private final long magazine

next	back to summary
private int next

slots	back to summary
private final ClosurePool.Magazine.Slot[] slots

Constructor Detail

Magazine	back to summary
pack-priv Magazine(CallContext ctx)

Method Detail

finalize back to summary

finalize	back to summary
protected void finalize() throws Throwable Overrides java.lang.Object.finalize. Doc from java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the `finalize` method to dispose of system resources or to perform other cleanup. When running in a Java virtual machine in which finalization has been disabled or removed, the garbage collector will never call `finalize()`. In a Java virtual machine in which finalization is enabled, the garbage collector might call `finalize` only after an indefinite delay. The general contract of `finalize` is that it is invoked if and when the Java virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The `finalize` method may take any action, including making this object available again to other threads; the usual purpose of `finalize`, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded. The `finalize` method of class `Object` performs no special action; it simply returns normally. Subclasses of `Object` may override this definition. The Java programming language does not guarantee which thread will invoke the `finalize` method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates. After the `finalize` method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded. The `finalize` method is never invoked more than once by a Java virtual machine for any given object. Any exception thrown by the `finalize` method causes the finalization of this object to be halted, but is otherwise ignored. Annotations @Override Exceptions Throwable: the `Exception` raised by this method

protected void finalize() throws Throwable

Overrides java.lang.Object.finalize.

Doc from java.lang.Object.finalize.

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

When running in a Java virtual machine in which finalization has been disabled or removed, the garbage collector will never call finalize(). In a Java virtual machine in which finalization is enabled, the garbage collector might call finalize only after an indefinite delay.

The general contract of finalize is that it is invoked if and when the Java virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.

The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.

The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.

After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.

The finalize method is never invoked more than once by a Java virtual machine for any given object.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

Annotations

@Override

Exceptions

Throwable:: the Exception raised by this method

get	back to summary
pack-priv ClosurePool.Magazine.Slot get()

isEmpty	back to summary
pack-priv boolean isEmpty()

isFull	back to summary
pack-priv boolean isFull()

recycle	back to summary
pack-priv void recycle()

com.kenai.jffi back to summary

pack-priv final Class ClosurePool.Magazine.Slot

Class Inheritance

extends Object

java.lang.Object
com.kenai.jffi.ClosurePool.Magazine.Slot

Field Summary

Modifier and Type	Field and Description
pack-priv volatile boolean	autorelease
pack-priv final long	codeAddress The code trampoline address
pack-priv final long	handle The address of the native closure structure Note This is NOT the code address, but a pointer to the structure which contains the code address.
pack-priv final ClosurePool.Proxy	proxy

Constructor Summary

Access	Constructor and Description
public	Slot(long handle, ClosurePool.Proxy proxy)

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

autorelease	back to summary
pack-priv volatile boolean autorelease

codeAddress	back to summary
pack-priv final long codeAddress The code trampoline address

handle	back to summary
pack-priv final long handle The address of the native closure structure Note This is NOT the code address, but a pointer to the structure which contains the code address.

proxy	back to summary
pack-priv final ClosurePool.Proxy proxy

Constructor Detail

Slot	back to summary
public Slot(long handle, ClosurePool.Proxy proxy)

com.kenai.jffi back to summary

private final Class ClosurePool.MagazineHolder

Class Inheritance

extends Object

java.lang.Object
com.kenai.jffi.ClosurePool.MagazineHolder

Field Summary

Modifier and Type	Field and Description
pack-priv final ClosurePool.Magazine	magazine
pack-priv final ClosurePool	pool

Constructor Summary

Access	Constructor and Description
public	MagazineHolder(ClosurePool pool, ClosurePool.Magazine magazine)

Method Summary

Modifier and Type	Method and Description
protected void	finalize() Overrides java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

Inherited from java.lang.Object:: clone equals getClass hashCode notify notifyAll toString wait wait wait

Field Detail

magazine	back to summary
pack-priv final ClosurePool.Magazine magazine

pool	back to summary
pack-priv final ClosurePool pool

Constructor Detail

MagazineHolder	back to summary
public MagazineHolder(ClosurePool pool, ClosurePool.Magazine magazine)