eu.cdevreeze.yaidom.indexed

Elem

final class Elem extends NavigableElemLike[Elem] with HasQName with HasText with Immutable

An element within its context. In other words, an element as a pair containing the root element (as eu.cdevreeze.yaidom.Elem) and a path (from that root element) to this element.

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

An indexed.Elem(rootElem) 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, using a member type, but such a design has not been chosen.)

Example

Below follows an example. This example queries for all book elements having at least Jeffrey Ullman as author. It can be written as follows, assuming a book store Document with the appropriate structure:

val bookstoreElm = indexed.Document(doc).documentElement
require(bookstoreElm.localName == "Bookstore")

val ullmanBookElms =
  for {
    authorElm <- bookstoreElm filterElems { e =>
      (e.localName == "Author") &&
      ((e.getChildElem(_.localName == "First_Name")).text == "Jeffrey") &&
      ((e.getChildElem(_.localName == "Last_Name")).text == "Ullman")
    }
    bookElm <- authorElm.path findAncestorPath { _.elementNameOption == Some(EName("Book")) } map { path =>
      bookstoreElm.getElemOrSelfByPath(path)
    }
  } yield bookElm

Note how we found an ancestor (Book) element of an Author element by first finding the appropriate ancestor path, and then querying the bookstore element for the element at that path. So we remembered the document element (as indexed element), and used that "snapshot" to navigate to elements at given ancestor paths of other elements. This is certainly more efficient than re-indexing (using an indexed element factory method).

Elem more formally

In order to get started using the class, this more formal section can safely be skipped. On the other hand, this section may provide a deeper understanding of the class.

Let indexedRootElem be a root element, so indexedRootElem.path == Path.Root.

Then, first of all, we have:

indexedRootElem.elem == indexedRootElem.rootElem

Given:

val elems = indexedRootElem.findAllElemsOrSelf
val paths = indexedRootElem.elem.findAllElemOrSelfPaths

the following (rather obvious) properties hold for indexed elements:

elems forall (e => e.rootElem == indexedRootElem.rootElem)

(elems map (_.path)) == paths

elems forall { e => e.rootElem.findElemOrSelfByPath(e.path) == Some(e.elem) }

Analogous remarks apply to the other query methods. For example, given:

// Let p be a predicate of type (yaidom.Elem => Boolean)

val elems = indexedRootElem filterElems { e => p(e.elem) }
val paths = indexedRootElem.elem filterElemPaths p

we have:

elems forall (e => e.rootElem == indexedRootElem.rootElem)

(elems map (_.path)) == paths

