4.9 Entity References and CDATA

The LexicalHandler interface introduces the methods
- startEntity(String name)
- endEntity(String name)
for handling events raised by entities of known meaning.
The method
- setFeature(String name, boolean value)
of XMLReader may request the parser to skip unrecognized entity names by setting the standard feature flag ‘http://xml.org/sax/features/external-general-entities’ to false.
The
- skippedEntity(String name)
method of the ContentHandler interface may be used for catching skipped entity events.
Parsers are not obliged to honor setFeature requests for ignoring entities.
For handling CDATA events the LexicalHandler interface introduces the methods
- startCDATA()
- endDTD()

<..trace recognized entities and CDATA events ..>

public void startEntity(String name) throws SAXException {
      char ch;
   if     ( name.equals("lt")   ){ ch = '<'; }
   else if( name.equals("gt")   ){ ch = '>'; }
   else if( name.equals("quot") ){ ch = '"'; }
   else if( name.equals("amp")  ){ ch = '&'; }
   else if( name.equals("apos") ){ ch = '\''; }
   else { return; }
   System.out.print( ch );
}
public void endEntity(String name) throws SAXException {
   System.out.println( "   &" + name + ';' );
}
public void startCDATA(){ System.out.print( "<![CDATA[" );}
public void endCDATA(){ System.out.println( "]]>" );}

-_-_-

<?xml version="1.0" encoding="UTF-8"?>
<entity-names>
  <entity><</entity>
  <entity>></entity>
  <entity>"</entity>
  <entity>&</entity>
  <entity>'</entity>
  Not: <, >, ...
  <![CDATA[and <, >, ...]]>
</entity-names>

<   <
>   >
"   "
&   &
'   '
<![CDATA[]]>

<..register a handler for non recognized entities ..>

xmlReader.setFeature(
"http://xml.org/sax/features/external-general-entities",
false
);
xmlReader.setContentHandler( new MyContentHandler() );

-_-_-

[next] [prev] [prev-tail] [front] [up]