org.robovm.objc

Class ObjCObject

java.lang.Object

org.robovm.rt.bro.NativeObject

org.robovm.objc.ObjCObject

Direct Known Subclasses:

ObjCClass

public abstract class ObjCObject
extends NativeObject

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ObjCObject.Marshaler
static class	ObjCObject.ObjCObjectPtr
static class	ObjCObject.Super

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	customClass

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ObjCObject()
protected	ObjCObject(long handle)

Method Summary

Modifier and Type	Method and Description
<T> T	addStrongRef(T to)
protected void	afterMarshaled(int flags)
protected long	alloc()
void	dispose()
protected void	dispose(boolean finalizing)
protected void	doDispose()
protected void	finalize()
Object	getAssociatedObject(Object key)
ObjCClass	getObjCClass()
protected ObjCSuper	getSuper()
protected void	initObject(long handle)
static void	logRetainRelease(boolean enabled) Sets whether retain/release of custom ObjCObject should be logged to the console to identify retain/release leaks.
void	removeStrongRef(Object to)
void	setAssociatedObject(Object key, Object value)
static <T extends ObjCObject> T	toObjCObject(Class<T> cls, long handle, int afterMarshaledFlags)
static <T extends ObjCObject> T	toObjCObject(Class<T> cls, long handle, int afterMarshaledFlags, boolean forceType)
void	updateStrongRef(Object before, Object after) Updates a strong reference handling null values properly.

Methods inherited from class org.robovm.rt.bro.NativeObject

as, equals, getHandle, hashCode, setHandle

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

customClass

protected final boolean customClass

Constructor Detail

ObjCObject

protected ObjCObject()

ObjCObject

protected ObjCObject(long handle)

Method Detail

initObject

protected void initObject(long handle)

alloc

protected long alloc()

finalize

protected final void finalize()
                       throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

dispose

public final void dispose()

doDispose

protected void doDispose()

dispose

protected void dispose(boolean finalizing)

getSuper

protected ObjCSuper getSuper()

afterMarshaled

protected void afterMarshaled(int flags)

getObjCClass

public final ObjCClass getObjCClass()

addStrongRef

public <T> T addStrongRef(T to)

removeStrongRef

public void removeStrongRef(Object to)

updateStrongRef

public void updateStrongRef(Object before,
                            Object after)

Updates a strong reference handling null values properly. This is meant to be used for Property setter methods with strongRef=true.

Parameters:

before - the previous value for the property. If not null and not equal to after removeStrongRef(Object) will be called on this value.

after - the new value for the property. If not null and not equal to after addStrongRef(Object) will be called on this value.

getAssociatedObject

public Object getAssociatedObject(Object key)

setAssociatedObject

public void setAssociatedObject(Object key,
                                Object value)

toObjCObject

public static <T extends ObjCObject> T toObjCObject(Class<T> cls,
                                                    long handle,
                                                    int afterMarshaledFlags)

toObjCObject

public static <T extends ObjCObject> T toObjCObject(Class<T> cls,
                                                    long handle,
                                                    int afterMarshaledFlags,
                                                    boolean forceType)

logRetainRelease

public static void logRetainRelease(boolean enabled)

Sets whether retain/release of custom ObjCObject should be logged to the console to identify retain/release leaks. Note that the GC has to be able to collect the custom object for the final release to be triggered.

The output logs the class, memory address and retain count after the release/retain invocation. You can use the memory address to inspect custom objects in Instruments.