Method Detail

• isComplete

  boolean isComplete()

  Indicates whether parser has parsed this information item completely or not. If some info are not available in the item, one has to check this attribute to make sure that, this item has been parsed completely or not.

  Returns:

  Returns boolean.

• build

  void build()

  Builds itself.

• close

  void close(boolean build)

  If a builder and parser is associated with the node, it is closed.

  Parameters:

  build - if true, the object is built first before closing the builder/parser

• serialize

  void serialize(XMLStreamWriter xmlWriter)
                 throws XMLStreamException

  Serializes the information item with caching. This method has the same effect as serialize(XMLStreamWriter, boolean) with cache set to true.

  Parameters:

  xmlWriter -

  Throws:

  XMLStreamException

• serializeAndConsume

  void serializeAndConsume(XMLStreamWriter xmlWriter)
                           throws XMLStreamException

  Serializes the information item without caching. This method has the same effect as serialize(XMLStreamWriter, boolean) with cache set to false.

  Parameters:

  xmlWriter -

  Throws:

  XMLStreamException

• serialize

  void serialize(XMLStreamWriter xmlWriter,
               boolean cache)
                 throws XMLStreamException

  Serializes the information item to the given XMLStreamWriter.

  The implementation of this method must satisfy the following requirements:

  • If the writer exposes the DataHandlerWriter extension, then base64 binary data MUST be written using one of the methods defined by that extension. This will occur if the information item is an OMText node for which OMText.isBinary() returns true or if it is an OMContainer that has such an OMText node as descendant. If the writer doesn't expose the DataHandlerWriter extension, then the implementation MUST use XMLStreamWriter.writeCharacters(String) or XMLStreamWriter.writeCharacters(char[], int, int) to write the base64 encoded data to the stream.
  • The implementation MUST ensure that the produced XML is well formed with respect to namespaces, i.e. it MUST generate the required namespace declarations using XMLStreamWriter.writeNamespace(String, String) and XMLStreamWriter.writeDefaultNamespace(String). This requirement is always applicable, even if the method is used to serialize a subtree or if the object model is not well formed with respect to namespaces. This means that the implementation is expected to implement namespace repairing and that the implementation MUST NOT assume that the XMLStreamWriter supplied by the caller performs any kind of namespace repairing.
  • The implementation MUST take into account the pre-existing namespace context, so that the caller can use this method to serialize the information item as part of a larger document. The implementation uses XMLStreamWriter.getPrefix(String) and/or XMLStreamWriter.getNamespaceContext() to query the pre-existing namespace context.

  On the other hand, the caller of this method must ensure that the following requirements are satisfied:

  • The namespace context information provided by XMLStreamWriter.getPrefix(String) and XMLStreamWriter.getNamespaceContext() MUST accurately reflect the actual namespace context at the location in the output document where the information item is serialized. In practice this requirement means that if the caller writes content to the XMLStreamWriter before calling this method, then it must use XMLStreamWriter.setPrefix(String, String) and XMLStreamWriter.setDefaultNamespace(String) to update the namespace context. Note that this requirement may be relaxed if the caller implements some form of namespace repairing.

  Parameters:

  xmlWriter -

  cache - indicates if caching should be enabled

  Throws:

  XMLStreamException