Xalan-J 2.7.1
What's New
Release Notes
Getting Started
Sample Apps
Command Line
Transform API
Usage Patterns
Xalan-J API
Public APIs
Extensions Library
Xalan 2 Design
XSLTC Design
Building a release
Bug Reporting
Contact us
Release notes for Xalan-Java 2.7.1

Xalan-Java 2.7.1 was released in November 2007.

The serializer now has support for DOM Level 3 serialization (LSSerializer) for an XML parser. These changes are seen in the new class org.apache.xml.serializer.DOM3Serializer and the new package org.apache.xml.serializer.dom3 as well as a new method, asDOM3Serializer() on the older org.apache.xml.serializer.Serializer interface.

More details are in the javadoc of those classes and interfaces.

The distributions contain upgraded versions of xercesImpl.jar (Xerces-J 2.9.0) and xml-apis.jar (XML Commons External 1.3.04). The distributions were tested with these versions of Xerces-J and XML Commons External and are the recommended versions to use with the release.

Important: You may experience unpredictable anomalies if your Xalan-Java and Xerces-Java builds are not in synch.

Xalan-Java 2.7.1 contains the following functional enhancements, performance enhancements and bug fixes since 2.7.0:

Release notes for Xalan-Java 2.7.0

Xalan-Java 2.7.0 was released on August 8, 2005.

Xalan-Java 2.7.0 contains the following functional enhancements, performance enhancements and bug fixes since 2.6.0.

Support for JAXP 1.3

Support for JAXP 1.3 has been introduced in this release of Xalan-Java. JAXP 1.3 includes a new javax.xml.xpath package, which provides an object-model neutral API for the evaluation of XPath expressions and access to the evaluation environment. Please refer to Using the JAXP 1.3 XPath API for details on how to use the new XPath API. You can also look at the code in the samples ApplyXPathJAXP , XPathResolver and ExtensionFunctionResolver.

