com.goldencode.p2j.util

Class ObjectOps.ObjectHelper

java.lang.Object

com.goldencode.p2j.util.ObjectOps.ObjectHelper

Enclosing class:

ObjectOps

public static class ObjectOps.ObjectHelper
extends java.lang.Object

Helper to expose APIs which have direct access to the context-local state.

Field Summary

Fields

Modifier and Type	Field and Description
private ObjectOps.WorkArea	wa The ObjectOps.WorkArea instance.

Constructor Summary

Constructors

Constructor and Description
ObjectHelper(ObjectOps.WorkArea wa) Create a new instance and associate the given WorkArea instance.

Method Summary

Modifier and Type	Method and Description
void	decrement(_BaseObject_ ref) Decrement the reference counter for this instance.
boolean	delete(_BaseObject_ ref) Deletes the given object.
void	deregisterObject(_BaseObject_ ref) Deregister the specified instance.
void	increment(_BaseObject_ ref) Increment the reference counter for this instance.
boolean	inScopeFinished() Get the state of the ObjectOps.WorkArea.inScopeFinished flag.
void	instanceAssigned(_BaseObject_ ref) Remove this instance from the pending assignments, as it was assigned.
boolean	instanceReturned(_BaseObject_ ref) Check if this reference is saved to be returned by a function or method call.
boolean	isInitializing(_BaseObject_ ref) Return true if this instance is pending initialization.
boolean	isPendingAssigned(_BaseObject_ ref) Check if the reference is marked as ObjectOps.WorkArea.pendingAssigned.
boolean	isValid(_BaseObject_ ref) Check if this object is valid.
void	load(java.lang.Class<? extends _BaseObject_> cls) Load the given legacy class.
void	pendingAssign(_BaseObject_ ref) Mark this instance as a pending assignment.
void	registerObject(ObjectVar<?> obj) Register this instance as if it was defined in the current block, so the reference can be tracked again - this is useful for 'zero counter' reference returned from a function call, which, if not assigned to some other var, will never get deleted.
void	registerPendingScopeable() Register the ObjectOps.WorkArea scopeable as pending, to be added to the next block.
void	registerScopeable() Register the ObjectOps.WorkArea scopeable in this current block.
void	setInScopeFinished(boolean state) Set the state of the ObjectOps.WorkArea.inScopeFinished flag.

Methods inherited from class java.lang.Object

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

Field Detail

wa

private final ObjectOps.WorkArea wa

The ObjectOps.WorkArea instance.

Constructor Detail

ObjectHelper

public ObjectHelper(ObjectOps.WorkArea wa)

Create a new instance and associate the given WorkArea instance.

Parameters:

wa - The ObjectOps.WorkArea instance.

Method Detail

registerPendingScopeable

public void registerPendingScopeable()

Register the ObjectOps.WorkArea scopeable as pending, to be added to the next block.

inScopeFinished

public boolean inScopeFinished()

Get the state of the ObjectOps.WorkArea.inScopeFinished flag.

Returns:

true if we are in ObjectOps.WorkArea.scopeDeleted() or ObjectOps.WorkArea.scopeFinished().

setInScopeFinished

public void setInScopeFinished(boolean state)

Set the state of the ObjectOps.WorkArea.inScopeFinished flag.

Parameters:

state - The flag's value.

registerScopeable

public void registerScopeable()

Register the ObjectOps.WorkArea scopeable in this current block.

registerObject

public void registerObject(ObjectVar<?> obj)

Register this instance as if it was defined in the current block, so the reference can be tracked again - this is useful for 'zero counter' reference returned from a function call, which, if not assigned to some other var, will never get deleted.

Parameters:

obj - The object to register.

pendingAssign

public void pendingAssign(_BaseObject_ ref)

Mark this instance as a pending assignment.

Parameters:

ref - The legacy instance.

load

public void load(java.lang.Class<? extends _BaseObject_> cls)

Load the given legacy class. This will initialize it by recursively execute the static c'tor for all super-classes (if defined).

Parameters:

cls - The class to initialize.

delete

public boolean delete(_BaseObject_ ref)

Deletes the given object.

Parameters:

ref - The object to be deleted.

Returns:

true if the delete was possible (the instance is not on stack).

deregisterObject

public void deregisterObject(_BaseObject_ ref)

Deregister the specified instance.

Parameters:

ref - The instance to deregister.

decrement

public void decrement(_BaseObject_ ref)

Decrement the reference counter for this instance.

Parameters:

ref - The legacy instance.

increment

public void increment(_BaseObject_ ref)

Increment the reference counter for this instance.

Parameters:

ref - The legacy instance.

isPendingAssigned

public boolean isPendingAssigned(_BaseObject_ ref)

Check if the reference is marked as ObjectOps.WorkArea.pendingAssigned.

Parameters:

ref - The reference to check.

Returns:

See above.

instanceReturned

public boolean instanceReturned(_BaseObject_ ref)

Check if this reference is saved to be returned by a function or method call.

Parameters:

ref - The legacy instance.

Returns:

true if the instance is pending to be returned by a function or method call.

instanceAssigned

public void instanceAssigned(_BaseObject_ ref)

Remove this instance from the pending assignments, as it was assigned.

Parameters:

ref - The legacy instance.

isInitializing

public boolean isInitializing(_BaseObject_ ref)

Return true if this instance is pending initialization.

Parameters:

ref - The legacy instance.

isValid

public boolean isValid(_BaseObject_ ref)

Check if this object is valid.

Parameters:

ref - The legacy object.

Returns:

true if this object is valid.