Inconsistent specification for OMDataSource#serialize(OutputStream,
OMOutputFormat)
-----------------------------------------------------------------------------------
Key: WSCOMMONS-336
URL: https://issues.apache.org/jira/browse/WSCOMMONS-336
Project: WS-Commons
Issue Type: Bug
Components: AXIOM
Reporter: Andreas Veithen
Priority: Minor
The documentation of the format argument of
OMDataSource#serialize(OutputStream, OMOutputFormat) reads like this:
"format information (null if none; may be ignored if not supported by data
binding even if supplied)"
Both the specification that the format argument can be null and the statement
that it may be ignored if supplied do not make sense. Indeed, how could an
implementation of this method serialize anything meaningful to the OutputStream
if it doesn't even know or take into account the character encoding?
This should be replaced by the requirement that an OutputFormat object must be
supplied and that the implementation must use the character encoding specified
when writing to the OutputStream.
The strange thing is that the implementation of this method in ADBDataSource in
Axis2 indeed doesn't use the format argument...
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
