Top Description Inners Fields
com.sun.jna

public Interface Callback

Known Direct Subinterfaces
com.sun.jna.CallbackProxy, com.sun.jna.win32.DLLCallback, com.sun.jna.win32.StdCallLibrary.StdCallCallback
Imports
java.util.Arrays, .Collections, .List

All callback definitions must derive from this interface. Any derived interfaces must define a single public method (which may not be named "hashCode", "equals", or "toString"), or one public method named "callback". You are responsible for deregistering your callback (if necessary). If native code attempts to call a callback which has been GC'd, you will likely crash the VM. If there is no method to deregister the callback (e.g. atexit in the C library), you must ensure that you always keep a live reference to the callback object.

A callback should generally never throw an exception, since it doesn't necessarily have an encompassing Java environment to catch it. Any exceptions thrown will be passed to the default callback exception handler.

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static interface

Field Summary

Modifier and TypeField and Description
public static final List<String>
FORBIDDEN_NAMES

These method names may not be used for a callback method.

public static final String
METHOD_NAME

You must use this method name if your callback interface has multiple public methods.

Field Detail

FORBIDDEN_NAMESback to summary
public static final List<String> FORBIDDEN_NAMES

These method names may not be used for a callback method.

METHOD_NAMEback to summary
public static final String METHOD_NAME

You must use this method name if your callback interface has multiple public methods. Typically a callback will have only one such method, in which case any method name may be used, with the exception of those in FORBIDDEN_NAMES.

com.sun.jna back to summary

public Interface Callback.UncaughtExceptionHandler


Method Summary

Modifier and TypeMethod and Description
public void
uncaughtException(Callback c, Throwable e)

Method invoked when the given callback throws an uncaught exception.

Method Detail

uncaughtExceptionback to summary
public void uncaughtException(Callback c, Throwable e)

Method invoked when the given callback throws an uncaught exception.

Any exception thrown by this method will be ignored.