Edit D:\app\Administrator\product\11.2.0\dbhome

Edit D:\app\Administrator\product\11.2.0\dbhome_1\xdk\readme.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>

 <meta content="text/html; charset=windows-1252"
 http-equiv="CONTENT-TYPE">
 <title>Oracle XML Developers Kit</title>
 <meta content="OpenOffice.org 1.1.0 (Win32)" name="GENERATOR">
 <meta content="20041210;15044434" name="CREATED">
 <meta content="20041210;16111573" name="CHANGED">

</head>
<body bgcolor="#ffffff" dir="ltr" lang="en-US">
<h1>Oracle XML Developers Kit</h1>
<h3>Release Notes for Version 11g Release 2 (11.2.0.1.0) Production 
</h3>
June 3, 2009 
<hr>
Contents 
<a href="#Overview">1 Overview</a> 
<a href="#Java%20XDK">2
XDK Java Components</a> 
<a href="#C%20XDK">3 XDK C/C++ Components</a>
 
<a href="#Compatibilty">4 Compatibility</a> 
<a href="#Known%20Bugs">5
Known Bugs</a>

<hr>
<a name="Overview"></a>1 Overview

Oracle XML Developer's Kit (Oracle XDK) is a set of components,
tools and utilities that eases the task of building and deploying
XML-enabled applications. To provide a broad variety of deployment
options, the Oracle XDK components are available for Java, C, and
C++. Unlike many shareware and trial XML components, the production
Oracle XDK are fully supported and come with a commercial
redistribution license. Oracle XDK consists of the following
components: 
<ul>
 <li>
 XML Parsers: supporting Java, C, and
C++, the components create and parse XML using industry standard DOM
and SAX interfaces. 
 </li>
 <li>
 XSLT Processor: transforms or
renders XML into other text-based formats such as HTML. 
 </li>
 <li>
 XSLT VM: high performance XSLT
transformation engine in C. 
 </li>
 <li>
 XML Schema Processor: schema
validation in Java, C, and C++, allows use of XML simple and complex
datatypes. 
 </li>
 <li>
 XML Class Generator: automatically
generates C++ classes from DTDs and XML Schemas to send XML data from
Web forms or applications. 
 </li>
 <li>
 XML JAXB Class Generator:
automatically generates Java classes from XML Schemas to send XML data
from Web forms or applications. 
 </li>
 <li>
 XML Java Beans: visually transform,
diff and compress XML documents via Java components. 
 </li>
 <li>
 XML SQL Utility: generates XML
documents, DTDs and Schemas from SQL queries in Java. 
 </li>
 <li>
 XSQL Servlet: combines XML, SQL, and
XSLT in the server to deliver dynamic web content. 
 </li>
 <li>
 XML Pipeline processor: specifies
Java processes to be executed in a declarative manner. 
 </li>
 <li>
 TransX Utility: makes it easier to load translated seed data and
messages into the database. 
 </li>
</ul>
Please post any questions, comments, or
bug reports to the XML Forum on the Oracle Technology Network at
<a href="http://otn.oracle.com/tech/xml/xdkhome.html">http://otn.oracle.com/tech/xml/xdkhome.html</a>.&nbsp;

<hr>
<a name="Java XDK"></a>2 XDK Java Components

Oracle XDK Java components are built on W3C Recommendations and
Java JSR standards. The list of currently supported standards are: 
<ul>
 <li>
 <a
 href="http://www.w3.org/TR/REC-xml">XML 1.0 (Second Edition)</a> 
 </li>
 <li>
 DOM Level 2.0 Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/DOM-Level-2-Core">DOM Level 2.0 Core</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range">DOM Level 2.0
Traversal and Range</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/DOM-Level-2-Events">DOM Level 2.0 Events</a>
 
 </li>
 </ul>
 </li>
 <li>
 DOM Level 3.0 Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/">DOM Level
3.0 Load and Save</a>(Candidate Recommendation) 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Val-20030730/">DOM
Level 3.0 Validation</a>(Candidate Recommendation) 
 </li>
 </ul>
 </li>
 <li>
 <a href="http://www.saxproject.org/">SAX
2.0 &amp; SAX Extensions</a> 
 </li>
 <li>
 XSLT/XPath Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT) 1.0</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/xpath">XML Path Language (XPath) 1.0</a> 
 </li>
 </ul>
 </li>
 <li>
 XSLT/XPath 2.0 Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/2004/WD-xslt20-20041105/">XSL
