You are viewing a plain text version of this content. The canonical link for it is here.
Posted to c-dev@xerces.apache.org by David Cargill <ca...@ca.ibm.com> on 2006/05/08 16:43:22 UTC
Remove Deprecated Methods in Xercesc 3.0
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
cargilld@ca.ibm.com
---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@xerces.apache.org
For additional commands, e-mail: c-dev-help@xerces.apache.org