com.goldencode.p2j.util

Class ObjectResource

java.lang.Object

com.goldencode.p2j.util.HandleResource

com.goldencode.p2j.util.HandleChain

com.goldencode.p2j.util.ObjectResource

All Implemented Interfaces:

CommonHandle, CommonHandleChain, Deletable, InstantiatingProcedure, Nameable, WrappedResource, Printable

public class ObjectResource
extends HandleChain

A pseudo-resource to help management for the legacy class instances.

This will allow the object chaining to work naturally as with other legacy resources, help with reference management and resource delete.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Deque<InternalEntry>	destructors The destructors to be executed on delete.
private boolean	pendingDelete Flag indicating if this resource is being deleted.
private _BaseObject_	ref The contained object instance.
private long	references The reference counter.

Fields inherited from class com.goldencode.p2j.util.HandleChain

name, nextSibling, prevSibling, wa

Fields inherited from class com.goldencode.p2j.util.HandleResource

instProc, pm

Constructor Summary

Constructors

Constructor and Description
ObjectResource(_BaseObject_ reference) Initialize this object with the given reference.

Method Summary

Modifier and Type	Method and Description
void	decrement() Decrement the reference counter.
void	delete() Perform actual delete of an resource.
(package private) void	deleteSilent() Silently delete this object, by ignoring all conditions.
(package private) long	getReferences() Get the current reference counter.
(package private) boolean	hasActiveDestructors() Checks whether the object has any destructor pushed on stack ready to be executed when the lifetime of the object ends.
void	increment() Increment the reference counter.
(package private) boolean	isPendingDelete() Check if this resource is being deleted.
protected boolean	processResource() Check if this resource must be processed via ProcedureManager.processResource(com.goldencode.p2j.util.WrappedResource, boolean), once it has been instantiated.
(package private) void	pushDestructor(InternalEntry mthd) Add a new destructor on the stack.
_BaseObject_	ref() Return the wrapped reference.
protected boolean	resourceDelete() Check if the resource can be deleted (is not delayed).
boolean	unknown() Check if this resource is unknown.
boolean	valid() Check if this pseudo-resource is valid.

Methods inherited from class com.goldencode.p2j.util.HandleChain

_name, firstResource, firstResource, getHead, getNextSibling, getNextSibling, getPrevSibling, getPrevSibling, getPrivateData, getTail, hasName, hasNameConstraints, hasNameReadOnly, hasNextSibling, hasParent, hasPrevSibling, hasPrivateData, interlink, isChained, lastResource, lastResource, moveInChain, name, name, name, readOnlyError, readOnlyError, resolveChainType, setHead, setNextSibling, setNextSibling, setPrevSibling, setPrevSibling, setPrivateData, setPrivateData, setPrivateData, validateName

Methods inherited from class com.goldencode.p2j.util.HandleResource

_instantiatingProcedure, addToPool, doDelete, equals, hashCode, id, id, implicitDeletion, incrementTrigger, instantiatingProcedure, invalidAttribute, registerResource, resourceType, setInstantiatingProcedure, toString, type, unableToAssignUnknown

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.goldencode.p2j.util.CommonHandle

resourceType

Methods inherited from interface com.goldencode.p2j.util.WrappedResource

id, id

Methods inherited from interface com.goldencode.util.Printable

asString, print

Methods inherited from interface com.goldencode.p2j.util.Deletable

allowDelete

Field Detail

ref

private _BaseObject_ ref

The contained object instance. null is unknown value.

references

private long references

The reference counter.

destructors

private java.util.Deque<InternalEntry> destructors

The destructors to be executed on delete.

pendingDelete

private boolean pendingDelete

Flag indicating if this resource is being deleted.

Constructor Detail

ObjectResource

public ObjectResource(_BaseObject_ reference)

Initialize this object with the given reference.

Parameters:

reference - The reference.

Method Detail

unknown

public boolean unknown()

Check if this resource is unknown.

Specified by:

unknown in interface WrappedResource

Overrides:

unknown in class HandleResource

Returns:

always false

valid

public boolean valid()

Check if this pseudo-resource is valid.

Returns:

true if ref is not null.

ref

public _BaseObject_ ref()

Return the wrapped reference.

Returns:

The contained reference.

processResource

protected boolean processResource()

Check if this resource must be processed via ProcedureManager.processResource(com.goldencode.p2j.util.WrappedResource, boolean), once it has been instantiated.

Overrides:

processResource in class HandleResource

Returns:

Always false.

increment

public void increment()

Increment the reference counter.

decrement

public void decrement()

Decrement the reference counter. When it reaches zero, delete this object.

delete

public void delete()

Perform actual delete of an resource. At the time of this call, it is assumed the resource is valid for deletion (the handle and the resource are both valid).

Specified by:

delete in interface Deletable

Overrides:

delete in class HandleChain

resourceDelete

protected boolean resourceDelete()

Check if the resource can be deleted (is not delayed).

Overrides:

resourceDelete in class HandleResource

Returns:

Always true

hasActiveDestructors

boolean hasActiveDestructors()

Checks whether the object has any destructor pushed on stack ready to be executed when the lifetime of the object ends.

Returns:

true if when the object is deleted at least one destructor will be executed.

pushDestructor

void pushDestructor(InternalEntry mthd)

Add a new destructor on the stack. These will be invoked, in the inverse order, on object deletion.

Parameters:

mthd - The destructor method.

getReferences

long getReferences()

Get the current reference counter.

Returns:

The references.

deleteSilent

void deleteSilent()

Silently delete this object, by ignoring all conditions.

isPendingDelete

boolean isPendingDelete()

Check if this resource is being deleted.

Returns:

The pendingDelete state.