There are also a few new transformer features in JAXP 1.3, as described in the following list:

  • A new method TransformerFactory.setFeature(String name, boolean value)
  • A new method Transformer.reset()
  • A new nextSibling attribute is introduced for DOMResult, accessible by the constructors, getter and setter methods.
  • Support for the secure processing feature

  • New default error handling behavior
      The behavior of the default ErrorListener was changed in this release of Xalan-Java, in order to conform with a clarification of the required behavior described by JAXP 1.3. If an application does not register its own ErrorListener, the default ErrorListener is used which reports all warnings and errors to System.err and does not throw any Exceptions. Applications are strongly encouraged to register and use ErrorListeners that insure proper behavior for warnings and errors. The default ErrorListener of the old Xalan-Java Interpretive processor throws exceptions on errors and fatal errors. If your code expects exceptions to be thrown on errors and fatal errors, you have to set a customized ErrorListener on TransformerFactory and/or Transformer. You can use org.apache.xml.utils.DefaultErrorHandler as a sample ErrorListener implementation.

    Support for XML 1.1

    This release of Xalan-Java adds support for Namespaces in XML 1.1 and XML 1.1 output documents. The processors:

  • support C0 control characters
  • handle C1 control characters in a way that is consistent with the requirements of XML 1.1
  • treat NEL (U+0085) and LSEP (U+2028) as end-of-line markers
  • support Internationalized Resource Identifiers (IRIs)
  • support the additional characters in NCNames and QNames permitted by XML 1.1 and Namespaces in XML 1.1
  • The processors do not undeclare namespaces other than the default namespace in serialized documents Also, Full normalization is not supported.

    An input document can be either XML 1.0 or XML 1.1. Also, a stylesheet document can be either XML 1.0 or XML 1.1. A stylesheet document must conform to the XSLT 1.0 specifications.

    Note that it is possible for a stylesheet module that is an XML 1.1 document to use constructs that cannot be serialized as part of a valid XML 1.0 document, and for a stylesheet module that is an XML 1.0 document to use constructs that cannot be serialized as part of a valid XML 1.1 document. For example, a stylesheet module that is an XML 1.1 document might contain a literal result element whose name contains characters that are not permitted as part of a QName in a document that conforms to Namespaces for XML 1.0. The user needs to ensure that the nodes created by the stylesheet can be serialized as part of a well-formed document of the required version of XML.

    Support for Alternative BSF Implementations

    Extensions written in Java are directly supported by Xalan-Java. For extensions written in languages other than Java, Xalan-Java uses the Bean Scripting Framework (BSF), an architecture for incorporating scripting into Java applications and applets, and an implementation of BSF must be available on the classpath. In previous releases, IBM's BSF implementation (bsf.jar from 2001) has been included in the Xalan-Java distribution. Some time ago IBM donated their BSF implementation to the Apache Jakarta BSF project. As of this release, the IBM bsf.jar is no longer included in the Xalan-Java distribution. To use extensions written in languages other than Java, please download a version of Jakarta BSF and put it on your classpath. To use a different BSF implementation, please refer to setting the BSFManager.

    New serializer.jar

    In this release of Xalan-Java the code related to serialization of output result trees has been pulled out of xalan.jar and moved into a new jar file, named serializer.jar.

    The code in serializer.jar has been modified to have no build or runtime dependencies on the rest of the code in Xalan-Java, therefore, serializer.jar can be used in a stand-alone fashion through its public APIs. Although the code has been modified to create a stand-alone jar, the serializer public APIs have not changed and the package names and classnames are the same as they were last release.

    Also the following:

    Release notes for Xalan-Java 2.6.0

    Xalan-Java 2.6.0 was released on February 29, 2004 (a leap year!).

    Xalan-Java 2.6.0 contains the following functional enhancements, performance enhancements and bug fixes since 2.5.2:

    • Improvement in translet initialization time.
    • Addition of a translet versioning mechanism. If the translet version detected by the XSLTC runtime is more recent than any supported by the XSLTC runtime, an error will be reported.
    • Changes that allow XSLTC to use other DTM implementations.
    • Release notes for the XML Serializer. The serializer will no longer put a newline after the xml header tag unless indent="yes". See bugzilla 24304.
    • Rename of Xalan Java's xalan:doc-cache-off processing instruction to xalan-doc-cache-off. This change was necessary due to a recent change in Xerces. Xerces has started detecting the Namespace well-formedness rule that a processing instruction's PITarget must not contain a colon. The old-style PI (xalan:doc-cache-off) will be accepted provided that the XML parser does not report it as an error. See bugzilla 26217.
    • Enhancement to XSLTC's URIResolvers and the general mechanism to resolve relative URIs. XSLTC is now compatible with Xalan Intepretive.
    • Addition of a TransformThread sample that demonstrates how to use different transformers on different threads and in different modes.
    • Upgrade to Xerces-J (2.6.2) and a new version of xml-commons (xml-commons-external-1.2.01)
    • Elimination of "enum" as a name to allow compilation under JDK 1.5
    • Bugzilla fixes: 797, 1396, 5761, 15140, 16889, 18351, 19194, 19464, 22376, 23046, 23591, 24278, 24111, 24187, 24188, 24302, 24304, 24365, 24414, 24518, 24695, 24728, 24788, 24793, 24958, 24979, 24985, 24988, 25368, 25416, 25442, 25449, 25816, 25924, 26019, 26030, 26075, 26169, 26217, 26697, 26742, 26829, 26842
    • For a list of Xalan-Java commits, see xalan-cvs@xml.apache.org in the Apache mail archives.

    Release notes for Xalan-Java 2.5.2

    Xalan-Java 2.5.2 was released on October 30, 2003.

    Xalan-Java 2.5.2 contains bug fixes and performance enhancements since 2.5.1.

    Fixes in this release include the following:

    Release notes for Xalan-Java 2.5.1

    Xalan-Java 2.5.1 was released on June 3, 2003.

    Xalan-Java 2.5.1 contains bug fixes and performance enhancements since 2.5.0.

    Fixes in this release include the following:

    Release notes for Xalan-Java 2.5.0

    Xalan-Java 2.5.0 was released on April 16,2003.

    Xalan-Java 2.5.0 contains a variety of features, bug fixes and performance enhancements since 2.5.D1.

    New features in Xalan-Java 2.5.0 include:

    • integration of the Document Table Model (DTM) with the XSLTC processor [Henry Zongaro, Morris Kwan] and
    • integration of the Xalan Interpretive and Xalan Compiled serializers into a common serializer [Brian Minchau].
    These features have been driven by a need to get common behavior, improve maintainability, reduce duplication of effort for future work, and in some cases improve performance and conformance.

    Refer to What's New for a description of the new function and History of software changes for a list of the various bug fixes and other enhancements in this release.

    Release notes for Xalan-Java 2.5.D1

    Xalan-Java 2.5.D1 was released on March 3, 2003.

    This developer's release, Xalan-Java 2.5.D1, has changes since 2.4.1 and is primarily for the purpose of releasing various bug fixes to the community. These will eventually be released officially in a future Xalan-Java 2.5 version, along with some new function.

    Fixes in this release include the following:

    Release notes for Xalan-Java 2.4.1

    Xalan-Java 2.4.1 was released on October 31, 2002 (Halloween!).

    • Performance fixes and enhancements to address the degradation of performance between Xalan-Java version 2.3.1 and Xalan-Java 2.4.0.
    • A prototype implementation of the DOM Level 3 XPath Specification. The implementation is considered 'experimental' at this time due to the status of the specification. See the new sample, ApplyXPathDOM for an example of how to use this API.
    • Extension changes and enhancements:
      • Implement canonical namespaces for all Xalan extensions. All extensions now use namespaces starting with http://xml.apache.org/xalan. The old namespaces are still supported for backward compatibility. See the updated extensions documentation for details.
      • Added new EXSLT extension functions, including the EXSLT dynamic extension functions max, min, sum, map, evaluate and closure, the EXSLT strings extension functions align, concat, padding, split and tokenize, and some new extension functions in the math module.
      • Reorganized the extension functions for new EXSLT extensions. The implementation of some extension functions (intersection, difference, distinct, evaluate and tokenize) are moved from the main Extensions class to the corresponding EXSLT modules.
      • Enable the EXSLT extensions for XSLTC. The EXSLT common, math, sets, dates-and-times and strings modules can be used in XSLTC.
      • Integration of the nodeset and redirect extension for XSLTC. You can now use Xalan namespaces for these extensions in XSLTC.
      • Enhancement in Java extenion for XSLTC. Three namespace formats (Java, package and class) can all be used in XSLTC. More type conversion rules are added as well.
    • Enable support for invoking transformations using the Xalan compiler (XSLTC) via the Xalan interpretive Process command line. Specifically, the -XSLTC option was added. The -TT, -TG, -TS, -TTC, -QC, -L, -INCREMENTAL, -NOOPTIMIZE and -RL option do not work in XSLTC mode. All other existing options can be used with -XSLTC. Additional options were added to enable XSLTC compile and transform modes: -XO, -XD, -XJ, -XP, -XN, -XX, -XT. See the Process usage statement for more information on these options.
    • Fixed SQL Extension problem where a query that returned zero rows would incorrectly return a JDBC exception.
    • Fixed a limitation for XPath expressions. The token queue and operations map can now grow to accomodate really large XPath expressions.
    • Fixes for the following bugzilla defects: 4344, 5046, 6181, 6927, 7161, 7357, 8175, 8473, 8939, 9731, 9959, 10176, 10384, 10414, 10643, 11073, 11341, 11661, 11743, 11809, 12077, 12127, 12298, 12687, 13059, 13303, 13305, 13106, 13501, 13711, 13754, 13863, 13944, 14022
    • Support for and bundling of Xerces Java 2.2.
    • Support for and bundling of xml-apis.jar from the factoryfinder-build of the RIVERCOURT1 branch of xml-commons. This version of the Java APIs for XML Processing successfully passes the JAXP 1.1 and JAXP 1.2 TCKs.
    • For a list of Xalan-Java commits, see xalan-cvs@xml.apache.org in the Apache mail archives.
    • Support building Xalan with JDK 1.4.

    Release notes for Xalan-Java 2.4.0

    Xalan-Java 2.4.0 was released on September 3, 2002.

    • Fixes for the following bugzilla defects : 3238, 4603, 5013, 5016, 5941, 6071, 6268, 6284, 6356, 6547, 6798, 6833, 6925, 6972, 7023, 7118, 7123, 7157, 7410, 7776, 8324, 8358, 8551, 8894, 9068, 9137, 9146, 9171, 9174, 9179, 9572, 9575, 9683, 9753, 10137, 10306, 10323, 10625, 10715, 10832, 10837, 10839, 10914, 10945, 11123, 11166, 11221, 11345, 11704, 11987, 11828, 12075
    • .
    • Xalan-Java now uses a list of supported encodings in a properties file (org.apache.xml.serializer.Encodings.properties). Fixes Bugzilla 6356. Patch from Sergey Ushakov.
    • Support for the EXSLT function and result elements, and EXSLT date-and-time functions.
    • Improvements to the extensions mechanism to more efficiently handle the detection and analysis of extensions during the stylesheet "composition" process, and the generation of the required extension handlers during initialization of the transformation process.
    • Performance improvement. Instead of looping through the ExtendedType objects, use a hashtable and go directly to the correct object.
    • Separation of source and messages. Messages have been moved into property files for easier localization.
    • XSLTC version upgraded from 1.0 to 1.2.
    • Support for and bundling of Xerces Java 2.1.
    • Support for and bundling of xml-apis.jar from the RIVERCOURT1 branch of xml-commons. This version of the Java APIs for XML Processing successfully passes the JAXP 1.1 and JAXP 1.2 TCKs.
    • For a list of Xalan-Java commits, see xalan-cvs@xml.apache.org in the Apache mail archives.

    Other points of interest
    • Xalan Java 2 is integrated with release 2 of Xerces-Java. Xalan-Java Version 2.7.1 does not include support for the deprecated Xalan-Java 1 compatability API. The Xalan-Java 1 compatability code does NOT compile with Xerces-Java 2.

    • The SQL extension samples continue to use InstantDB, but based on our realization of changes that have occurred in the licensing of InstantDB, we no longer include InstantDB and the associated sample database with our distibution. We do, however, provide information on how to set up InstantDB to support our SQL extension samples.

    • Documentation updates: We have subdivided the release notes into multiple files to accelerate HTML document loading, and we have added a document on Transform features.

    • If an attempt is made to coerce a different namespace onto a prefix already in use in xsl:attribute, the attribute will come out in the wrong namespace. Workaround: either provide an NCName instead of a QName for the attribute, or provide a QName with a prefix not used elsewhere.

    • Handling xsl:namespace-alias declarations: In release 2.0.D01, we reported the need to do some research concerning exactly how Xalan should handle xsl:namespace-alias declarations. As a result of discussions among members of the W3C Working Group on XSL, we have reached a more precise consensus on how namespaces should be represented when an xsl:namespace-alias declaration is in effect.

      If a literal result element has a namespace prefix, the prefix will be preserved and the namespace URI of the element will be as specified in the xsl:namespace-alias element, but the result-prefix is not required to appear in the result. This also applies to the two other cases of "Literal namespace URI" mentioned in the XSLT Recommendation on Literal Result Elements. More simply, if the stylesheet calls for <axsl:foo> to be output as a literal result element, then it will be output as <axsl:foo> in the result, but the namespace associated with this "axsl" prefix will be as designated in the xsl:namespace-alias declaration.

    • For HTML output, Xalan-Java 2 outputs character entity references (&copy; etc.) for the special characters designated in Appendix A. DTDs of the XHTML 1.0: The Extensible HyperText Markup Language. Xalan-Java 1.x, on the other hand, outputs literal characters for some of these special characters.

    • In conformance with the XSLT Recommendation on the HTML Output Method and Section B.2.1 of the HTML 4.0 Recommendation, Xalan-Java 2 uses %hh encoding for each byte of the UTF-8 representation of non-ASCII characters in HTML URI attributes.

    • When your stylesheet asks for an explicit carriage-return character (&#13;) to be inserted into the output, it is output during the serialization process in escaped form unless escaping has been disabled. When your stylesheet asks for an explicit line-feed character (&#10;) to be output, the system-default line-break character(s) is/are output during the serialization process. Also keep in mind that the XML parser normalizes line-breaks to line-feeds when it sends character events to the processor.

    • If your XML input is a DOM, use the javax.xml.parsers.DocumentBuilderFactory setCoalescing() method to set coalescing to true (it is false by default), if you want to append CDATA sections to adjacent text sections to form a single text node (as the XPath standard calls for), and if the XML parser supports this feature (Xerces-Java 2.9.0 does not).

    • When you traverse the namespace axis for a collection of element nodes, Xalan-Java includes one namespace node for each namespace in scope for one or more of the nodes in that collection. The XPath expression does not return additional (redundant) namespace nodes for each element for which the namespace nodes are in scope.

    • See Bugzilla bug 2291 for a discussion of issues surrounding use of the default character encoding to read META-INF/Services.

    • As Bugzilla bug 1800 reports, the Transformer does not get the setTransformState event until after the startDocument event. This could present a problem for tools developers, and we do intend to fix this bug.

    Copyright © 2006 The Apache Software Foundation. All Rights Reserved.