New methods in Entity

• XML documents may be built from multiple parsed entities, each of which is not necessarily a well-formed XML document, but is at least a plausible part of a well-formed XML document.

• Each entity may have its own text declaration. This is like an XML declaration without a standalone attribute and with an optional version attribute:

  <?xml version="1.0"?>
  <?xml version="1.0" encoding="ISO-8859-9"?>
  <?xml encoding="ISO-8859-9"?>
  

• DOM3 adds:

  encoding

  A string specifying what encoding the the text declaration claims this entity uses. This is null if this entity is not an external parsed entity.

  actualEncoding

  A string specifying the actual encoding of this entity. This is null if this entity is not an external parsed entity.

  version

  A string specifying the XML version given in the text declaration. This is null if this entity is not an external parsed entity.

• Java binding:

  
  package org.w3c.dom;
  
  public interface Entity extends Node {
    
    public String getActualEncoding();
    public void   setActualEncoding(String actualEncoding);
    public String getEncoding();
    public void   setEncoding(String encoding);
    public String getVersion();
    public void   setVersion();
    
  }
  

• In IDL:

  interface Entity : Node {
    attribute DOMString  actualEncoding;
    attribute DOMString  encoding;
    attribute DOMString  version;
  };