Olivier Cailloux created XERCESJ-1712:
-----------------------------------------

             Summary: 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


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.



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

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

Reply via email to