Name: gm110360 Date: 01/27/2004


FULL PRODUCT VERSION :
n/a all since java 1.3

FULL OS VERSION :
n/a applies to all o/s

A DESCRIPTION OF THE PROBLEM :
InputStream has been deprecated for a while in favor of Reader, but, the standard JAXP API as defined in javax.xml provides no way to parse with a Reader.

When this bug was dismissed in the past, the evaluation is flawed.
The recommended workaround involved the use of non-standard libraries and APIs. When one looks at the Javadoc for org.xml... packages, one is immediately confronted with a big disclaimer that Sun provides no warranty and you use it at your own risk.

Since the javax.xml... APIs are Sun defined Java standards,
they should provide a way to parse that does not violate
Sun's own deprecations!!

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(
 new StringBufferInputStream( (String) xml ) );

this results in deprecation warning. There is no way using standard
Sun-supported api to get string into parse (especially using recommened
Reader interface).

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Need a way to parse an xml string using std supported non-deprecated APIs.
ACTUAL -
deprecation warning

ERROR MESSAGES/STACK TRACES THAT OCCUR :
InputStream deprecation warning

REPRODUCIBILITY :
This bug can be reproduced always.

CUSTOMER SUBMITTED WORKAROUND :
the previously recommended workaround uses non-supported libraries.
(Incident Review ID: 201559)
======================================================================
This didn't make the cut for JAXP 1.4.