Transformations (XSLT) 2.0</a>(working draft dated 04 April 2005) 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/2005/WD-xpath20-20050404">XML Path Language
(XPath) 2.0</a>(working draft dated 04 April 2005) 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/2005/WD-xpath-datamodel-20050404/">XPath
2.0 Data Model</a>(working draft dated 04 April 2005) 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/2005/WD-xpath-functions-20050404/">XQuery
1.0 and XPath 2.0 Functions and Operators</a>(working draft dated 04
April 2005) 
 </li>
 </ul>
 </li>
 <li>
 XML Schema Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/xmlschema-0/">XML Schema Part 0: Primer</a>
 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/xmlschema-1/">XML Schema Part 1: Structures</a>
 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/xmlschema-2/">XML Schema Part 2: Datatypes</a>
 
 </li>
 </ul>
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/2002/NOTE-xml-pipeline-20020228/">XML
Pipeline Definition Language 1.0</a> 
 </li>
 <li>
 <a
 href="http://java.sun.com/xml/jaxp/index.html">Java API for XML
Processing 1.2</a> 
 </li>
 <li>
 <a href="http://java.sun.com/xml/jaxb/index.html">Java
Architecture for XML Binding 1.0</a> 
 </li>
</ul>
 
2.1 DOM Specifications 
The DOM APIs include support for Candidate Recommendations of DOM
Level 3 Validation and DOM Level 3 Load and Save. 
Load and Save 
The following configuration parameters are not supported by
LSParser: 
<ul>
 <li>
 "charset-overrides-xml-encoding" 
 </li>
</ul>
Optional settings of the following configuration parameters are
not supported by LSParser: 
<ul>
 <li>
 "disallow-doctype (true)" 
 </li>
 <li>
 "ignore-unknown-character-denormalizations
(false)" 
 </li>
 <li>
 "namespaces (false)" 
 </li>
 <li>
 "supported-media-types-only (true)" 
 </li>
</ul>
The following configuration parameters are not supported by
LSSerializer: 
<ul>
 <li>
 "discard-default-content" 
 </li>
</ul>
Optional settings of the following configuration parameters are
not supported by LSSerializer: 
<ul>
 <li>
 "canonical-form (true)" 
 </li>
 <li>
 "format-pretty-print (true)" 
 </li>
 <li>
 "ignore-unknown-character-denormalizations
(false)" 
 </li>
 <li>
 "normalize-characters (true)" 
 </li>
</ul>
Validation 
Some DOM 3 Core functions referred by Validation are implemented,
but Core itself is not supported. 
<ul>
 <li>
 &nbsp;&nbsp;&nbsp;&nbsp; NameList
and DOMStringList in DOM core are supported for validation purpose 
 </li>
 <li>
 &nbsp;&nbsp;&nbsp;&nbsp; Validation is based on XMLSchema, DTD
needs to be converted to Schema first (use DTDToSchema utility) 
 </li>
</ul>
2.2 XSL Transformation 
The XSLT processor adds support for the current working drafts of
XSLT 2.0, XPath 2.0 and the shared XPath/XQuery data model. 
Some features of these specifications are not supported in the
current release: 
<ul>
 <li>
 The Schema Import and Static
Typing features are not supported, but we do support XML Schema
built-in types specified by the XPath 2.0 Datamodel.
 </li>
 <li>The schema-element and schema-attribute nodetests are not
supported</li>
 <li>
 The XSLT instruction xsl:number
uses XSLT 1.0 semantics and syntax. 
 </li>
 <li>
 The use-when standard attribute
is not supported. 
 
 </li>
 <li>
 The processor does not honor the
attribute of required on xsl:param. 
 </li>
 <li>
 Tunnel parameters are not supported.
 
 </li>
 <li>
 Regular expression instructions are
not
supported in XSLT.
 </li>
</ul>
<ul>
 <li>The XPath 2.0 functions fn:tokenize, fn:matches and fn:replace
are not supported</li>
</ul>
<ul>
 <li>format-dateTime, format-date, and format-time functions are not
supported. 
 </li>
 <li>
 The content model for xsl:attribute, xsl:comment,
 xsl:message and the way to compute key values of xsl:key
and xsl:sort are still 1.0 behavior.
 </li>
</ul>
<ul>
 <li>does not support attribute [xsl:]inherit-namespaces for xsl:copy,
xsl:element, and literal result elements. 
 </li>
