Constructor and Description |
---|
LinkRecord(HGHandle type) |
LinkRecord(HGHandle type,
HGHandle[] targets) |
Modifier and Type | Method and Description |
---|---|
int |
getArity()
Return the number of targets of this link.
|
HGHandle |
getTargetAt(int i)
Return the ith target.
|
void |
notifyTargetHandleUpdate(int i,
HGHandle handle)
Notify the
HGLink that one of its target atoms should be referred to
by a different HGHandle instance. |
void |
notifyTargetRemoved(int i)
Notify the
HGLink that one of its targets must be removed. |
get, getSlots, getTypeHandle, set
public LinkRecord(HGHandle type)
public int getArity()
HGLink
Return the number of targets of this link. This number may be >= 0.
public HGHandle getTargetAt(int i)
HGLink
Return the ith target.
getTargetAt
in interface HGLink
i
- The index of the desired target. The range of this parameters must be
[0...getArity() - 1]
.public void notifyTargetHandleUpdate(int i, HGHandle handle)
HGLink
Notify the HGLink
that one of its target atoms should be referred to
by a different HGHandle
instance. Generally, implementation should update their reference
to this target with the passed in live handle.
IMPORTANT NOTE: This method should never be called by application
code. It is strictly reserved to the HyperGraph implementation which guarantees that
the new handle will always refer to the same atom. The method should essentially
perform a setTargetAt
operation, but a more elaborate name was chosen
to reflect the intended usage. Note also that the intent is not for an implementation
to attempt a database update! The intent is to only update the runtime representation
of the set of targets pointed to be this link.
notifyTargetHandleUpdate
in interface HGLink
i
- The index of the target that was loaded.handle
- The new live handle of the target atom.public void notifyTargetRemoved(int i)
HGLink
Notify the HGLink
that one of its targets must be removed. This
method is invoked by the system when the target at position i
refers
to an atom that is being deleted from the database. Implementation are required
to remove the target at that position from their implementation data structure.
It remains the system's responsibility to reflect that change in permanent
data storage.
An implementation may throw an IllegalArgumentException
if the target
cannot be removed from the link because it would somehow break the semantics of the
application or lead to an otherwise inconsistent state. Throwing such an exception would
indicate a fatal error and a very likely bug in the application.
notifyTargetRemoved
in interface HGLink
i
- The 0-based position of the target to be removed from this link.Copyright © 2015. All rights reserved.