XML Parser for Java Release History

Table C-4 lists the XML Parser for Java release history:

Table C-4 XML Parser for Java V2: Release History  

Release	Description
Oracle XML Parser 2.0.2.?	New API in Parser class: reset() : Reset the internal DOM data structures New API in XMLDocument class: print(PrintDriver): Customization of the print functionality New Interface: PrintDriver : Interface for customizing print XMLPrintDriver class : Default implementation of PrintDriver
2.0.2.?	Changes: New builtin extension element: ora:output, where xmlns:ora="http://www.oracle.com/XSL/Transform/java". This element can be used a top-level element similar to xsl:output (can have all attribute allowed in xsl:output, and has similar functionality). It has an additional attribute 'name' used an an identifier. When ora:output is used in a template, it can have only two attribute 'use' and 'href'. 'use' attribute specifies the top-level ora:output to be used, and 'href' gives the output URL. New builtin extension function: ora:node-set, where xmlns:ora="http://www.oracle.com/XSL/Transform/java" ora:node-set function converts a result tree fragment into a node-set.
2.0.2.7.0	Changes: New command line interface to parse XML documents has been added to bin directory. See bin/readme.html for details. Debugging support has been added to XSL-T processing. The errors / warnings include the system identifier, line number, and column number in debug mode. You can either use DOMParser.setDebugMode(boolean) or use Java system property 'oracle.xml.parser.debugmode' to set the debug mode.
2.0.2.7.0/...	New API in DOMParser class: setDebugMode(boolean flag) New API in XMLDocument class: setDoctype(String rootname, String sysid, String pubid) - Adds DOCTYPE declaration to the XML Dcoument.
2.0.2.6	Changes: Conformance to the XSLT/XPATH October REC. New API in XSLStylesheet class: removeParam(String param) resetParams()
2.0.2.5	Changes: Conformance to the XSLT/XPATH October PR. Support for internationalized error messages has been added. The locale can be set using setLocale(java.util.Locale) function in XSLProcessor, SAXParser, and DOMParser. The following locales are supported: Country Language Country Code Language Code ARGENTINA SPANISH AR es BRAZIL BRAZILIAN PORTUGUESE BR pt CHINA CHINESE CN zh CZECH REPUBLIC CZECH CZ cs DENMARK DANISH DK da FINLAND FINNISH FI fi FRANCE FRENCH FR fr GERMANY GERMAN DE de GREECE GREEK GR el HUNGARY HUNGARIAN HU hu ISRAEL HEBREW IL iw ITALY ITALIAN IT it JAPAN JAPANESE JP ja
	Country Language Country Code Language Code KOREA KOREAN KR ko NORWAY NORWEGIAN NO no POLAND POLISH PL pl PORTUGAL PORTUGUESE PT pt ROMANIA ROMANIAN RO ro
	RUSSIA RUSSIAN RU ru SLOVAKIA SLOVAK SK sk SPAIN CATALAN ES ca SPAIN SPANISH ES es SWEDEN SWEDISH SE sv
	TAIWAN CHINESE TW zh THE NETHERLANDS DUTCH NL nl TURKEY TURKISH TR tr UNITED ARAB EMIRATES ARABIC AE ar UNITED STATES ENGLISH US en
	New APIs in XMLNode class: value-of(String pattern) selectNodes(String pattern) selectSingleNode(String pattern) selectSingleNode(String pattern, NSResolver ns) New API in XSLStylesheet class setParam(String param, String value)
