Newer
Older
Unknown (abagchi)
committed
<?xml version="1.0" standalone="no"?>
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
-->
<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
Unknown (abagchi)
committed
<p>For migration information to &XercesCName; 2.5.0 or earlier,
please refer to <jump href="migrate_archive.html">Migration Archive. </jump></p>
</s2>
<s2 title="Migrating from &XercesCName; 2.5.0 to &XercesCName; &XercesCVersion;">
<p>The following section is a discussion of the technical differences between
&XercesCName; 2.5.0 code base and the &XercesCName; &XercesCVersion;.</p>
<p>Topics discussed are:</p>
<ul>
<li><link anchor="NewFeatures260">New features in &XercesCName; &XercesCVersion;</link></li>
<li><link anchor="API260">Public API Changes</link></li>
<li><link anchor="NewAPI260">New Public API</link></li>
<li><link anchor="ModifiedAPI260">Modified Public API</link></li>
<li><link anchor="DeprecatedAPI260">Deprecated/Removed Public API</link></li>
<li>Please note the following source code incompatibility: Rename VALUE_CONSTRAINT enumeration values in XSConstants.hpp due to conflict with system header. New
values are VALUE_CONSTRAINT_NONE, VALUE_CONSTRAINT_DEFAULT and VALUE_CONSTRAINT_FIXED. Old
values are VC_NONE, VC_DEFAULT and VC_FIXED.</li>
<li>Also note that if you have implemented your own XMLGrammarPool implementation, that
the original getXSModel has been marked deprecated and a new method, of the same
name, that takes a bool parameter has been added. This new getXSModel needs
to always return an XSModel.</li>
<s3 title="New features in &XercesCName; &XercesCVersion;">
<li>Reduce footprint of DLL by building the deprecated DOM as a separate library</li>
<li>Improve packaging scripts</li>
<li>Enable ID's to work on all kinds of schema components</li>
<li>Add messages to DOMExceptions along with the error code</li>
<li>Improve annotation error-reporting capabilities</li>
<li>Make grammar caching work with DTD internal subsets</li>
<li>Bring parser up to the XML 1.0 3rd Edition</li>
<li>Update to the XML 1.1 recommendation</li>
<li>Add new method to DOMDocument so that DOM level-2 style DOMDocumentTypes (which have a
DOMDocument to own them) can be created</li>
<li>Feature for disabling identity constraints</li>
<li>Update schema errata</li>
<li>Provide means to get actual values out of PSVI/schema component model</li>
<li>Synthesize annotation components for non-schema attributes</li>
<li>Expose partial PSVIElement information at the start element call</li>
<li>Externalize validation, actual/canonical value production for arbitrary strings</li>
<li>Laxly validate schema annotations</li>
<li>Upgrade to ICU 3.0</li>
<li>Handle elements with a large number of attributes more efficiently</li>
<p>The following lists the public API changes between the &XercesCName;
2.5.0; and the &XercesCName; &XercesCVersion; releases
<s4 title="New Public API">
<li>XSValue</li>
<li>IdentityConstraintHandler</li>
<li>XMLString: removeChar, isValidNOTATION</li>
<li>XMLUri: normalizeUri</li>
<li>PSVIHandler: handlePartialElementPSVI</li>
<li>RefHash family of classes: getHashModulus</li>
<li>XSAnnotation: setline/col and systemid</li>
<li>XMLReader: handeEOL</li>
<li>XMLChar: isValidNmToken</li>
<li>XMLBigDecimal: parseDecimal, getIntVal</li>
<li>HexBin: getCanonicalRepresentation, decode</li>
<li>Base64: getCanonicalRepresentation, decode</li>
<li>XMLBigInteger: compareValues</li>
<li>XMLAbstractDoubleFloat: isDataConverted, getValue, isDataOverFlowed</li>
<li>PSVIItem: getActualValue</li>
<li>XSSimpleTypeDefinition: getDatatypeValidator</li>
<li>RefHash2KeysTableOf: transferElement</li>
<s4 title="Modified Public API">
<li>XSerializeEngine constructor</li>
<li>MACUnicodeConverters</li>
<anchor name="DeprecatedAPI260"/>
<s4 title="Deprecated/Removed Public API">
<li>XSerializeEngine constructor</li>
<li>DTDAttDef: getDOMTypeInfoName, getDOMTypeInfoUri</li>
<li>DTDElementDecl: getDOMTypeInfoName, getDOMTypeInfoUri</li>
<li>SchemaAttDef: setAnyDatatypeValidator</li>
<li>UnionDatatypeValidator: getMemberTypeName, getMemberTypeUri, getMemberTypeAnonymous, getMemberTypeValidator</li>
<li>XMLAttr: getValidatingTypeURI, getValidatingTypeName, setDatatypeValidator, setSchemaValidated</li>
<li>ComplexTypeInfo: setContentModel</li>
<li>XMLGrammarPool: getXSModel</li>
<li>SAXParser, mark this class deprecated</li>