Common super-class for IndexedClarkElem and IndexedScopedElem.
Common super-class for IndexedClarkElem and IndexedScopedElem.
The underlying element type
IndexedDocument
, containing an "indexed" document element with simple elements as underlying elements.
Document, containing an "indexed" document element.
Document, containing an "indexed" document element.
Note that class IndexedDocument
does not have any query methods for Elem
instances. In particular, the ElemApi
does not
apply to documents. Therefore, given a document, querying for elements (other than the document element itself) always goes
via the document element.
Factory object for Elem
instances, where Elem
is a type alias for IndexedScopedElem[simple.Elem]
.
This package contains element representations that contain the "context" of the element. That is, the elements in this package are pairs of a root element and a path (to the actual element itself). The "context" of an element also contains an optional document URI.
An example of where such a representation can be useful is XML Schema. After all, to interpret an element definition in an XML schema, we need context of the element definition to determine the target namespace, or to determine whether the element definition is top level, etc.
Below follows a simple example query, using the uniform query API:
The query for Scala book authors would have been exactly the same if normal
Elem
s had been used instead ofindexed.Elem
s (replacingindexedBookstoreElem
bybookstoreElem
)!There is no explicit functional update support for the indexed elements in this package. Of course the underlying elements can be functionally updated (for element implementations that offer such update support), and indexed elements can be created from the update results, but this is hardly efficient functional update support.
One problem with efficient functional updates for indexed elements is that updating just one child element means that all subsequent child elements may have to be updated as well, adapting the stored paths. In comparison, simple elements do not have this restriction, and can be updated in isolation. Hence the functional update support for simple elements but not for the different indexed element implementations.