org.lsst.ccs.subsystem.demo.jni

Class DemoCallbackNoUserData

java.lang.Object

org.lsst.ccs.subsystem.demo.jni.DemoCallbackNoUserData

public class DemoCallbackNoUserData
extends Object

Demo of a jni interface to an asynchronous native service, that is NOT able to preserve some user data between the call and the call back.

Author:

aubourg

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DemoCallbackNoUserData.CallbackListener Callback listener called after completion of the native API function.
static class	DemoCallbackNoUserData.ReturnData

Constructor Summary

Constructors

Constructor and Description
DemoCallbackNoUserData()

Method Summary

Modifier and Type	Method and Description
static void	callNative(long minDelay, long maxDelay, DemoCallbackNoUserData.ReturnData returnData, DemoCallbackNoUserData.CallbackListener listener) Native call to the sample API.
static DemoCallbackNoUserData.ReturnData	callSync(long minDelay, long maxDelay) Synchronous adapter to the external API
static void	clearCallBack() to be used in case of timeout.
static void	main(String[] args)

Methods inherited from class java.lang.Object

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

Constructor Detail

DemoCallbackNoUserData

public DemoCallbackNoUserData()

Method Detail

callNative

public static void callNative(long minDelay,
                              long maxDelay,
                              DemoCallbackNoUserData.ReturnData returnData,
                              DemoCallbackNoUserData.CallbackListener listener)

Native call to the sample API. the synchronization is needed because of the global data structure in C code

Parameters:

minDelay - min sleep time in ms

maxDelay - max sleep time in ms

returnData - value returned by external API (which happens to be twice the sleep time. Content will be filled at the time listener is called

listener - the java listener that will be called upon completion

clearCallBack

public static void clearCallBack()

to be used in case of timeout. Native call is not reentrant.

callSync

public static DemoCallbackNoUserData.ReturnData callSync(long minDelay,
                                                         long maxDelay)

Synchronous adapter to the external API

Parameters:

minDelay - min sleep delay

maxDelay - max sleep delay

Returns:

the data returned by the API, the function will wait until the API signals the operation is complete and will recover and return the result.

main

public static void main(String[] args)