</ul>
New feature for this release: 
<ul>
 <li>Streaming XPath evaluation improves scalability and performance on
 Scalable DOM transformation. 
 </li>
</ul>
 
2.3 JAXB Class Generator 
The XML Data Binding is built upon JSR-31 "The Java
Architecture for XML Binding (JAXB) Final, V1.0 January 8th, 2003".
This component allows creations of Java classes based on the XML
Schema. 

The JAXB 1.0 specification does not require full W3C XML Schema
support. Please refer to Appendix E.2 for full details. The current
release doesn't support the following: 
<ul>
 <li>
 The Javadoc generation is not
supported.
 </li>
</ul>
<ul>
 <li>XML Schema component "any" and substitution groups are not
supported.</li>
</ul>
 
Encoding of
Schema-Derived Java Files 

<ul>
</ul>
According to the Java Language Specification, Java programs
are written using the Unicode character set.&nbsp; Specifically,
comments, identifiers, and the contents of character and string
literals in a Java program can be formed with Unicode characters.&nbsp;
Unless all input characters in Java program can be expressed in ASCII
characters (i.e., non-ASCII characters are translated into Unicode
escapes), JAXB-generated Java files needs to be saved in a specific
encoding.&nbsp; For this release, we choose UTF-8 as the encoding of
all JAXB-generated Java files.&nbsp; If this encoding is different from
platform default converter, then the option "encoding" needs to be
specified to
tell javac or the Java programming language compiler which encoding is
used for source
files. 

2.4 XML Java Beans 
The oracle.xml.transviewer.DBAccess bean has been deprecated,
please use oracle.xml.dbaccess.DBAccess instead. 
&nbsp; 
2.5 XML Pipeline Processor 
Oracle XML Pipeline Processor is built upon the XML Pipeline
Definition Language Version 1.0, W3C&nbsp; Note 28 February 2002. The
processor can take an input xml pipeline document and executes the
pipeline processes according to the derived dependencies. The
pipeline document is an xml document, and specifies the processes to
be executed in a declarative manner. In addition to the Pipeline
Processor, we have defined several Pipeline Processes which can be
piped together in a pipeline document. 
There are some differences between the W3C Note and this
implementation. They are: 
<ul>
 <li>
 The parser processes
(DOMParserProcess and SAXParserProcess) are included in the xml
pipeline (Section 1). 
 </li>
 <li>
 Currently XML Base is not supported
(Section 2.1) 
 </li>
 <li>
 Only the final target output is
checked to see if it is up-to-date with respect to the available
pipeline inputs.&nbsp; We do not determine whether the intermediate
outputs of every process are up-to-date.&nbsp; (Section 2.2). 
 </li>
 <li>
 For the select attribute, anything
in between double-quotes "" is considered to be a string literal. 
 </li>
 <li>
 The processor will throw an error if
more that one process produces the same infoset (Section 2.4.2.3) 
 </li>
 <li>
 The 'document' element is not supported as it is deemed to be
redundant functionality (Section 2.4.2.8) 
 </li>
</ul>
 
2.6 XSQL Servlet 
Oracle XSQL servlet combines the power of SQL, XML, and XSLT in
the server to deliver dynamic web content. With XSQL servlet you can:

<ul>
 <li>
 Receive web-based information
requests from any client device on the Web, 
 </li>
 <li>
 Query an appropriate logical "view"
of business data needed by the request, 
 </li>
 <li>
 Return the "datagram" in XML over
the web to the requester, or optionally 
 </li>
 <li>
 Transform the information flexibly into any XML, HTML, or text
format they require 
 </li>
</ul>
The XSQL servlet processor has the following new features: 
<ul>
 <li>
 Support for Multi-Valued
Parameters: This allows users to work with parameters whose
values are arrays of strings. The most common scenario where
multi-valued parameters occur is when a user submits an HTML form
containing multiple occurrences of input controls that share the same
name. 
 </li>
 <li>
 Conditionally Execute Actions
or Include Content with xsql:if-param: The
new&nbsp;&lt;xsql:if-param&gt;&nbsp;action allows you to conditionally
include the elements and/or actions that are nested inside it if some
condition is true. 
 </li>
 <li>
 New Commit="No" Flag on
Actions That Performed an Implicit Commit:
The&nbsp;&lt;xsql:delete-request,&nbsp;xsql:insert-request&gt;,
xsql:insert-request, and&nbsp;&lt;xsql:insert-parameter&gt; action
elements each takes a new optional commit attribute to control whether
the action does an implicit commit or not. 
 </li>
 <li>
 Optionally Set an Error Param
