org.aspectj.org.eclipse.jdt.internal.core.nd.field

Class FieldManyToOne<T extends NdNode>

java.lang.Object

org.aspectj.org.eclipse.jdt.internal.core.nd.field.FieldManyToOne<T>

All Implemented Interfaces:

IDestructableField, IField, IRefCountedField

public class FieldManyToOne<T extends NdNode>
extends java.lang.Object
implements IDestructableField, IField, IRefCountedField

Holds the n side of a n..1 relationship. Declares a Nd field which is a pointer of a NdNode of the specified type. FieldManyToOne forms a one-to-many relationship with FieldOneToMany. Whenever a FieldManyToOne points to an object, the inverse pointer is automatically inserted into the matching back pointer list.

Field Summary

Fields

Modifier and Type	Field and Description
static FieldInt	BACKPOINTER_INDEX
boolean	pointsToOwner True iff the other end of this pointer should delete this object when its end of the pointer is cleared.
static FieldPointer	TARGET

Method Summary

Modifier and Type	Method and Description
static <T extends NdNode,B extends NdNode> FieldManyToOne<T>	create(StructDef<B> builder, FieldOneToMany<B> forwardPointer)
static <T extends NdNode,B extends NdNode> FieldManyToOne<T>	createOwner(StructDef<B> builder, FieldOneToMany<B> forwardPointer) Creates a many-to-one pointer which points to this object's owner.
void	destruct(Nd nd, long address)
protected void	detachFromOldTarget(Nd nd, long address, long oldTargetAddress)
T	get(Nd nd, long address)
long	getAddress(Nd nd, long address)
int	getRecordSize()
boolean	hasReferences(Nd nd, long address) Returns true if this field knows of any remaining incoming references to this object.
void	put(Nd nd, long address, long newTargetAddress)
void	put(Nd nd, long address, T value) Directs this pointer to the given target.
void	setOffset(int offset)

Methods inherited from class java.lang.Object

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

Field Detail

TARGET

public static final FieldPointer TARGET

BACKPOINTER_INDEX

public static final FieldInt BACKPOINTER_INDEX

pointsToOwner

public final boolean pointsToOwner

True iff the other end of this pointer should delete this object when its end of the pointer is cleared.

Method Detail

create

public static <T extends NdNode,B extends NdNode> FieldManyToOne<T> create(StructDef<B> builder,
                                                                           FieldOneToMany<B> forwardPointer)

createOwner

public static <T extends NdNode,B extends NdNode> FieldManyToOne<T> createOwner(StructDef<B> builder,
                                                                                FieldOneToMany<B> forwardPointer)

Creates a many-to-one pointer which points to this object's owner. If the pointer is non-null when the owner is deleted, this object will be deleted too.

Parameters:

builder - the struct to which the field will be added

forwardPointer - the field which holds the pointer in the other direction

Returns:

a newly constructed field

get

public T get(Nd nd,
             long address)

getAddress

public long getAddress(Nd nd,
                       long address)

put

public void put(Nd nd,
                long address,
                T value)

Directs this pointer to the given target. Also removes this pointer from the old backpointer list (if any) and inserts it into the new backpointer list (if any)

put

public void put(Nd nd,
                long address,
                long newTargetAddress)

detachFromOldTarget

protected void detachFromOldTarget(Nd nd,
                                   long address,
                                   long oldTargetAddress)

destruct

public void destruct(Nd nd,
                     long address)

Specified by:

destruct in interface IDestructableField

setOffset

public void setOffset(int offset)

Specified by:

setOffset in interface IField

getRecordSize

public int getRecordSize()

Specified by:

getRecordSize in interface IField

hasReferences

public boolean hasReferences(Nd nd,
                             long address)

Description copied from interface: IRefCountedField

Returns true if this field knows of any remaining incoming references to this object. This is used by the implementation of FieldManyToOne to determine whether or not a refcounted object should be deleted after a reference is removed.

Implementations should return false if the refcount is 0 or true if the refcount is nonzero.

Specified by:

hasReferences in interface IRefCountedField