Module dev.metaschema.core

Package dev.metaschema.core.metapath.item.node

package dev.metaschema.core.metapath.item.node

Node item types representing structured data in the Metapath type system.

This package provides interfaces and implementations for node items, which form tree-structured graphs representing both Metaschema models (module definitions) and data instances conforming to those models. Node items enable navigation and querying of hierarchical data using Metapath expressions.

Core node type interfaces include:

• INodeItem - Base interface for all node items
• IDocumentNodeItem - Document root node representing a data instance
• IAssemblyNodeItem - Assembly nodes containing nested structures
• IFieldNodeItem - Field nodes containing values and flags
• IFlagNodeItem - Flag nodes containing simple values
• IModuleNodeItem - Module definition nodes representing Metaschema schemas

Node items support:

• XPath-style navigation (parent, child, ancestor, descendant relationships)
• Document order traversal for predictable query results
• Access to typed values through IAtomicValuedNodeItem
• Visitor pattern traversal via INodeItemVisitor
• Factory-based creation through INodeItemFactory

Node items integrate with Metaschema model definitions in dev.metaschema.core.model, providing runtime representations that can be queried using Metapath expressions. Each node maintains references to its definition (schema-level metadata) and its position within the document tree.

See Also:

• XPath 3.1 Data Model: Nodes
• dev.metaschema.core.model

Related Packages

Package	Description
dev.metaschema.core.metapath.item	Core interfaces and classes for the Metapath item type system.
dev.metaschema.core.metapath.item.atomic	Atomic item types representing indivisible values in the Metapath type system.
dev.metaschema.core.metapath.item.function	Provides support for Metapath function items, including arrays and maps.

Class	Description
AbstractDefinitionNodeItem<D extends IDefinition,I extends INamedInstance>	A base implementation of a node item backed by a Metaschema definition.
AbstractFlagInstanceNodeItem	A INodeItem supported by a IFlagInstance.
AbstractGlobalDefinitionNodeItem<D extends IDefinition,I extends INamedInstance>	Represents a node item based on a global definition from a Metaschema.
AbstractInstanceNodeItem<D extends IDefinition,I extends INamedInstance,P extends IModelNodeItem<? extends IModelDefinition,? extends INamedInstance>>	A base implementation of a node item backed by a Metaschema instance.
AbstractNodeItem	A common base class for node item implementations.
AbstractNodeItemFactory	A base implementation of a node item factory that creates node items for Metaschema definitions and instances.
AbstractNodeItemVisitor<CONTEXT,RESULT>	Used by implementations of this class to visit a sequence of node items in a directed graph, using depth-first ordering.
AbstractOrphanedDefinitionNodeItem<D extends IDefinition,I extends INamedInstance>	A base implementation of a node item for a Metaschema definition that exists without a parent context (orphaned).
AbstractRecursionPreventingNodeItemVisitor<CONTEXT,RESULT>	A node item visitor that prevents infinite recursion when traversing assembly nodes by detecting and avoiding cycles in the node hierarchy.
IAssemblyInstanceGroupedNodeItem	Represents a Metapath assembly node item for a grouped assembly instance.
IAssemblyNodeItem	A Metapath node valued item representing a Metaschema module assembly.
IAtomicValuedNodeItem	Represents a Metapath node item that has an atomic value.
ICycledAssemblyNodeItem	A marker interface used to identify an IAssemblyNodeItem as the head of a cycle of item that loop back to the head.
IDefinitionNodeItem<D extends IDefinition,I extends INamedInstance>	Represents a Metapath node item that is based on an underlying Metaschema module definition and instance.
IDocumentBasedNodeItem	Represents a Metapath node item that is associated with a document.
IDocumentNodeItem	A node item that represents the root of a tree of nodes associated with a document resource.
IFeatureChildNodeItem	Represents a node item for a Metaschema model instance the is always a child of another item in the Metaschema model.
IFeatureFlagContainerItem	This mixin interface indicates that the implementation is a INodeItem that is based on an IModelDefinition.
IFeatureFlagContainerItem.FlagContainer	Provides an abstract implementation of a model that contains a collection of flags.
IFeatureModelContainerItem	This mixin interface indicates that the implementation is a INodeItem that may have both flag and model children.
IFeatureModelContainerItem.ModelContainer	Provides an abstract implementation of a lazy loaded model.
IFeatureNoDataAtomicValuedItem	A feature interface representing an atomic-valued item that has no associated value data.
IFeatureNoDataValuedItem	This feature interface represents an item that has no associated value data.
IFeatureOrhpanedDefinitionNodeItem<D extends IDefinition,I extends INamedInstance>	A mixin interface used to identify that the implementation is a IDefinitionNodeItem that is based on a IDefinition that is an orphan in it's hierarchy.
IFieldNodeItem	A Metapath node valued item representing a Metaschema module field.
IFlagNodeItem	A Metapath node valued item representing a Metaschema module flag.
IModelNodeItem<D extends IModelDefinition,I extends INamedModelInstance>	Represents a Metapath node item for a Metaschema model instance (assembly or field).
IModuleNodeItem	Supports querying of global definitions and associated instances in a Metaschema module by effective name.
INodeItem	Represents a Metapath model node.
INodeItem.NodeType	The type of node.
INodeItemFactory	This factory interface is used to create INodeItem objects of various types.
INodeItemGenerator	Generates child node items for Metapath node items.
INodeItemVisitable	Marks a node item as visitable by a INodeItemVisitor.
INodeItemVisitor<CONTEXT,RESULT>	Provides a set of callbacks used when iterating over node items in a directed graph.
IRootAssemblyNodeItem	A marker interface used to expose root node functionality for an assembly node that has root information.
NodeComparators	Provides methods for comparing nodes according to the Metapath specification.
NodeItemKind	This enumeration provides a listing of the available kinds of INodeItem implementations.
RecursionCollectingNodeItemVisitor	Analyzes a Metaschema module to identify assembly definitions that are recursive.
RecursionCollectingNodeItemVisitor.AssemblyRecord	Records information about an assembly definition, including whether it is recursive and where it is used.