You are viewing a plain text version of this content. The canonical link for it is here.
Posted to j-dev@xerces.apache.org by "Olivier Cailloux (JIRA)" <xe...@xml.apache.org> on 2019/07/26 08:49:00 UTC

[jira] [Updated] (XERCESJ-1712) Class org.apache.xml.serialize.DOMSerializerImpl should not be used, or misleading doc

     [ https://issues.apache.org/jira/browse/XERCESJ-1712?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Olivier Cailloux updated XERCESJ-1712:
--------------------------------------
    Description: 
Calling {{createLSSerializer}} on a {{DOMImplementationLS}} instance returns an instance of {{org.apache.xml.serialize.DOMSerializerImpl}}. The javadoc of that class (using {{xerces:xercesImpl:2.12.0}}) says: “@deprecated Replaced by org.apache.xml.serializer.dom3.LSSerializerImpl in Xerces 2.9.0”.

I spent two hours trying to solve that problem because I thought this was the cause for some error I was observing when serializing an XML document. I realized later that the error was a mistake in my code. But still, the new class {{LSSerializerImpl}} should, I suppose, be used instead of the old one {{DOMSerializerImpl}}, or the documentation is misleading if the intent is not to fully replace the {{DOMSerializerImpl}} class by {{LSSerializerImpl}}.

A sample project that exhibits the instance of {{org.apache.xml.serialize.DOMSerializerImpl}} being used is available at [https://github.com/oliviercailloux/xerces-user].

  was:
Calling createLSSerializer on a DOMImplementationLS instance returns an instance of org.apache.xml.serialize.DOMSerializerImpl. The javadoc of that class (using xerces:xercesImpl:2.12.0) says: “@deprecated Replaced by org.apache.xml.serializer.dom3.LSSerializerImpl in Xerces 2.9.0.”.

I spent two hours trying to solve that problem because I thought this was the cause for some error I was observing when serializing an XML document. I realized later that the error was a mistake in my code. But still, the new class should, I suppose, be used instead of the old one, or documentation is misleading if the intent is not to fully replace the class by another one.

A sample project that exhibits the instance of org.apache.xml.serialize.DOMSerializerImpl being used is available at https://github.com/oliviercailloux/xerces-user.


> Class org.apache.xml.serialize.DOMSerializerImpl should not be used, or misleading doc
> --------------------------------------------------------------------------------------
>
>                 Key: XERCESJ-1712
>                 URL: https://issues.apache.org/jira/browse/XERCESJ-1712
>             Project: Xerces2-J
>          Issue Type: Bug
>            Reporter: Olivier Cailloux
>            Priority: Minor
>
> Calling {{createLSSerializer}} on a {{DOMImplementationLS}} instance returns an instance of {{org.apache.xml.serialize.DOMSerializerImpl}}. The javadoc of that class (using {{xerces:xercesImpl:2.12.0}}) says: “@deprecated Replaced by org.apache.xml.serializer.dom3.LSSerializerImpl in Xerces 2.9.0”.
> I spent two hours trying to solve that problem because I thought this was the cause for some error I was observing when serializing an XML document. I realized later that the error was a mistake in my code. But still, the new class {{LSSerializerImpl}} should, I suppose, be used instead of the old one {{DOMSerializerImpl}}, or the documentation is misleading if the intent is not to fully replace the {{DOMSerializerImpl}} class by {{LSSerializerImpl}}.
> A sample project that exhibits the instance of {{org.apache.xml.serialize.DOMSerializerImpl}} being used is available at [https://github.com/oliviercailloux/xerces-user].



--
This message was sent by Atlassian JIRA
(v7.6.14#76016)

---------------------------------------------------------------------
To unsubscribe, e-mail: j-dev-unsubscribe@xerces.apache.org
For additional commands, e-mail: j-dev-help@xerces.apache.org