JDK-8261210 : isStandalone property: remove dependency on pretty-print
  • Type: CSR
  • Component: xml
  • Sub-Component: jaxp
  • Priority: P4
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 17
  • Submitted: 2021-02-05
  • Updated: 2021-02-08
  • Resolved: 2021-02-08
Related Reports
CSR :  
Description
Summary
-------

Change the behavior of the isStandalone property so that it takes effect regardless of the settings of the pretty-print property.

Problem
-------

The new implementation specific property `isStandalone` added through JDK-8249867 required the property `format-pretty-print` to be true. However, there are cases where applications want the serializer to produce an output with a newline after the header but without setting the pretty-print property.

Solution
--------

Remove the dependency on the pretty-print property.

Specification
-------------

In the implementation note of the module summary (java.xml/module-info.java), specifically in table Features and Properties, remove **"when the property format-pretty-print is set to true"** from the property description, thus changing it from:

indicates that the serializer should treat the output as a standalone document. The property can be used to ensure a newline is written after the XML declaration ***when the property format-pretty-print is set to true***. Unlike the property xml-declaration, this property does not have an effect on whether an XML declaration should be written out. 

to:

indicates that the serializer should treat the output as a standalone document. The property can be used to ensure a newline is written after the XML declaration. Unlike the property xml-declaration, this property does not have an effect on whether an XML declaration should be written out. 

<br>
Attached: spec_01_8261209.zip

Convenient link: http://cr.openjdk.java.net/~joehw/jdk17/8261209/spec_01/java.xml/module-summary.html
Comments
Moving to Approved.
08-02-2021