com.sun.jna

Class CallbackReference

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.WeakReference<Callback>

com.sun.jna.CallbackReference

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class CallbackReference
extends java.lang.ref.WeakReference<Callback>
implements java.io.Closeable

Provides a reference to an association between a native callback closure and a Java Callback closure.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	CallbackReference.AttachOptions

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static java.util.Map<java.lang.Object,java.lang.Object>	allocations
(package private) static java.util.Map<Callback,CallbackReference>	callbackMap
(package private) int	callingConvention
(package private) Pointer	cbstruct
(package private) Cleaner.Cleanable	cleanable
(package private) static java.util.Map<Callback,CallbackReference>	directCallbackMap
(package private) java.lang.reflect.Method	method
(package private) static java.util.Map<Pointer,java.lang.ref.Reference<Callback>[]>	pointerCallbackMap
(package private) CallbackProxy	proxy
(package private) Pointer	trampoline

Method Summary

Modifier and Type	Method and Description
void	close() Free native resources associated with this callback.
protected void	dispose() Deprecated.
(package private) static void	disposeAll() Dispose of all memory allocated for callbacks.
(package private) static java.lang.Class<?>	findCallbackClass(java.lang.Class<?> type)
static Callback	getCallback(java.lang.Class<?> type, Pointer p) Return a Callback associated with the given function pointer.
static Pointer	getFunctionPointer(Callback cb) Return a Pointer to the native function address for the given callback.
Pointer	getTrampoline() Obtain a pointer to the native glue code for this callback.
(package private) static CallbackThreadInitializer	setCallbackThreadInitializer(Callback cb, CallbackThreadInitializer initializer)

Methods inherited from class java.lang.ref.Reference

clear, enqueue, get, isEnqueued

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

callbackMap

static final java.util.Map<Callback,CallbackReference> callbackMap

directCallbackMap

static final java.util.Map<Callback,CallbackReference> directCallbackMap

pointerCallbackMap

static final java.util.Map<Pointer,java.lang.ref.Reference<Callback>[]> pointerCallbackMap

allocations

static final java.util.Map<java.lang.Object,java.lang.Object> allocations

cleanable

Cleaner.Cleanable cleanable

cbstruct

Pointer cbstruct

trampoline

Pointer trampoline

proxy

CallbackProxy proxy

method

java.lang.reflect.Method method

callingConvention

int callingConvention

Method Detail

setCallbackThreadInitializer

static CallbackThreadInitializer setCallbackThreadInitializer(Callback cb,
                                                              CallbackThreadInitializer initializer)

Parameters:

cb - The Callback instance

initializer - The CallbackThreadInitializer - if null then the associated initializer instance is removed

Returns:

The previous initializer instance (may be null)

getCallback

public static Callback getCallback(java.lang.Class<?> type,
                                   Pointer p)

Return a Callback associated with the given function pointer. If the pointer refers to a Java callback trampoline, return the original Java Callback. Otherwise, return a proxy to the native function pointer.

Throws:

java.lang.IllegalStateException - if the given pointer has already been mapped to a callback of a different type.

findCallbackClass

static java.lang.Class<?> findCallbackClass(java.lang.Class<?> type)

getTrampoline

public Pointer getTrampoline()

Obtain a pointer to the native glue code for this callback.

close

public void close()

Free native resources associated with this callback.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

dispose

@Deprecated
protected void dispose()

Deprecated.

disposeAll

static void disposeAll()

Dispose of all memory allocated for callbacks.

getFunctionPointer

public static Pointer getFunctionPointer(Callback cb)

Return a Pointer to the native function address for the given callback.