on Any Built-in Action: It is often convenient to know whether
an action encountered a non-fatal error during its execution. 
 </li>
 <li>
 Use Your Servlet Container's
DataSource Implementation: As an alternative to
defining your named connections in the XSQLConfig.xml file, you may now
alternatively use the datasources available through your servlet
container's implementation of JDBC datasources. 
 </li>
 <li>
 Provide Custom
XSQLErrorHandler Implementation: A new interface is introduced
in this release oracle.xml.xsql.XSQLErrorHandler that allows developers
to achieve a programmatic way to control how errors are reported to be
able to customize the treatment of the errors. 
The error code returned by XSQLError.getErrorCode() has changed to
25NNN instead of NNN. The error code format also has changed to
XML-25NNN. 
 </li>
 <li>
 Provide Custom XSQLLogger
Implementation: Two new interfaces are introduced in this
release oracle.xml.xsql.XSQLLoggerFactory and
oracle.xml.xsql.XSQLLogger that allow developers to achieve to log XSQL
page requests. 
 </li>
 <li>
 Override the Default Name of
of the XSQLConfig.xml file: Customers have requested a way to
override the default XSQLConfig.xml file name so that they can easily
provide different configuration files for test and production
environments, for example. This releases introduces two ways to
override the name. 
 <ul>
 <li>
 By setting the Java System
property xsql.config 
 </li>
 <li>
 By defining a servlet
initialization parameter xsql.config 
 </li>
 </ul>
 </li>
 <li>
 Support for Apache FOP 0.20.3:
If you need to render PDF output from XSQL pages, this release supports
working with the 0.20.3 release candidate of Apache FOP. 
 </li>
 <li>
 Set Preserve Whitespace Config Option: It is now
possible to control whether or not the XSQL Page Processor uses the
Oracle XML Parser to parse XSQL page templates and XSLT stylesheets
with whitespace preserving mode. 
 </li>
</ul>
 
2.7 Oracle TransX Utility 
TransX is a data transfer utility that allows you to populate your
database with multilingual data. It uses XML to specify the data so
you can take advantage of easy data transfer from XML to the
database, a simple data format that is intuitive for both developers
and translators, and validation capability that makes it less error
prone. 
<a name="XSU"></a> 
2.8 Oracle XML SQL Utility 
XML-SQL Utility (XSU) is utility can transform data retrieved from
object-relational database tables or views into XML and insert the
data in XML into the appropriate columns/attributes of a table or a
view based on a canonical mapping. 

 
2.9 Binary XML 
Binary XML makes it possible to encode and decode between XML text and
compressed binary XML.&nbsp; For efficiency, the DOM and SAX APIs are
provided on top of binary XML for direct consumption by the XML
applications.&nbsp; Please see the Oracle XML Developer's Kit
Programmer's Guide for more information. 
 
2.10 Scalable DOM 
XDK provides scalable, pluggable support for DOM.&nbsp; This relieves
problems of memory inefficiency, limited scalability, and lack of
control over the DOM configuration.&nbsp; Please see the Oracle XML
Developer's Kit Programmer's Guide for more information. 
 
<hr>
<a name="C XDK"></a>3 XDK C/C++ Components

Oracle XDK C/C++ components are built on W3C Recommendations. The
list of currently supported standards are: 
<ul>
 <li>
 <a
 href="http://www.w3.org/TR/REC-xml">XML 1.0 (Second Edition)</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/REC-xml-names">Namespaces in XML</a> 
 </li>
 <li>
 DOM Level 2.0 Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/DOM-Level-2-Core">DOM Level 2.0 Core</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range">DOM Level 2.0
Traversal and Range</a> 
 </li>
 </ul>
 </li>
 <li>
 <a href="http://www.saxproject.org/">SAX
2.0 &amp; SAX Extensions</a> 
 </li>
 <li>
 XSLT/XPath Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT) 1.0</a> 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/xpath">XML Path Language (XPath) 1.0</a> 
 </li>
 </ul>
 </li>
 <li>
 XML Schema Specifications 
 <ul>
 <li>
 <a
 href="http://www.w3.org/TR/xmlschema-0/">XML Schema Part 0: Primer</a>
 
 </li>
 <li>
 <a
 href="http://www.w3.org/TR/xmlschema-1/">XML Schema Part 1: Structures</a>
 
 </li>
 <li>
 <a href="http://www.w3.org/TR/xmlschema-2/">XML Schema Part