2.0.2.4.0	XSL URI constant is now: http://www.w3.org/1999/XSL/Transform Extension functions namespace has changed from http://www.oracle.com/oracle.xml.parser/xsl/java/classname to http://www.oracle.com/XSL/Transform/java/classname
2.0.2.3.0	Extension functions support was added, that allows users of the XSL processor to call any Java method from XSL expressions. Please refer to extfunc.html for more details on Extension functions.
2.0.2.2.0	New API in XSLProcessor class to support xsl:output element: processXSL(XSLStylesheet xsl, XMLDocument xml, OutputStream out) processXSL(XSLStylesheet xsl, XMLDocument xml, PrintWriter pw) processXSL(XSLStylesheet xsl, XMLDocumentFragment xml, OutputStream out) processXSL(XSLStylesheet xsl, XMLDocumentFragment xml, PrintWriter pw)
2.0.2.1.0	Changes: Bug#992758: Fix in invalid character detection. Bug#995394: Fix in forward referencing of IDs. Bug fix in XPath Boolean and Number expression parsing. Bug fix in XSL:Number with empty count attribute. This is the first production patch release for v2.
2.0.2.0.0	Changes: Conformance to the XSLT/XPATH August WD. Note: There are several changes between April99 XSL-T draft and the August99 XSL-T/Xpath draft and these changes have been implemented in the XSL Processor. The XSL Processor has been modified to accept XPath syntax for expressions and patterns. Stylesheets might have to be modified to be conformant to the August XSL-T/XPath draft before they can be used with this release. Some of the changes between the April and August draft are: Expressions in the stylesheet must match the XPath production Expr. Some of the attribute names and element names in XSL namespace have changed. Some new functions have been added to XPath CORE function library. Refer to the August XSL-T/XPath draft for more details. This is the first production release for v2.
	Changes: Note the command line version of 'oraxsl' which can be used in scripts and can specify multiple # of threads has been added to the bin directory. Note that the 'xmlparser.jar' file name has been changed to 'xmlparserv2.jar' to allow co-existence with v1 Java XML parser. Bug fixes for #972862, i.e., DOM exception when the DTD is cached rather than loaded everytime for multiple files; #968640, i.e., support for character set encoding names that are non-IANA; #929682, i.e., a command-line version of XSLT is now bundled (see the bin directory); #978320, i.e., error adding nodes to a cloned document using CloneNode() method; for problems with attribute validation/setDTD/parseDTD. Improved Lexer. With JDK 1.6, the parser seems to have better performance overall because of changes in the lexical analyzer. New Interface: XMLToken. Applications can register an interface handle and the interface callback method 'token()' receives XML tokens registered and found by the parser. XML tokens are defined as interface constants. They are:   STagName,   EmptyElemTag,   STag,   ETag,   ETagName,   Attribute,   AttName,  AttValue,   Reference,   Comment,   CharData,   CDSect,
	PI,   PITarge,   XMLDecl,   TextDecl,
	DTDName,   AttListDecl,   elementdecl,   ElemDeclName,   EntityDecl,   EntityDeclName,   EntityValue,   NotationDecl,   ExternalID.
	The tokens above correspond to the syntax variables from W3C XML specifications. New API in the following Classes: 1. oracle.xml.parser.         -setTokenHandler (XMLToken handler). Sets XMLtoken interface handler.         -setToken (int token, boolean val). Registers on/off XML token.
2.0.0.1.0	Changes: Bug fixes for #920536, i.e. Cannot access element attributes via XSLT; #898423. i.e. ElementDecl's in DTDs; #774774, i.e. DOM extensions using XSL pattern matching; #863890 i.e. SAX IOException not thrown. API in the following new interface: 1. oracle.xml.parser.v2.NSResolver resolveNamespacePrefix( find the namespace definition in scope for a given namespace prefix ) New APIs in the follo- selectNodes( Selects nodes from the tree which match the given pattern; client can provide an NSResolver implementation to resolve namespace prefixes in the pattern ). 2. oracle.xml.parser.v2.ElementDecl getParseTree( Returns the root Node of Content Model parse tree, which could then be traversed node by node using getFirstChild() and getLastChild(). The Node types are: PLUS, COMMA, ASTERISK, ELEMENT, QMARK ). This is the first beta patch release for v2. wing classes: ???? 1. oracle.xml.parser.v2.XMLNode
2.0.0.0.0	The Oracle XML v2 parser is an early beta release and is written in Java.  It features an improved architecture over the Oracle XML V1 parser and has shown better performance on small to large XML documents.  It will also be able to format the XML document according to a stylesheet, having integrated an XSLT processor.  Note: Several of the package names and error messages are different than in the v1 of the parser.  See below and v2changes.txt and the .diff difference files in the sample directory. Version 2 of the XML Parser for Java, besides incorporating an XSLT processor, has been re-architected from version 1. This has resulted in a number of changes to the class names especially those that support Namespaces. The following is a summary:
	NOTE: This summary is based upon XML Parser versions v1.0.1.4 as v1 and v2.0.0.0 as v2. NEW CLASS STRUCTURE The oracle.xml.parser package has been renamed to oracle.xml.parser.v2. The following are the new interfaces: NSName XMLDocumentHandler The following interfaces have been removed: NSAttr NSAttributeList NSDocumentHandler NSElement The following are the new classes in v2: DOMParser DefaultXMLDocumentHandler SAXAttrList SAXParser XSLProcessor XSLStylesheet XSLException