NativeHandle (Exonum Java Binding Parent 0.8.0 API)

java.lang.Object
- com.exonum.binding.core.proxy.NativeHandle

All Implemented Interfaces:

AutoCloseable
```
public final class NativeHandle
extends Object
implements AutoCloseable
```
An implementation-specific handle to the native object. Once closed, can no longer be accessed.

Field Summary

Fields
Modifier and Type Field Description

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

Constructor Summary

Constructors
Constructor Description

NativeHandle(long nativeHandle)
Creates new native handle.

Method Summary

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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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)
```
    Creates new native handle. Validates it's state not allowing to create nullptr handle.
    
    Throws:
    
    IllegalStateException - if this native handle is invalid (nullptr)
- 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:
    
    IllegalStateException - if this native handle is invalid (closed or nullptr)
  - close
```
public void close()
```
    Specified by:
    
    close in interface AutoCloseable
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object