org.basex.query.up.primitives.node

Class NodeUpdate

java.lang.Object

org.basex.query.up.primitives.Update

org.basex.query.up.primitives.DataUpdate

org.basex.query.up.primitives.node.NodeUpdate

Direct Known Subclasses:

DeleteNode, InsertAfter, InsertAttribute, InsertBefore, InsertInto, InsertIntoAsFirst, InsertIntoAsLast, RenameNode, ReplaceDoc, ReplaceNode, ReplaceValue

public abstract class NodeUpdate
extends DataUpdate

Base class for all update primitives that operate on a specific node.

Author:

BaseX Team 2005-21, BSD License, Lukas Kircher

Field Summary

Fields

Modifier and Type	Field and Description
int	pre Pre value of target node.

Fields inherited from class org.basex.query.up.primitives.DataUpdate

data

Fields inherited from class org.basex.query.up.primitives.Update

info, type

Method Summary

Modifier and Type	Method and Description
abstract void	addAtomics(AtomicUpdateCache auc) Adds the atomic update operations for this update primitive to the given list.
DBNode	node() Creates a DBNode instance from the target node information.
abstract void	prepare(MemData memData, QueryContext qc) Prepares this update primitive before execution.
NodeUpdate[]	substitute(MemData tmp) Substitutes the update primitive if necessary.
abstract void	update(NamePool pool) Updates the name pool, which is used to find duplicate attributes and namespace conflicts.

Methods inherited from class org.basex.query.up.primitives.DataUpdate

data

Methods inherited from class org.basex.query.up.primitives.Update

info, merge, size

Methods inherited from class java.lang.Object

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

Field Detail

pre

public final int pre

Pre value of target node.

Method Detail

node

public final DBNode node()

Creates a DBNode instance from the target node information.

Returns:

new node instance

prepare

public abstract void prepare(MemData memData,
                             QueryContext qc)
                      throws QueryException

Prepares this update primitive before execution. This includes e.g. the preparation of insertion sequences.

Parameters:

memData - temporary data instance

qc - query context

Throws:

QueryException - query exception

update

public abstract void update(NamePool pool)

Updates the name pool, which is used to find duplicate attributes and namespace conflicts.

Parameters:

pool - name pool

addAtomics

public abstract void addAtomics(AtomicUpdateCache auc)

Adds the atomic update operations for this update primitive to the given list.

Parameters:

auc - list of atomic updates

substitute

public NodeUpdate[] substitute(MemData tmp)

Substitutes the update primitive if necessary. For instance a 'Replace Value of' primitive called on a target T with T being an element results in a 'Replace Element Content' primitive with target T. As this is ugly to process it is substituted by delete primitives for every child of T and an 'Insert into' primitive if the length of the (optional!) text node is greater zero. When a primitive is substituted it is still added to the list itself to be able to throw exceptions when necessary. I.e. for multiple replaces on the same target node. These update primitives don't produce atomic updates, hence this won't affect the database.

Parameters:

tmp - temporary mem data

Returns:

An array that contains the substituting primitives or this update primitive if no substitution is necessary.