Hi,
One of my outstanding to do items for xercesc 3.0 was to audit the list of
deprecated methods and decide what we should do with them in 3.0.
Here is the list of deprecated methods: (indented lines are the functions
corresponding to the "deprecated" comment):
framework\XMLAttDef.hpp(249): * @deprecated
getProvided
framework\XMLAttDef.hpp(340): * @deprecated
setProvided
framework\XMLAttDefList.hpp(67): * @deprecated This method is not
thread-safe.
hasMoreElements
framework\XMLAttDefList.hpp(93): * @deprecated This method is not
thread-safe.
nextElement
framework\XMLAttDefList.hpp(98): * @deprecated This method is not
thread-safe.
Reset
framework\XMLAttr.hpp(221): * @deprecated
getValidatingTypeURI
framework\XMLAttr.hpp(227): * @deprecated
getValidatingTypeName
framework\XMLAttr.hpp(376): * @deprecated
setDatatypeValidator
framework\XMLAttr.hpp(385): * @deprecated
setSchemaValidated
framework\XMLDocumentHandler.hpp(277): * @deprecated
elementTypeInfo
framework\XMLElementDecl.hpp(79): * @deprecated Use of addIfNotFound couldl
produce undefined
enum LookupOpts
{
AddIfNotFound
, FailIfNotFound
};
framework\XMLGrammarPool.hpp(184): * @deprecated (shouldn't use address to
determine if XSModel changed)
getXSModel
framework\XMLValidator.hpp(322): // Deprecated XMLValidator interface
framework\XMLValidator.hpp(326): * DEPRECATED.
checkRootElement
internal\XMLGrammarPoolImpl.hpp(174): * @deprecated (shouldn't use address
to determine if XSModel changed)
getXSModel
internal\XMLScanner.hpp(394): // Deprecated methods as of 3.2.0. Use
getValidationScheme() and
internal\XMLScanner.hpp(1334):// XMLScanner: Deprecated methods
getDoValidation
setDoValidation
internal\XSerializeEngine.cpp(146):// Deprecated Constructor
internal\XSerializeEngine.hpp(102): * Deprecated
internal\XSerializeEngine.hpp(123): * Deprecated
XSerializeEngine (2 constructors)
parsers\AbstractDOMParser.cpp(1166):// AbstractDOMParser: Deprecated methods
parsers\AbstractDOMParser.hpp(1364): * @deprecated
elementTypeInfo
parsers\AbstractDOMParser.hpp(1375): // Implementation of the deprecated
DocTypeHandler interface.
parsers\AbstractDOMParser.hpp(1377): /** @name Deprecated DocTypeHandler
Interfaces */
#1 The DocTypeHandler interface isn't marked as deprecated. Still used by
DTDScanner.
Anyone know why marked as deprecated (for all scanners)?
parsers\AbstractDOMParser.hpp(1462): // Deprecated Methods
parsers\AbstractDOMParser.hpp(1464): /** @name Deprecated Methods */
getDoValidation
setDoValidation
parsers\AbstractDOMParser.hpp(1494): * DEPRECATED Use
getCreateEntityReferenceNodes() instead.
getExpandEntityReferences
parsers\AbstractDOMParser.hpp(1510): * DEPRECATED. USE
setCreateEntityReferenceNodes instead.
setExpandEntityReferences
parsers\SAX2XMLFilterImpl.hpp(213): *
<br>http://apache.org/xml/features/validation/reuse-validator (Deprecated)
(default: false)
parsers\SAX2XMLReaderImpl.hpp(283): *
<br>http://apache.org/xml/features/validation/reuse-validator (Deprecated)
(default: false)
#2 I believe this is just a comment, can't see any code associated with
this feature.
parsers\SAX2XMLReaderImpl.hpp(1295): // Implementation of the Deprecated
DocTypeHandler Interface
parsers\SAX2XMLReaderImpl.hpp(1298): /** @name Implementation of the
deprecated DocTypeHandler Interface */
See #1 above.
parsers\SAXParser.cpp(1231):// SAXParser: Deprecated methods
getDoValidation/setDoValidation
parsers\SAXParser.hpp(58): * @deprecated This interface has been replaced by
the SAX2
MARKING entire SAX parser deprecated....
parsers\SAXParser.hpp(1704): // Implementation of the Deprecated
DocTypeHandler Interface
parsers\SAXParser.hpp(1706): /** @name Implementation of the deprecated
DocTypeHandler Interface */
See #1 above.
parsers\SAXParser.hpp(1952): // Deprecated Methods
parsers\SAXParser.hpp(1954): /** @name Deprecated Methods */
getDoValidation/setDoValidation
sax2\SAX2XMLReader.hpp(244): *
<br>http://apache.org/xml/features/validation/reuse-validator (Deprecated)
(default: false)
See #2 above.
util\Base64.hpp(120): * @deprecated use decodeToXMLByte instead.
decode
util\HexBin.hpp(86): * @deprecated use decodeToXMLByte instead.
decode
util\TransService.hpp(432): // DEPRECATED old transcode interface
calcRequiredSize
util\XMLAbstractDoubleFloat.hpp(82): * Deprecated: please use getRawData
toString
util\XMLBigDecimal.hpp(82): * Deprecated: please use getRawData
toString
util\XMLBigInteger.hpp(86): * Deprecated: please use getRawData
toString
util\XMLDateTime.hpp(84): * Deprecated: please use getRawData
toString
util\XMLMsgLoader.cpp(113):// Deprecated
util\XMLMsgLoader.cpp(115):// These two methods are deprecated.
getLanguageName, setLanguageName
util\XMLMsgLoader.hpp(135): // Deprecated: Getter methods
getLanguageName
util\XMLMsgLoader.hpp(147): // Deprecated: Protected helper methods
setLanguageName
util\XMLNumber.hpp(52): * Deprecated: please use getRawData
toString
util\XMLString.cpp(652): * Deprecated: isValidNCName
isValidNCName
util\XMLString.cpp(661): * Deprecated: isValidName
isValidName
util\XMLString.cpp(703): * Deprecated: isValidQName
isValidQName
util\XMLString.cpp(740):// Deprecated
isAllWhiteSpace
util\XMLString.hpp(829): * Deprecated: please use XMLChar1_0::isValidNCName
isValidNCName
util\XMLString.hpp(838): * Deprecated: please use XMLChar1_0::isValidName
isValidName
util\XMLString.hpp(854): * Deprecated: please use XMLChar1_0::isValidQName
isValidQName
util\XMLString.hpp(892): * Deprecated: please use
XMLChar1_0::isAllWhiteSpace
isAllWhiteSpace
util\XMLString.hpp(1137): /** Transcodes a string to native code-page
(DEPRECATED)
transcode
util\XMLString.hpp(1177): /** Transcodes a string to native code-page
(DEPRECATED)
transcode
util\XercesDefs.hpp(155): #if defined(XERCES_BUILDING_DEPRECATED_LIBRARY)
util\XercesDefs.hpp(156): #define DEPRECATED_DOM_EXPORT
XERCES_PLATFORM_EXPORT
util\XercesDefs.hpp(158): #define DEPRECATED_DOM_EXPORT
XERCES_PLATFORM_IMPORT
util\XercesDefs.hpp(166): #define DEPRECATED_DOM_EXPORT
removing deprecated DOM should get rid of these...
util\Transcoders\Cygwin\CygwinTransService.hpp(225): // DEPRECATED old
transcode interface
util\Transcoders\Iconv\IconvTransService.hpp(108): // DEPRECATED old
transcode interface
util\Transcoders\Iconv390\Iconv390TransService.hpp(119): // DEPRECATED old
transcode interface
util\Transcoders\Iconv400\Iconv400TransService.hpp(209): // DEPRECATED old
transcode interface
util\Transcoders\IconvFBSD\IconvFBSDTransService.hpp(341): // DEPRECATED
old transcode interface
util\Transcoders\IconvGNU\IconvGNUTransService.hpp(318): // DEPRECATED old
transcode interface
util\Transcoders\ICU\ICUTransService.hpp(192): // DEPRECATED old transcode
interface
util\Transcoders\MacOSUnicodeConverter\MacOSUnicodeConverter.hpp(237): //
DEPRECATED old transcode interface
util\Transcoders\Uniconv390\Uniconv390TransService.hpp(196): // DEPRECATED
old transcode interface
util\Transcoders\Win32\Win32TransService.hpp(223): // DEPRECATED old
transcode interface
validators\datatype\ENTITYDatatypeValidator.hpp(116): //deprecated
setEntityDeclPool
validators\datatype\IDDatatypeValidator.hpp(90): //deprecated
setIDRefList
validators\datatype\IDREFDatatypeValidator.hpp(91): //deprecated
setIDRefList
validators\DTD\DTDAttDefList.hpp(67): * @deprecated This method is not
thread-safe.
hasMoreElements
validators\DTD\DTDAttDefList.hpp(93): * @deprecated This method is not
thread-safe.
nextElement
validators\DTD\DTDAttDefList.hpp(98): * @deprecated This method is not
thread-safe.
Reset
validators\DTD\DTDGrammar.hpp(149): // deprecated. returns the ID of the
root element; not
getRootElemId
validators\DTD\DTDGrammar.hpp(164): // deprecated. Not usable in
multithreaded environments
setRootElemId
validators\schema\ComplexTypeInfo.hpp(125): * @deprecated; not thread-safe
(will not work with shared grammars)
setContentModel
validators\schema\GeneralAttributeCheck.hpp(193): //deprecated
setIDRefList
validators\schema\SchemaAttDef.hpp(91): * @deprecated
getEnclosingCT
validators\schema\SchemaAttDefList.hpp(63): * @deprecated This method is
not thread-safe.
hasMoreElements
validators\schema\SchemaAttDefList.hpp(102): * @deprecated This method is
not thread-safe.
nextElement
validators\schema\SchemaAttDefList.hpp(107): * @deprecated This method is
not thread-safe.
Reset
validators\schema\SchemaElementDecl.hpp(104): // @deprecated; not thread-safe
resetDefs
validators\schema\SchemaElementDecl.hpp(137): * @deprecated; not actually
used
setElemId
validators\schema\SchemaElementDecl.hpp(355): //there is not getElemId so
this is not needed. mark deprecated.
setElemId
validators\schema\SchemaGrammar.hpp(176): //deprecated
getIDRefList
validators\schema\identity\IC_Field.hpp(64): * @deprecated
getMayMatch
validators\schema\identity\IC_Field.hpp(72): * @deprecated
setMayMatch
validators\schema\identity\IC_Field.hpp(87): * @deprecated
createMatcher
validators\schema\identity\ValueStore.hpp(76): * @deprecated
addValue
I think we should get rid of everything except two things:
1) The DocTypeHandler interface isn't marked as deprecated (although the
parsers that implement it mark it as deprecated). Still used by
DTDScanner. Does anyone know why it is marked deprecated?
2) SAXParser. I don't think we should remove this as it is still
frequently used.
Unless anyone has any objections I will remove all of the other deprecated
methods.
Regards,
David A. Cargill
XML Parser Development
IBM Toronto Lab
(905) 413-2371, tie 969
[EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
