com.exonum.binding.proxy

Class NativeHandle

java.lang.Object

com.exonum.binding.proxy.NativeHandle

All Implemented Interfaces:

java.lang.AutoCloseable

public final class NativeHandle
extends java.lang.Object
implements java.lang.AutoCloseable

An implementation-specific handle to the native object. Once closed, can no longer be accessed.

Field Summary

Fields

Modifier and Type	Field and Description
static long	INVALID_NATIVE_HANDLE A reserved value for an invalid native handle, equal to nullptr in C++.

Constructor Summary

Constructors

Constructor and Description
NativeHandle(long nativeHandle)

Method Summary

Modifier and Type	Method and Description
void	close()
long	get() Returns a native implementation-specific handle if it may be safely used to access the native object.

Methods inherited from class java.lang.Object

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

Field Detail

INVALID_NATIVE_HANDLE

public static final long INVALID_NATIVE_HANDLE

A reserved value for an invalid native handle, equal to nullptr in C++.

See Also:

Constant Field Values

Constructor Detail

NativeHandle

public NativeHandle(long nativeHandle)

Method Detail

get

public long get()

Returns a native implementation-specific handle if it may be safely used to access the native object.

The returned value shall only be passed as an argument to native methods.

Warning: do not cache the return value, as you won't be able to catch use-after-free.

Throws:

java.lang.IllegalStateException - if this native handle is invalid (closed or nullptr)

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable