Examples of org.apache.axiom.om.OMEntityReference

• org.apache.axiom.om.OMEntityReference
  Represents an unexpanded entity reference in an XML document.

  Different XML APIs and object models handle entity references fairly differently:

  • In DOM, the way entity references in an XML document are processed depends on the setting for {@link DocumentBuilderFactory#setExpandEntityReferences(boolean) expandEntityReferences}. If this property is set to true (default), then the parser will expand entity references and the resulting DOM tree simply contains the nodes resulting from this expansion. If this property is set to false, then the parser will still expand entity references, but the resulting DOM tree will contain {@link EntityReference} nodes, the children of which representthe nodes resulting from this expansion. Note that since an entity declaration may contain markup, the children of an {@link EntityReference} node may have a type other than{@link Node#TEXT_NODE}. Application code not interested in entity references will generally set {@link DocumentBuilderFactory#setExpandEntityReferences(boolean) expandEntityReferences} totrue in order to avoid the additional programming logic required to process {@link EntityReference} nodes.
  • In SAX, the parser will always expand entity references and report the events resulting from this expansion to the {@link ContentHandler}. In addition to that, if a {@link LexicalHandler} isregistered, then the parser will report the start and end of the expansion using {@link LexicalHandler#startEntity(String)} and {@link LexicalHandler#endEntity(String)}. This means that the processing of entity references in SAX is similar to DOM with {@link DocumentBuilderFactory#setExpandEntityReferences(boolean) expandEntityReferences} set tofalse. Note that in SAX there is no corresponding configuration property. This makes sense because an application not interested in entity references can simply ignore the {@link LexicalHandler#startEntity(String)} and {@link LexicalHandler#endEntity(String)} events ornot register a {@link LexicalHandler} at all.
  • In StAX, the way entity references are processed depends on the setting for the {@link XMLInputFactory#IS_REPLACING_ENTITY_REFERENCES} property. If this property is set to true(default), then the parser will expand entity references and report only the events resulting from that expansion. If the property is set to false, then the parser no longer expands entity references. Instead, it will report each entity reference using a single {@link XMLStreamConstants#ENTITY_REFERENCE} event. {@link XMLStreamReader#getText()} can then beused to get the replacement value for the entity. Note that this replacement value may contain unparsed markup. One can see that the way StAX reports entity references is significantly different than DOM or SAX.

  Axiom models entity references in the same way as StAX: the node corresponding to an (unexpanded) entity reference only stores the name of the entity as well as the replacement value.

Related Classes of org.apache.axiom.om.OMEntityReference