elems forall { e => e.rootElem.findElemOrSelfByPath(e.path) == Some(e.elem) }
Linear Supertypes
Immutable, HasText, HasQName, NavigableElemLike[Elem], NavigableElemApi[Elem], ElemLike[Elem], ElemApi[Elem], ParentElemLike[Elem], ParentElemApi[Elem], AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Elem
  2. Immutable
  3. HasText
  4. HasQName
  5. NavigableElemLike
  6. NavigableElemApi
  7. ElemLike
  8. ElemApi
  9. ParentElemLike
  10. ParentElemApi
  11. AnyRef
  12. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Value Members

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

    Definition Classes
    AnyRef → Any

  2. final def ##(): Int

    Definition Classes
    AnyRef → Any

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

    Definition Classes
    AnyRef → Any

  4. final def \(expandedName: EName): IndexedSeq[Elem]

    Shorthand for filterChildElems(expandedName).

    Shorthand for filterChildElems(expandedName).

    Definition Classes
    ElemLike → ElemApi

  5. final def \(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    Shorthand for filterChildElems(p).

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

    Definition Classes
    ParentElemLike → ParentElemApi

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

    Shorthand for attributeOption(expandedName)

    Shorthand for attributeOption(expandedName)

    Definition Classes
    ElemLike → ElemApi

  7. final def \\(expandedName: EName): IndexedSeq[Elem]

    Shorthand for filterElemsOrSelf(expandedName).

    Shorthand for filterElemsOrSelf(expandedName).

    Definition Classes
    ElemLike → ElemApi

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

    Shorthand for filterElemsOrSelf(p).

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

    Definition Classes
    ParentElemLike → ParentElemApi

  9. final def \\!(expandedName: EName): IndexedSeq[Elem]

    Shorthand for findTopmostElemsOrSelf(expandedName).

    Shorthand for findTopmostElemsOrSelf(expandedName).

    Definition Classes
    ElemLike → ElemApi

  10. final def \\!(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    Shorthand for findTopmostElemsOrSelf(p).

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

    Definition Classes
    ParentElemLike → ParentElemApi

  11. final def asInstanceOf[T0]: T0

    Definition Classes
    Any

  12. 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
    ElemLike → ElemApi

  13. 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
    ElemLike → ElemApi

  14. def attributes: IndexedSeq[(QName, String)]

    The attributes of the element as mapping from QNames to values

    The attributes of the element as mapping from QNames to values

    Definition Classes
    Elem → HasQName

  15. def clone(): AnyRef

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

  16. val elem: yaidom.Elem

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

    Definition Classes
    AnyRef

  18. def equals(obj: Any): Boolean

    Definition Classes
    Elem → AnyRef → Any

  19. final def filterChildElems(expandedName: EName): IndexedSeq[Elem]

    Returns the child elements with the given expanded name

    Returns the child elements with the given expanded name

    Definition Classes
    ElemLike → ElemApi

  20. final def filterChildElems(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    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: E => Boolean): immutable.IndexedSeq[E] =
this.findAllChildElems.filter(p)
    Definition Classes
    ParentElemLike → ParentElemApi

  21. final def filterElems(expandedName: EName): IndexedSeq[Elem]

    Returns the descendant elements with the given expanded name

    Returns the descendant elements with the given expanded name

    Definition Classes
    ElemLike → ElemApi

  22. final def filterElems(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    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
    ParentElemLike → ParentElemApi

  23. final def filterElemsOrSelf(expandedName: EName): IndexedSeq[Elem]

    Returns the descendant-or-self elements that have the given expanded name

    Returns the descendant-or-self elements that have the given expanded name

    Definition Classes
    ElemLike → ElemApi

  24. final def filterElemsOrSelf(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    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: E => Boolean): immutable.IndexedSeq[E] =
Vector(this).filter(p) ++ (this.findAllChildElems flatMap (_.filterElemsOrSelf(p)))

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

    Definition Classes
    ParentElemLike → ParentElemApi

  25. def finalize(): Unit

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

  26. def findAllChildElems: IndexedSeq[Elem]

    Returns all child elements, in the correct order.

    Returns all child elements, in the correct order.

    These child elements share the same rootElem with this element, but differ in the paths, which have one more "path entry".

    Definition Classes
    Elem → ParentElemLike → ParentElemApi

  27. final def findAllElems: IndexedSeq[Elem]

    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
    ParentElemLike → ParentElemApi

  28. final def findAllElemsOrSelf: IndexedSeq[Elem]

    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
    ParentElemLike → ParentElemApi

  29. 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
    ElemLike → ElemApi

  30. final def findChildElem(expandedName: EName): Option[Elem]

    Returns the first found child element with the given expanded name, if any, wrapped in an Option

    Returns the first found child element with the given expanded name, if any, wrapped in an Option

    Definition Classes
    ElemLike → ElemApi

  31. final def findChildElem(p: (Elem) ⇒ Boolean): Option[Elem]

    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
    ParentElemLike → ParentElemApi

  32. def findChildElemByPathEntry(entry: Entry): Option[Elem]

    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.

    Definition Classes
    Elem → NavigableElemLike → NavigableElemApi

  33. final def findElem(expandedName: EName): Option[Elem]

    Returns the first found (topmost) descendant element with the given expanded name, if any, wrapped in an Option

    Returns the first found (topmost) descendant element with the given expanded name, if any, wrapped in an Option

    Definition Classes
    ElemLike → ElemApi

  34. final def findElem(p: (Elem) ⇒ Boolean): Option[Elem]

    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
    ParentElemLike → ParentElemApi

  35. final def findElemOrSelf(expandedName: EName): Option[Elem]

    Returns the first found (topmost) descendant-or-self element with the given expanded name, if any, wrapped in an Option

    Returns the first found (topmost) descendant-or-self element with the given expanded name, if any, wrapped in an Option

    Definition Classes
    ElemLike → ElemApi

  36. final def findElemOrSelf(p: (Elem) ⇒ Boolean): Option[Elem]

    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
    ParentElemLike → ParentElemApi

  37. final def findElemOrSelfByPath(path: Path): Option[Elem]

    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. This method must be very efficient, which depends on the efficiency of method findChildElemByPathEntry.

    Definition Classes
    NavigableElemLike → NavigableElemApi

  38. final def findTopmostElems(expandedName: EName): IndexedSeq[Elem]

    Returns the descendant elements with the given expanded name that have no ancestor with the same name

    Returns the descendant elements with the given expanded name that have no ancestor with the same name

    Definition Classes
    ElemLike → ElemApi

  39. final def findTopmostElems(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    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
    ParentElemLike → ParentElemApi

  40. final def findTopmostElemsOrSelf(expandedName: EName): IndexedSeq[Elem]

    Returns the descendant-or-self elements with the given expanded name that have no ancestor with the same name

    Returns the descendant-or-self elements with the given expanded name that have no ancestor with the same name

    Definition Classes
    ElemLike → ElemApi

  41. final def findTopmostElemsOrSelf(p: (Elem) ⇒ Boolean): IndexedSeq[Elem]

    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: E => Boolean): immutable.IndexedSeq[E] =
if (p(this)) Vector(this)
else (this.findAllChildElems flatMap (_.findTopmostElemsOrSelf(p)))
    Definition Classes
    ParentElemLike → ParentElemApi

  42. final def getChildElem(expandedName: EName): Elem

    Returns the single child element with the given expanded name, and throws an exception otherwise

    Returns the single child element with the given expanded name, and throws an exception otherwise

    Definition Classes
    ElemLike → ElemApi

  43. final def getChildElem(p: (Elem) ⇒ Boolean): Elem

    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
    ParentElemLike → ParentElemApi

  44. final def getChildElemByPathEntry(entry: Entry): Elem

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

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

    Definition Classes
    NavigableElemLike → NavigableElemApi

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

    Definition Classes
    AnyRef → Any

  46. final def getElemOrSelfByPath(path: Path): Elem

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

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

    Definition Classes
    NavigableElemLike → NavigableElemApi

  47. def hashCode(): Int

    Definition Classes
    Elem → AnyRef → Any

  48. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any

  49. final def localName: String

    The local name (or local part).

    The local name (or local part). Convenience method.

    Definition Classes
    ElemLike → ElemApi

  50. final def namespaces: Declarations

    Returns the namespaces declared in this element.

    Returns the namespaces declared in this element.

    If the original parsed XML document contained duplicate namespace declarations (i.e. namespace declarations that are the same as some namespace declarations in their context), these duplicate namespace declarations were lost during parsing of the XML into an Elem tree. They therefore do not occur in the namespace declarations returned by this method.

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

    Definition Classes
    AnyRef

  52. final def normalizedText: String

    Returns XmlStringUtils.normalizeString(text).

    Returns XmlStringUtils.normalizeString(text).

    Definition Classes
    HasText

  53. final def notify(): Unit

    Definition Classes
    AnyRef

  54. final def notifyAll(): Unit

    Definition Classes
    AnyRef

  55. val path: Path

  56. def qname: QName

    The QName of the element

    The QName of the element

    Definition Classes
    Elem → HasQName

  57. def resolvedAttributes: IndexedSeq[(EName, String)]

    The attributes as a mapping from ENames (instead of QNames) to values.

    The attributes as a mapping from ENames (instead of QNames) to values.

    The implementation must ensure that resolvedAttributes.toMap.size == resolvedAttributes.size.

    Namespace declarations are not considered attributes in yaidom, so are not included in the result.

    Definition Classes
    Elem → ElemLike → ElemApi

  58. def resolvedName: EName

    Resolved name of the element, as EName

    Resolved name of the element, as EName

    Definition Classes
    Elem → ElemLike → ElemApi

  59. val rootElem: yaidom.Elem

  60. final def scope: Scope

    Returns this.elem.scope

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

    Definition Classes
    AnyRef

  62. def text: String

    Returns the concatenation of the texts of text children, including whitespace.

    Returns the concatenation of the texts of text children, including whitespace. Non-text children are ignored. If there are no text children, the empty string is returned.

    Definition Classes
    Elem → HasText

  63. def toString(): String

    Definition Classes
    AnyRef → Any

  64. final def trimmedText: String

    Returns text.trim.

    Returns text.trim.

    Definition Classes
    HasText

  65. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

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

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

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

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Immutable

Inherited from HasText

Inherited from HasQName

Inherited from NavigableElemLike[Elem]

Inherited from NavigableElemApi[Elem]

Inherited from ElemLike[Elem]

Inherited from ElemApi[Elem]

Inherited from ParentElemLike[Elem]

Inherited from ParentElemApi[Elem]

Inherited from AnyRef

Inherited from Any

Ungrouped