eu.cdevreeze.yaidom.indexed

IndexedClarkElem

final class IndexedClarkElem[U <: Aux[U]] extends AbstractIndexedClarkElem[U] with queryapi.Nodes.Elem

An element within its context. In other words, an element as a pair containing the root element (of an underlying element type) and a path (from that root element) to this element. More precisely, this element implementation contains an underlying root element, a Path, and an underlying element found from the root element following the Path. It also contains an optional URI of the containing document, if any.

See the documentation of the mixed-in query API trait(s) for more details on the uniform query API offered by this class.

An IndexedClarkElem(underlyingRootElem) can be seen as one immutable snapshot of an XML tree. All queries (using the ElemApi uniform query API) on that snapshot return results within the same snapshot. Take care not to mix up query results from different snapshots. (This could have been modeled in an alternative design of the class, but such a design has not been chosen.)

Using IndexedClarkElem objects, it is easy to get the ancestry or siblings of an element, as elements of the underlying element type.

Be careful not to create any memory leaks. After all, an element, even a leaf element, typically keeps the entire underlying document element tree as state. Hence the underlying document element tree will always remain in memory if at least one indexed element contains it in its state. (Yet with mutable org.w3c.dom element trees, it is also easy to cause memory leaks. See http://apmblog.compuware.com/2011/04/20/the-top-java-memory-problems-part-1/.)

The optional parent base URI is stored for very fast (optional) base URI computation. This is helpful in an XBRL context, where URI resolution against a base URI is typically a very frequent operation.

IndexedClarkElem examples

The following example code shows how to query for elements with a known ancestry, regardless of the element implementation, if efficiency is not important:

val iBookstore = IndexedClarkElem(bookstore)

val iTheBookAuthors =
  for {
    iAuthor <- iBookstore.filterElems(withLocalName("Author"))
    bookPath <- iAuthor.path.findAncestorPath(_.elementNameOption.map(_.localPart) == Some("Book"))
    iBook <- iBookstore.findElem(_.path == bookPath)
    if iBook.getChildElem(withLocalName("Title")).elem.text.startsWith("Programming in Scala")
  } yield iAuthor

IndexedClarkElem more formally

In order to use this class, this more formal section can safely be skipped.

The IndexedClarkElem class can be understood in a precise mathematical sense, as shown below.

Some properties of IndexedClarkElems are as follows:

// All elements (obtained from querying other elements) have the same rootElem

iElem.findAllElemsOrSelf.map(_.rootElem).distinct == List(iElem.rootElem)

iElem.findAllElemsOrSelf.map(_.underlyingRootElem).distinct == List(iElem.underlyingRootElem)

// The correspondence between rootElem, path and elem

iElem.findAllElemsOrSelf.forall(e => e.rootElem.findElemOrSelfByPath(e.path).get == e)

iElem.findAllElemsOrSelf.forall(e => e.underlyingRootElem.findElemOrSelfByPath(e.path).get == e.underlyingElem)

The correspondence between queries on IndexedClarkElems and the same queries on the underlying elements is as follows:

// Let p be a function from underlying element type E to Boolean

iElem.rootElem.filterElemsOrSelf(e => p(e.underlyingElem)).map(_.underlyingElem) ==
  iElem.underlyingRootElem.filterElemsOrSelf(p)

Analogous properties hold for the other query methods.

Linear Supertypes
AbstractIndexedClarkElem[U], ClarkElemLike, HasText, HasEName, IsNavigable, ElemLike, IndexedClarkElemApi, ClarkElemApi, HasTextApi, HasENameApi, IsNavigableApi, ElemApi, AnyElemApi, queryapi.Nodes.Elem, CanBeDocumentChild, Node, AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. IndexedClarkElem
  2. AbstractIndexedClarkElem
  3. ClarkElemLike
  4. HasText
  5. HasEName
  6. IsNavigable
  7. ElemLike
  8. IndexedClarkElemApi
  9. ClarkElemApi
  10. HasTextApi
  11. HasENameApi
  12. IsNavigableApi
  13. ElemApi
  14. AnyElemApi
  15. Elem
  16. CanBeDocumentChild
  17. Node
  18. AnyRef
  19. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Type Members

  1. type ThisElem = IndexedClarkElem[U]

    Definition Classes
    IndexedClarkElem → AnyElemApi

  2. type ThisElemApi = IndexedClarkElem[U]

    Definition Classes
    IndexedClarkElem → AbstractIndexedClarkElem → ClarkElemLike → IsNavigable → ElemLike → IndexedClarkElemApi → ClarkElemApi → IsNavigableApi → ElemApi → AnyElemApi

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef

  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any

  3. final def ##(): Int

    Definition Classes
    AnyRef → Any

  4. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef

  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any

  6. final def \(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Shorthand for filterChildElems(p).

    Shorthand for filterChildElems(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLike → ElemApi

  7. final def \@(expandedName: EName): Option[String]

    Shorthand for attributeOption(expandedName).

    Shorthand for attributeOption(expandedName).

    Definition Classes
    HasEName → HasENameApi

  8. final def \\(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Shorthand for filterElemsOrSelf(p).

    Shorthand for filterElemsOrSelf(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLike → ElemApi

  9. final def \\!(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Shorthand for findTopmostElemsOrSelf(p).

    Shorthand for findTopmostElemsOrSelf(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLike → ElemApi

  10. final def asInstanceOf[T0]: T0

    Definition Classes
    Any

  11. final def attribute(expandedName: EName): String

    Returns the value of the attribute with the given expanded name, and throws an exception otherwise.

    Returns the value of the attribute with the given expanded name, and throws an exception otherwise.

    Definition Classes
    HasEName → HasENameApi

  12. final def attributeOption(expandedName: EName): Option[String]

    Returns the value of the attribute with the given expanded name, if any, wrapped in an Option.

    Returns the value of the attribute with the given expanded name, if any, wrapped in an Option.

    Definition Classes
    HasEName → HasENameApi

  13. final def baseUri: URI

    Returns the base URI, falling back to the empty URI if absent.

    Returns the base URI, falling back to the empty URI if absent.

    Definition Classes
    AbstractIndexedClarkElem

  14. final def baseUriOption: Option[URI]

    Returns the optional base URI, computed from the document URI, if any, and the XML base attributes of the ancestors, if any.

    Returns the optional base URI, computed from the document URI, if any, and the XML base attributes of the ancestors, if any.

    Definition Classes
    AbstractIndexedClarkElem → IndexedClarkElemApi

  15. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

  16. final def docUri: URI

    Returns the document URI, falling back to the empty URI if absent.

    Returns the document URI, falling back to the empty URI if absent.

    Definition Classes
    AbstractIndexedClarkElem

  17. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef

  18. final def equals(obj: Any): Boolean

    Definition Classes
    IndexedClarkElem → AnyRef → Any

  19. final def filterChildElems(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Returns the child elements obeying the given predicate.

    Returns the child elements obeying the given predicate. This method could be defined as:

    def filterChildElems(p: ThisElem => Boolean): immutable.IndexedSeq[ThisElem] =
this.findAllChildElems.filter(p)
    Definition Classes
    ElemLike → ElemApi

  20. final def filterElems(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Returns the descendant elements obeying the given predicate.

    Returns the descendant elements obeying the given predicate. This method could be defined as:

    this.findAllChildElems flatMap (_.filterElemsOrSelf(p))
    Definition Classes
    ElemLike → ElemApi

  21. final def filterElemsOrSelf(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Returns the descendant-or-self elements obeying the given predicate.

    Returns the descendant-or-self elements obeying the given predicate. This method could be defined as:

    def filterElemsOrSelf(p: ThisElem => Boolean): immutable.IndexedSeq[ThisElem] =
Vector(this).filter(p) ++ (this.findAllChildElems flatMap (_.filterElemsOrSelf(p)))

    It can be proven that the result is equivalent to findAllElemsOrSelf filter p.

    Definition Classes
    ElemLike → ElemApi

  22. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )

  23. final def findAllChildElems: IndexedSeq[ThisElem]

    Core method that returns all child elements, in the correct order.

    Core method that returns all child elements, in the correct order. Other operations can be defined in terms of this one.

    Definition Classes
    IndexedClarkElem → AbstractIndexedClarkElem → ElemLike → ElemApi

  24. final def findAllChildElemsWithPathEntries: IndexedSeq[(ThisElem, Entry)]

    Returns all child elements paired with their path entries.

    Returns all child elements paired with their path entries.

    This method is final, so more efficient implementations for sub-types are not supported. This implementation is only efficient if finding all child elements as well as computing their resolved names is efficient. That is not the case for DOM wrappers or Scala XML Elem wrappers (due to their expensive Scope computations). On the other hand, those wrapper element implementations are convenient, but not intended for heavy use in production. Hence, this method should typically be fast enough.

    Definition Classes
    ClarkElemLike → IsNavigable → IsNavigableApi

  25. final def findAllElems: IndexedSeq[ThisElem]

    Returns all descendant elements (not including this element).

    Returns all descendant elements (not including this element). This method could be defined as filterElems { e => true }. Equivalent to findAllElemsOrSelf.drop(1).

    Definition Classes
    ElemLike → ElemApi

  26. final def findAllElemsOrSelf: IndexedSeq[ThisElem]

    Returns this element followed by all descendant elements (that is, the descendant-or-self elements).

    Returns this element followed by all descendant elements (that is, the descendant-or-self elements). This method could be defined as filterElemsOrSelf { e => true }.

    Definition Classes
    ElemLike → ElemApi

  27. final def findAttributeByLocalName(localName: String): Option[String]

    Returns the first found attribute value of an attribute with the given local name, if any, wrapped in an Option.

    Returns the first found attribute value of an attribute with the given local name, if any, wrapped in an Option. Because of differing namespaces, it is possible that more than one such attribute exists, although this is not often the case.

    Definition Classes
    HasEName → HasENameApi

  28. final def findChildElem(p: (ThisElem) ⇒ Boolean): Option[ThisElem]

    Returns the first found child element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found child element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterChildElems(p).headOption.

    Definition Classes
    ElemLike → ElemApi

  29. final def findChildElemByPathEntry(entry: Entry): Option[ThisElem]

    Finds the child element with the given Path.Entry (where this element is the root), if any, wrapped in an Option.

    Finds the child element with the given Path.Entry (where this element is the root), if any, wrapped in an Option.

    This method is final, so more efficient implementations for sub-types are not supported. This implementation is only efficient if finding all child elements as well as computing their resolved names is efficient. That is not the case for DOM wrappers or Scala XML Elem wrappers (due to their expensive Scope computations). On the other hand, those wrapper element implementations are convenient, but not intended for heavy use in production. Hence, this method should typically be fast enough.

    Definition Classes
    ClarkElemLike → IsNavigable → IsNavigableApi

  30. final def findElem(p: (ThisElem) ⇒ Boolean): Option[ThisElem]

    Returns the first found (topmost) descendant element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found (topmost) descendant element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterElems(p).headOption.

    Definition Classes
    ElemLike → ElemApi

  31. final def findElemOrSelf(p: (ThisElem) ⇒ Boolean): Option[ThisElem]

    Returns the first found (topmost) descendant-or-self element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found (topmost) descendant-or-self element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterElemsOrSelf(p).headOption.

    Definition Classes
    ElemLike → ElemApi

  32. final def findElemOrSelfByPath(path: Path): Option[ThisElem]

    Finds the element with the given Path (where this element is the root), if any, wrapped in an Option.

    Finds the element with the given Path (where this element is the root), if any, wrapped in an Option.

    That is, returns:

    findReverseAncestryOrSelfByPath(path).map(_.last)

    Note that for each non-empty Path, we have:

    findElemOrSelfByPath(path) == findChildElemByPathEntry(path.firstEntry) flatMap (e => e.findElemOrSelfByPath(path.withoutFirstEntry))
    Definition Classes
    IsNavigable → IsNavigableApi

  33. final def findReverseAncestryOrSelfByPath(path: Path): Option[IndexedSeq[ThisElem]]

    Finds the reversed ancestry-or-self of the element with the given Path (where this element is the root), wrapped in an Option.

    Finds the reversed ancestry-or-self of the element with the given Path (where this element is the root), wrapped in an Option. None is returned if no element can be found at the given Path.

    Hence, the resulting element collection, if any, starts with this element and ends with the element at the given Path, relative to this element.

    This method comes in handy for (efficiently) computing base URIs, where the (reverse) ancestry-or-self is needed as input.

    Definition Classes
    IsNavigable → IsNavigableApi

  34. final def findTopmostElems(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Returns the descendant elements obeying the given predicate that have no ancestor obeying the predicate.

    Returns the descendant elements obeying the given predicate that have no ancestor obeying the predicate. This method could be defined as:

    this.findAllChildElems flatMap (_.findTopmostElemsOrSelf(p))
    Definition Classes
    ElemLike → ElemApi

  35. final def findTopmostElemsOrSelf(p: (ThisElem) ⇒ Boolean): IndexedSeq[ThisElem]

    Returns the descendant-or-self elements obeying the given predicate, such that no ancestor obeys the predicate.

    Returns the descendant-or-self elements obeying the given predicate, such that no ancestor obeys the predicate. This method could be defined as:

    def findTopmostElemsOrSelf(p: ThisElem => Boolean): immutable.IndexedSeq[ThisElem] =
if (p(this)) Vector(this)
else (this.findAllChildElems flatMap (_.findTopmostElemsOrSelf(p)))
    Definition Classes
    ElemLike → ElemApi

  36. final def getChildElem(p: (ThisElem) ⇒ Boolean): ThisElem

    Returns the single child element obeying the given predicate, and throws an exception otherwise.

    Returns the single child element obeying the given predicate, and throws an exception otherwise. This method could be defined as findChildElem(p).get.

    Definition Classes
    ElemLike → ElemApi

  37. final def getChildElemByPathEntry(entry: Entry): ThisElem

    Returns (the equivalent of) findChildElemByPathEntry(entry).get

    Returns (the equivalent of) findChildElemByPathEntry(entry).get

    Definition Classes
    IsNavigable → IsNavigableApi

  38. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any

  39. final def getElemOrSelfByPath(path: Path): ThisElem

    Returns (the equivalent of) findElemOrSelfByPath(path).get

    Returns (the equivalent of) findElemOrSelfByPath(path).get

    Definition Classes
    IsNavigable → IsNavigableApi

  40. final def getReverseAncestryOrSelfByPath(path: Path): IndexedSeq[ThisElem]

    Returns (the equivalent of) findReverseAncestryOrSelfByPath(path).get

    Returns (the equivalent of) findReverseAncestryOrSelfByPath(path).get

    Definition Classes
    IsNavigable → IsNavigableApi

  41. final def hashCode(): Int

    Definition Classes
    IndexedClarkElem → AnyRef → Any

  42. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any

  43. final def localName: String

    The local name, that is, the local part of the EName

    The local name, that is, the local part of the EName

    Definition Classes
    HasEName → HasENameApi

  44. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef

  45. final def normalizedText: String

    Returns XmlStringUtils.normalizeString(text).

    Returns XmlStringUtils.normalizeString(text).

    Definition Classes
    HasText → HasTextApi

  46. final def notify(): Unit

    Definition Classes
    AnyRef

  47. final def notifyAll(): Unit

    Definition Classes
    AnyRef

  48. final def parentBaseUriOption: Option[URI]

    Returns the optional parent element base URI, computed from the document URI, if any, and the XML base attributes of the ancestors, if any.

    Returns the optional parent element base URI, computed from the document URI, if any, and the XML base attributes of the ancestors, if any.

    Definition Classes
    AbstractIndexedClarkElem → IndexedClarkElemApi

  49. final def resolvedAttributes: Iterable[(EName, String)]

    The resolved attributes of the element as mapping from ENames to values

    The resolved attributes of the element as mapping from ENames to values

    Definition Classes
    AbstractIndexedClarkElem → HasENameApi

  50. final def resolvedName: EName

    The EName of the element

    The EName of the element

    Definition Classes
    AbstractIndexedClarkElem → HasENameApi

  51. final def reverseAncestryENames: IndexedSeq[EName]

    Returns the ENames of the ancestry reversed, starting with the root element and ending with the parent of this element, if any.

    Returns the ENames of the ancestry reversed, starting with the root element and ending with the parent of this element, if any.

    That is, returns:

    reverseAncestryOrSelfENames.dropRight(1)
    Definition Classes
    AbstractIndexedClarkElem → IndexedClarkElemApi

  52. final def reverseAncestryOrSelf: IndexedSeq[ThisElem]

    Returns the reversed ancestor-or-self elements.

    Returns the reversed ancestor-or-self elements. That is, returns:

    rootElem.findReverseAncestryOrSelfByPath(path).get
    Definition Classes
    IndexedClarkElem → AbstractIndexedClarkElem → IndexedClarkElemApi

  53. final def reverseAncestryOrSelfENames: IndexedSeq[EName]

    Returns the ENames of the ancestry-or-self reversed, starting with the root element and ending with this element.

    Returns the ENames of the ancestry-or-self reversed, starting with the root element and ending with this element.

    That is, returns:

    rootElem.resolvedName +: path.entries.map(_.elementName)

    This is equal to:

    reverseAncestryOrSelf.map(_.resolvedName)
    Definition Classes
    AbstractIndexedClarkElem → IndexedClarkElemApi

  54. final def rootElem: ThisElem

    The root element

    The root element

    Definition Classes
    IndexedClarkElem → AbstractIndexedClarkElem → IndexedClarkElemApi

  55. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef

  56. final def text: String

    Returns the concatenation of the text values of (the implicit) text children, including whitespace and CData.

    Returns the concatenation of the text values of (the implicit) text children, including whitespace and CData. Non-text children are ignored. If there are no text children, the empty string is returned.

    Therefore, element children are ignored and do not contribute to the resulting text string.

    Definition Classes
    AbstractIndexedClarkElem → HasTextApi

  57. def thisElem: ThisElem

    Definition Classes
    IndexedClarkElem → AnyElemApi

  58. def toString(): String

    Definition Classes
    AnyRef → Any

  59. final def trimmedText: String

    Returns text.trim.

    Returns text.trim.

    Definition Classes
    HasText → HasTextApi

  60. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

  61. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

  62. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Deprecated Value Members

  1. final def elem: U

    Definition Classes
    AbstractIndexedClarkElem
    Annotations
    @deprecated
    Deprecated

    (Since version 1.6.0) Use 'underlyingElem' instead

Inherited from AbstractIndexedClarkElem[U]

Inherited from ClarkElemLike

Inherited from HasText

Inherited from HasEName

Inherited from IsNavigable

Inherited from ElemLike

Inherited from IndexedClarkElemApi

Inherited from ClarkElemApi

Inherited from HasTextApi

Inherited from HasENameApi

Inherited from IsNavigableApi

Inherited from ElemApi

Inherited from AnyElemApi

Inherited from queryapi.Nodes.Elem

Inherited from CanBeDocumentChild

Inherited from Node

Inherited from AnyRef

Inherited from Any

Ungrouped