com.microej.crypto.internal

Class NativeReference

java.lang.Object

com.microej.crypto.internal.NativeReference

public class NativeReference
extends Object

Manage the life cycle of a native resource ensuring it is closed when this is garbage collected. This class was introduced as a way to manage the native shared context between a NativePrivateKey and a NativePublicKey generated by a KeyPairGenerator. A NativeReference owns a native context paired with a native close function, so that the native context can be shared by multiple Java objects and be released only when this instance has been garbage collected. Warning: uses int to store native id compatible with legacy style llapi. To be updated to long, alongside llapi, for future compatibility with 64-bit platform.

Constructor Summary

Constructors

Constructor and Description
NativeReference(int nativeId, int closeId) Create a new NativeReference

Method Summary

Modifier and Type	Method and Description
int	getNativeId() Return a raw native id This method must only be used to pass the nativeId managed by this class to a native function.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeReference

public NativeReference(int nativeId,
                       int closeId)

Create a new NativeReference

Parameters:

nativeId - Identifier of the native context to be managed

closeId - Identifier of the native close function to call when this instance is garbage collected

Method Detail

getNativeId

public int getNativeId()

Return a raw native id This method must only be used to pass the nativeId managed by this class to a native function. You must never store the return value from this method to be reused in a different context, as there is no guarantee that the nativeId still exists

Returns:

a raw nativeId