org.jsfml.internal

Class NativeRef<T>

java.lang.Object

org.jsfml.internal.NativeRef<T>

Type Parameters:

T - The type of the related Java object, if any.

Direct Known Subclasses:

SFMLInputStream.NativeStreamRef

public abstract class NativeRef<T>
extends Object

Helper class for managing Java object references and related native pointers.

Constructor Summary

Constructors

Constructor and Description
NativeRef() Constructs a native reference.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	finalize()
boolean	hasNonZeroPointer() Tests whether this reference has a non-zero native pointer.
void	initialize(T ref) Initializes a native reference with the specified Java object.
protected abstract long	nativeInitialize(T ref) Initializes a native pointer related to the specified Java object.
protected abstract void	nativeRelease(T ref, long ptr) Releases the Java reference, if any, and the managed native pointer, if any.
void	release() Releases the managed Java reference, if any, and frees the managed native pointer, if any, including freeing any natively allocated memory.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeRef

public NativeRef()

Constructs a native reference.

Method Detail

nativeInitialize

protected abstract long nativeInitialize(T ref)

Initializes a native pointer related to the specified Java object.

Parameters:

ref - the related Java object, or null if there is none.

Returns:

a native pointer, or 0 if none was initialized.

nativeRelease

protected abstract void nativeRelease(T ref,
                 long ptr)

Releases the Java reference, if any, and the managed native pointer, if any.

This also is responsible for natively allocated memory being freed.

Parameters:

ref - the Java object reference, or null if there is none.

ptr - the native pointer, if any.

initialize

public void initialize(T ref)

Initializes a native reference with the specified Java object.

Parameters:

ref - the Java object, or null if none is required.

release

public void release()

Releases the managed Java reference, if any, and frees the managed native pointer, if any, including freeing any natively allocated memory.

hasNonZeroPointer

public boolean hasNonZeroPointer()

Tests whether this reference has a non-zero native pointer.

Returns:

true if the pointer is non-zero, false if it is NULL.

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable