org.robolectric.res.android

Class NativeObjRegistry<T>

java.lang.Object

org.robolectric.res.android.NativeObjRegistry<T>

public class NativeObjRegistry<T>
extends java.lang.Object

A unique id per object registry. Used to emulate android platform behavior of storing a long which represents a pointer to an object.

Constructor Summary

Constructors

Constructor and Description
NativeObjRegistry(java.lang.Class<T> theClass)
NativeObjRegistry(java.lang.Class<T> theClass, boolean debug)
NativeObjRegistry(java.lang.String name)
NativeObjRegistry(java.lang.String name, boolean debug)

Method Summary

Modifier and Type	Method and Description
void	clear() WARNING – dangerous! Call unregister(long) instead!
T	getNativeObject(long nativeId) Retrieve the native object for given id.
long	getNativeObjectId(T o) Deprecated. Use register(Object) instead.
T	peekNativeObject(long nativeId) Similar to getNativeObject(long) but returns null if object with given id cannot be found.
long	register(T o) Register and assign a new unique native id for given object (representing a C memory pointer).
void	unregister(long nativeId) Unregister an object previously registered with register(Object).
void	unregister(T removed) Deprecated. Use unregister(long) instead.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeObjRegistry

public NativeObjRegistry(java.lang.Class<T> theClass)

NativeObjRegistry

public NativeObjRegistry(java.lang.Class<T> theClass,
                         boolean debug)

NativeObjRegistry

public NativeObjRegistry(java.lang.String name)

NativeObjRegistry

public NativeObjRegistry(java.lang.String name,
                         boolean debug)

Method Detail

getNativeObjectId

@Deprecated
public long getNativeObjectId(T o)

Deprecated. Use register(Object) instead.

Retrieve the native id for given object. Assigns a new unique id to the object if not previously registered.

register

public long register(T o)

Register and assign a new unique native id for given object (representing a C memory pointer).

Throws:

java.lang.IllegalStateException - if the object was previously registered

unregister

public void unregister(long nativeId)

Unregister an object previously registered with register(Object).

Parameters:

nativeId - the unique id (representing a C memory pointer) of the object to unregister.

Throws:

java.lang.IllegalStateException - if the object was never registered, or was previously unregistered.

unregister

@Deprecated
public void unregister(T removed)

Deprecated. Use unregister(long) instead.

getNativeObject

public T getNativeObject(long nativeId)

Retrieve the native object for given id. Throws if object with that id cannot be found

peekNativeObject

public T peekNativeObject(long nativeId)

Similar to getNativeObject(long) but returns null if object with given id cannot be found.

clear

public void clear()

WARNING – dangerous! Call unregister(long) instead!