XML for Java Compatibility API 2.0.13

com.ibm.xml.parser
Interface PIHandler


public abstract interface PIHandler

An interface for receiving control when PIs are recognized by the XML4J parser.

This interface is implemented by application programs which want to act on processing instructions imbedded in XML documents.

For example, an application program may want to resolve a PI's public ID to a locally defined resource in order prevent the overhead of retrieving the external resource using the system identifier. In this case, the application is registered with the XML4J parser instance, prior to parsing the input stream, by using the addPIHandler method. Subsequently, the implemented handlePI method will be invoked by the XML4J parser instance when the input stream is read; the implemented handlePI method is responsible for manipulating the passed data.

Version:
Revision: 83 1.4 src/com/ibm/xml/parser/PIHandler.java, parser, xml4j2, xml4j2_0_13
See Also:
Parser.addPIHandler(com.ibm.xml.parser.PIHandler)

Method Summary
 void handlePI(java.lang.String name, java.lang.String data)
          Interface to be implemented for receiving control when PIs are recognized by the XML4J parser.
 

Method Detail

handlePI

public void handlePI(java.lang.String name,
                     java.lang.String data)
Interface to be implemented for receiving control when PIs are recognized by the XML4J parser. Control is transferred after the entire PI is parsed.
Parameters:
name - The first token following the markup.
data - From the character immediately after name to the character immediately preceding the ?>.
See Also:
TXPI, Parser.addPIHandler(com.ibm.xml.parser.PIHandler)

XML for Java Compatibility API 2.0.13