org.freedesktop.gstreamer.glib

Class GObject.Handle

java.lang.Object

org.freedesktop.gstreamer.glib.NativeObject.Handle

org.freedesktop.gstreamer.glib.RefCountedObject.Handle

org.freedesktop.gstreamer.glib.GObject.Handle

Direct Known Subclasses:

GstObject.Handle

Enclosing class:

GObject

protected static class GObject.Handle
extends RefCountedObject.Handle

Constructor Summary

Constructors

Constructor and Description
Handle(org.freedesktop.gstreamer.lowlevel.GObjectPtr ptr, boolean ownsHandle)

Method Summary

Modifier and Type	Method and Description
void	dispose() Dispose the handle, and dispose the native reference if owned by this handle.
protected void	disposeNativeHandle(org.freedesktop.gstreamer.lowlevel.GPointer ptr) Subclasses should override this method to dispose of the native reference (free, unref, etc.).
protected org.freedesktop.gstreamer.lowlevel.GObjectPtr	getPointer() Get the native pointer, or null.
void	invalidate() Invalidate the handle.
protected void	ref()
protected void	sink() Sink floating reference.
String	toString()
protected void	unref()

Methods inherited from class org.freedesktop.gstreamer.glib.NativeObject.Handle

disown, isCacheable, ownsReference

Methods inherited from class java.lang.Object

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

Constructor Detail

Handle

public Handle(org.freedesktop.gstreamer.lowlevel.GObjectPtr ptr,
              boolean ownsHandle)

Method Detail

invalidate

public void invalidate()

Description copied from class: NativeObject.Handle

Invalidate the handle. After calling this method, NativeObject.Handle.getPointer() will return null, NativeObject.Handle.ownsReference() will return false, and any NativeObject weak reference cached for this pointer will be removed. Unlike calling NativeObject.Handle.dispose() the native handle will not be disposed - NativeObject.Handle.disposeNativeHandle(org.freedesktop.gstreamer.lowlevel.GPointer) will not be called.

Overrides:

invalidate in class NativeObject.Handle

dispose

public void dispose()

Description copied from class: NativeObject.Handle

Dispose the handle, and dispose the native reference if owned by this handle. After calling this method, NativeObject.Handle.getPointer() will return null, NativeObject.Handle.ownsReference() will return false, and any NativeObject weak reference cached for this pointer will be removed.

Overrides:

dispose in class NativeObject.Handle

disposeNativeHandle

protected void disposeNativeHandle(org.freedesktop.gstreamer.lowlevel.GPointer ptr)

Description copied from class: NativeObject.Handle

Subclasses should override this method to dispose of the native reference (free, unref, etc.). The pointer supplied should be used - NativeObject.Handle.getPointer() will return null by the time this method is called.

Specified by:

disposeNativeHandle in class NativeObject.Handle

Parameters:

ptr - native reference

ref

protected void ref()

Specified by:

ref in class RefCountedObject.Handle

sink

protected void sink()

Sink floating reference. This will turn a floating reference into a real one.

unref

protected void unref()

Specified by:

unref in class RefCountedObject.Handle

getPointer

protected org.freedesktop.gstreamer.lowlevel.GObjectPtr getPointer()

Description copied from class: NativeObject.Handle

Get the native pointer, or null. Subclasses may override to return a GPointer subclass.

Overrides:

getPointer in class NativeObject.Handle

Returns:

native pointer or null

toString

public String toString()

Overrides:

toString in class Object