2: Datatypes</a> 
 </li>
 </ul>
 </li>
</ul>
3.1 StAX Support 
XML Events provides a StAX like interface where the parsing of
the xml document is pull-based compared to push-based SAX events.&nbsp;
XML events give control of the parsing to the application by exposing a
simple set of API and an underlying set of events. Methods such as
XmlEvNext allow the application to pull the next event rather than
handling the event in a callback. Associated with each event are a set
of API's that the application can use to get more information. For
example, the application can call XmlEvGetName to get the QName for the
event XML_EVENT_START_ELEMENT. 
 
3.2 Streaming Validation Support 
The streaming validator interface provides the ability to validate the
xml document represented by XML events rather than a DOM. The interface
takes an event context that represents the instances and uses the XML
Events interface to get information about each event during validation. 
3.3 XSLT Virtual Machine 
 
The XSLTVM Package implements the XSL Transformation (XSLT)
language as specified in W3C Recommendation 16 November 1999. XSLT
Virtual Machine is the software implementation of a "CPU"
designed to run compiled XSLT code. A concept of virtual machine
assumes a compiler compiling XSLT stylesheets to a sequence of byte
codes or machine instructions for the "XSLT CPU". The
byte-code program is a platform independent sequence of 2-byte units.
It can be stored, cashed and run on different XSLTVM. The XSLTVM uses
the bytecode programs to transform instance XML documents. This
approach clearly separates compile(design)-time from run-time
computations and specifies a uniform way of exchanging data between
instructions. The package includes two interfaces: 
<ul>
 <li>
 XSLTVM Compiler Interface 
 </li>
 <li>
 XSLTVM Interface 
 </li>
</ul>
A typical scenario of using the package APIs has the following
steps: 
<ol>
 <li>
 Create/Use an XML meta context
object. 
 </li>
 <li>
 Create/Use an XSLT Compiler object. 
 </li>
 <li>
 Compile an XSLT stylesheet and
store/cash the result bytecode. 
 </li>
 <li>
 Optional. Repeat steps 1 - 2 for all
stylesheets. 
 </li>
 <li>
 Delete (or preserve for later usage)
the Compiler object. 
 </li>
 <li>
 Create/Use an XSLTVM object. 
 </li>
 <li>
 Set a stylesheet bytecode to the
XSLTVM object. 
 </li>
 <li>
 Transform an instance XML document. 
 </li>
 <li>
 Optional. Repeat step 6 or 5 - 6 as
many times as needed. 
 </li>
 <li>
 Delete (or preserve for later usage) the XSLTVM object. 
 </li>
</ol>
 
3.4 XML Schema Validator 
The processor fully supports the
functionality stated in the specification plus "XML Schema 1.0
Specification Errata" as published on: 
&nbsp;
http://www.w3.org/2001/05/xmlschema-errata. 
<hr>
<a name="Compatibilty"></a>4 Compatibility

This section contains recommendations on upgrading to this
release. 
4.1 XDK Java components upgrade 

In
11gR1, Java XDK is supported on JDK 1.5 and above. 

In 11gR2 Java XDK has a dependency on NSL jar: orai18n-mapping.jar.
4.2 XDK C/C++ components upgrade 
 
4.3 New C++ API and Old C++ API 
<hr>
<a name="Known Bugs"></a>5. Known Bugs

<ul>
 <li>
 Links to DOM Level 3.0 Validation
specification in all classes of org.w3c.dom.validation package are
incorrect. The correct link should be to the candidate recommendation
at <a href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Val-20030730">http://www.w3.org/TR/2003/CR-DOM-Level-3-Val-20030730</a>
 
 </li>
 <li>
 The following APIs in
org.w3c.dom.validation package are incorrectly documented: 
 <ul>
 <li>
 DocumentEditVal.getContinuousValidityChecking()
returns boolean instead of short. 
 </li>
 <li>
 DocumentEditVal.setContinuousValidityChecking()
accepts boolean instead of short. 
 </li>
 <li>
 ElementEditVal.getAllowedFirstChildElements() is renamed to
getAllowedFirstChildren(). 
 </li>
 </ul>
 </li>
</ul>
Please see specific sections for additional known issues. 
</body>
</html>

Ms-Dos/Windows Unix Write backup

jsp File Browser version 1.2 by www.vonloesch.de