oracle.xml.parser.v2
Interface XMLToken

public interface XMLToken

Basic interface for XMLToken

All XMLParser applications with Tokenizer feature must implement this interface. The interface has to be registered using XMLParser method setTokenHandler(XMLToken handler).

If XMLtoken handler != null then for each registered and found token the parser calls the XMLToken call-back method token(int token, String value). During tokenizing the parser doesn't validate the document and doesn't include/read internal/external entities. If XMLtoken handler == null then the parser parses as usual.

A request for XML token is registered (on/off) using XMLParser method setToken (int token, boolean set). The requests could be registered during the parsing (from inside the call-back method) as well.

The XML tokens are defined as public constants in XMLToken interface. They correspond to the XML syntax variables from W3C XML Syntax Specification.

Field Summary

Type	Field
static int	AttListDecl AttListDecl ::= '<' '!' 'ATTLIST' S Name AttDef* S? '>'
static int	AttName AttName ::= Name
static int	Attribute Attribute ::= AttName Eq AttValue
static int	AttValue AttValue ::= '"' ([^<&"] | Reference)* '"'
static int	CDSect CDSect ::= CDStart CData CDEnd
static int	CharData CharData ::= [^<&]* - ([^<&]* ']]>' [^<&]*)
static int	Comment Comment ::= '<' '!' '--' ((Char - '-') | ('-' (Char - '-')))* '-->'
static int	DTDName DTDName ::= name
static int	ElemDeclName ElemDeclName ::= name
static int	elementdecl elementdecl ::= '<' '!ELEMENT' S ElemDeclName S contentspec S? '>'
static int	EmptyElemTag EmptyElemTag ::= '<' STagName (S Attribute)* S? '/' '>'
static int	EntityDecl EntityDecl ::= '<' '!' ENTITY' S EntityDeclName S EntityDef S? '>'
static int	EntityDeclName EntityValue ::= '"' ([^%&"] | PEReference | Reference)* '"'
static int	EntityValue EntityDeclName ::= Name
static int	ETag ETag ::= '<' '/' ETagName S? '>'
static int	ETagName ETagName ::= Name
static int	ExternalID ExternalID ::= 'SYSTEM' S SystemLiteral
static int	NotationDecl NotationDecl ::= '<' '!NOTATION' S Name S (ExternalID | PublicID) S? '>'
static int	PI PI ::= '<' '?' PITarget (S (Char* - (Char* '?>' Char*)))? '?' '>'
static int	PITarget PITarget ::= Name - (('X' | 'x') ('M' | 'm') ('L' | 'l'))
static int	Reference Reference ::= EntityRef | CharRef | PEReference
static int	STag STag ::= '<' STagName (S Attribute)* S? '>'
static int	STagName STagName ::= Name
static int	TextDecl TextDecl ::= '<' '?' 'xml' VersionInfo? EncodingDecl S? '?>'
static int	XMLDecl XMLDecl ::= '<' '?' 'xml' VersionInfo EncodingDecl? SDDecl? S? '?' '>'

Method Summary

Type	Method
void	token(int token, java.lang.String value) The interface call-back method.

Field Detail

STag

public static final int STag

STag ::= '<' STagName (S Attribute)* S? '>'

EmptyElemTag

public static final int EmptyElemTag

EmptyElemTag ::= '<' STagName (S Attribute)* S? '/' '>'

STagName

public static final int STagName

STagName ::= Name

AttValue

public static final int AttValue

AttValue ::= '"' ([^<&"] | Reference)* '"'

| "'" ([^<&'] | Reference)* "'"

AttName

public static final int AttName

AttName ::= Name

Attribute

public static final int Attribute

Attribute ::= AttName Eq AttValue

ETag

public static final int ETag

ETag ::= '<' '/' ETagName S? '>'

ETagName

public static final int ETagName

ETagName ::= Name

CharData

public static final int CharData

CharData ::= [^<&]* - ([^<&]* ']]>' [^<&]*)

Comment

public static final int Comment

Comment ::= '<' '!' '--' ((Char - '-') | ('-' (Char - '-')))* '-->'

Reference

public static final int Reference

Reference ::= EntityRef | CharRef | PEReference

EntityRef ::= '&' Name ';'

PEReference ::= '%' Name ';'

CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';

CDSect

public static final int CDSect

CDSect ::= CDStart CData CDEnd

CDStart ::= '<' '!' '[CDATA['

CData ::= (Char* - (Char* ']]>' Char*))

CDEnd ::= ']]>'

PI

public static final int PI

PI ::= '<' '?' PITarget (S (Char* - (Char* '?>' Char*)))? '?' '>'

PITarget

public static final int PITarget

PITarget ::= Name - (('X' | 'x') ('M' | 'm') ('L' | 'l'))

XMLDecl

public static final int XMLDecl

XMLDecl ::= '<' '?' 'xml' VersionInfo EncodingDecl? SDDecl? S? '?' '>'

TextDecl

public static final int TextDecl

TextDecl ::= '<' '?' 'xml' VersionInfo? EncodingDecl S? '?>'

DTDName

public static final int DTDName

DTDName ::= name

AttListDecl

public static final int AttListDecl

AttListDecl ::= '<' '!' 'ATTLIST' S Name AttDef* S? '>'

elementdecl

public static final int elementdecl

elementdecl ::= '<' '!ELEMENT' S ElemDeclName S contentspec S? '>'

ElemDeclName

public static final int ElemDeclName

ElemDeclName ::= name

EntityDecl

public static final int EntityDecl

EntityDecl ::= '<' '!' ENTITY' S EntityDeclName S EntityDef S? '>'

| '<' '!' ENTITY' S '%' S EntityDeclName S PEDef S? '>'

EntityDef ::= EntityValue | (ExternalID NDataDecl?)

PEDef ::= EntityValue | ExternalID

EntityValue

public static final int EntityValue

EntityDeclName ::= Name

EntityDeclName

public static final int EntityDeclName

EntityValue ::= '"' ([^%&"] | PEReference | Reference)* '"'

| "'" ([^%&'] | PEReference | Reference)* "'"

NotationDecl

public static final int NotationDecl

NotationDecl ::= '<' '!NOTATION' S Name S (ExternalID | PublicID) S? '>'

ExternalID

public static final int ExternalID

ExternalID ::= 'SYSTEM' S SystemLiteral

| 'PUBLIC' S PubidLiteral S SystemLiteral

Method Detail

token

public void token(int token,
                  java.lang.String value)

The interface call-back method. Receives an XML token and it's corresponding value

Parameters:

token - The XML token constant as specified in the interface.

value - The corresponding substring from the parsed text.