# HG changeset patch
# User rkennke
# Date 1565971241 -7200
#      Fri Aug 16 18:00:41 2019 +0200
# Node ID 203301052e82e349a0f70d1c56d5051a5e01acd0
# Parent  3ef3348195ffeb3c268af4a43928f2f09c5fa83a
8213325: (props) Properties.loadFromXML does not fully comply with the spec
Reviewed-by: alanb, rriggs, dfuchs, naoto

diff --git a/src/share/classes/jdk/internal/org/xml/sax/DTDHandler.java b/src/share/classes/jdk/internal/org/xml/sax/DTDHandler.java
--- a/src/share/classes/jdk/internal/org/xml/sax/DTDHandler.java
+++ b/src/share/classes/jdk/internal/org/xml/sax/DTDHandler.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -73,7 +73,6 @@
  */
 public interface DTDHandler {
 
-
     /**
      * Receive notification of a notation declaration event.
      *
@@ -136,6 +135,39 @@
                                              String notationName)
         throws SAXException;
 
+    // from SAX2 extension DeclHandler
+    /**
+     * Receive notification of the start of DTD declarations.
+     *
+     * The start/endDTD events appear within the start/endDocument events
+     * from ContentHandler.
+     *
+     * @param name The document type name.
+     * @param publicId The declared public identifier for the
+     *        external DTD subset, or null if none was declared.
+     * @param systemId The declared system identifier for the
+     *        external DTD subset, or null if none was declared.
+     *        (Note that this is not resolved against the document
+     *        base URI.)
+     * @throws SAXException the event receiver may throw an exception during processing
+     */
+    default public void startDTD (String name, String publicId, String systemId)
+        throws SAXException
+    {
+        // no op
+    }
+
+    // Custom API for the Properties
+
+    /**
+     * Receive notification of the start of DTD internal subset.
+     *
+     * @throws SAXException the event receiver may throw an exception during processing
+     */
+    default public void startInternalSub () throws SAXException
+    {
+        // no op
+    }
 }
 
 // end of DTDHandler.java
diff --git a/src/share/classes/jdk/internal/util/xml/PropertiesDefaultHandler.java b/src/share/classes/jdk/internal/util/xml/PropertiesDefaultHandler.java
--- a/src/share/classes/jdk/internal/util/xml/PropertiesDefaultHandler.java
+++ b/src/share/classes/jdk/internal/util/xml/PropertiesDefaultHandler.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -53,11 +53,11 @@
     private static final String ATTR_KEY = "key";
     // The required DTD URI for exported properties
     private static final String PROPS_DTD_DECL =
-            "<!DOCTYPE properties SYSTEM \"http://java.sun.com/dtd/properties.dtd\">";
+        "<!DOCTYPE properties SYSTEM \"http://java.sun.com/dtd/properties.dtd\">";
     private static final String PROPS_DTD_URI =
-            "http://java.sun.com/dtd/properties.dtd";
+        "http://java.sun.com/dtd/properties.dtd";
     private static final String PROPS_DTD =
-            "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+        "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
             + "<!-- DTD for properties -->"
             + "<!ELEMENT properties ( comment?, entry* ) >"
             + "<!ATTLIST properties"
@@ -135,15 +135,15 @@
     ////////////////////////////////////////////////////////////////////
     // Validate while parsing
     ////////////////////////////////////////////////////////////////////
-    final static String ALLOWED_ELEMENTS = "properties, comment, entry";
+    static final String ALLOWED_ELEMENTS = "comment, entry";
     final static String ALLOWED_COMMENT = "comment";
     ////////////////////////////////////////////////////////////////////
     // Handler methods
     ////////////////////////////////////////////////////////////////////
-    StringBuffer buf = new StringBuffer();
+    StringBuilder buf = new StringBuilder();
+    boolean sawRoot = false; // whether a valid root element exists
     boolean sawComment = false;
     boolean validEntry = false;
-    int rootElem = 0;
     String key;
     String rootElm;
 
@@ -151,32 +151,38 @@
     public void startElement(String uri, String localName, String qName, Attributes attributes)
         throws SAXException
     {
-        if (rootElem < 2) {
-            rootElem++;
+        if (sawRoot) {
+            if (!ALLOWED_ELEMENTS.contains(qName)) {
+                fatalError(new SAXParseException("Element type \"" + qName + "\" must be declared.", null));
+            }
+        } else {
+            // check whether the root has been declared in the DTD
+            if (rootElm == null) {
+                fatalError(new SAXParseException("An XML properties document must contain"
+                    + " the DOCTYPE declaration as defined by java.util.Properties.", null));
+            }
+
+            // check whether the element name matches the declaration
+            if (!rootElm.equals(qName)) {
+                fatalError(new SAXParseException("Document root element \"" + qName
+                    + "\", must match DOCTYPE root \"" + rootElm + "\"", null));
+            }
+
+            // this is a valid root element
+            sawRoot = true;
         }
 
-        if (rootElm == null) {
-            fatalError(new SAXParseException("An XML properties document must contain"
-                    + " the DOCTYPE declaration as defined by java.util.Properties.", null));
-        }
-
-        if (rootElem == 1 && !rootElm.equals(qName)) {
-            fatalError(new SAXParseException("Document root element \"" + qName
-                    + "\", must match DOCTYPE root \"" + rootElm + "\"", null));
-        }
-        if (!ALLOWED_ELEMENTS.contains(qName)) {
-            fatalError(new SAXParseException("Element type \"" + qName + "\" must be declared.", null));
-        }
         if (qName.equals(ELEMENT_ENTRY)) {
             validEntry = true;
             key = attributes.getValue(ATTR_KEY);
             if (key == null) {
-                fatalError(new SAXParseException("Attribute \"key\" is required and must be specified for element type \"entry\"", null));
+                fatalError(new SAXParseException("Attribute \"key\" is required and " +
+                    "must be specified for element type \"entry\"", null));
             }
         } else if (qName.equals(ALLOWED_COMMENT)) {
             if (sawComment) {
                 fatalError(new SAXParseException("Only one comment element may be allowed. "
-                        + "The content of element type \"properties\" must match \"(comment?,entry*)\"", null));
+                    + "The content of element type \"properties\" must match \"(comment?,entry*)\"", null));
             }
             sawComment = true;
         }
@@ -191,8 +197,9 @@
 
     @Override
     public void endElement(String uri, String localName, String qName) throws SAXException {
-        if (!ALLOWED_ELEMENTS.contains(qName)) {
-            fatalError(new SAXParseException("Element: " + qName + " is invalid, must match  \"(comment?,entry*)\".", null));
+        if (!ALLOWED_ELEMENTS.contains(qName) && !ELEMENT_ROOT.equals(qName)) {
+            fatalError(new SAXParseException("Element: " + qName +
+                " is invalid, must match  \"(comment?,entry*)\".", null));
         }
 
         if (validEntry) {
@@ -203,19 +210,12 @@
     }
 
     @Override
-    public void notationDecl(String name, String publicId, String systemId) throws SAXException {
-        rootElm = name;
-    }
-
-    @Override
     public InputSource resolveEntity(String pubid, String sysid)
-            throws SAXException, IOException {
+        throws SAXException, IOException {
         {
             if (sysid.equals(PROPS_DTD_URI)) {
-                InputSource is;
-                is = new InputSource(new StringReader(PROPS_DTD));
-                is.setSystemId(PROPS_DTD_URI);
-                return is;
+                // The properties DTD is known to the handler, no need to parse it
+                return null;
             }
             throw new SAXException("Invalid system identifier: " + sysid);
         }
@@ -235,4 +235,24 @@
     public void warning(SAXParseException x) throws SAXException {
         throw x;
     }
+
+    // SAX2 extension from DTDHandler
+
+    @Override
+    public void startDTD (String name, String publicId, String systemId) throws SAXException
+    {
+        if (!ELEMENT_ROOT.equals(name) || !PROPS_DTD_URI.equals(systemId)) {
+            fatalError(new SAXParseException("An XML properties document must contain"
+                + " the DOCTYPE declaration as defined by java.util.Properties.", null));
+        }
+        rootElm = name;
+    }
+
+    @Override
+    public void startInternalSub () throws SAXException
+    {
+        fatalError(new SAXParseException("Internal DTD subset is not allowed. " +
+            "The Properties XML document must have the following DOCTYPE declaration: \n" +
+            PROPS_DTD_DECL, null));
+    }
 }
diff --git a/src/share/classes/jdk/internal/util/xml/impl/Parser.java b/src/share/classes/jdk/internal/util/xml/impl/Parser.java
--- a/src/share/classes/jdk/internal/util/xml/impl/Parser.java
+++ b/src/share/classes/jdk/internal/util/xml/impl/Parser.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -650,6 +650,8 @@
      * @exception IOException
      */
     private void dtdsub() throws Exception {
+        startInternalSub(); // reports the event before parsing the subset
+
         char ch;
         for (short st = 0; st >= 0;) {
             ch = getch();
@@ -2229,6 +2231,13 @@
             throws SAXException;
 
     /**
+     * Reports the start of DTD internal subset.
+     *
+     * @throws SAXException if the receiver throws SAXException
+     */
+    public abstract void startInternalSub () throws SAXException;
+
+    /**
      * Reports a comment.
      *
      * @param text The comment text starting from first charcater.
diff --git a/src/share/classes/jdk/internal/util/xml/impl/ParserSAX.java b/src/share/classes/jdk/internal/util/xml/impl/ParserSAX.java
--- a/src/share/classes/jdk/internal/util/xml/impl/ParserSAX.java
+++ b/src/share/classes/jdk/internal/util/xml/impl/ParserSAX.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -551,7 +551,16 @@
      * @param sysid The system identifier of the entity or <code>null</code>.
      */
     protected void docType(String name, String pubid, String sysid) throws SAXException {
-        mHandDtd.notationDecl(name, pubid, sysid);
+        mHandDtd.startDTD(name, pubid, sysid);
+    }
+
+    /**
+     * Reports the start of DTD internal subset.
+     *
+     * @throws SAXException if the receiver throws SAXException
+     */
+    public void startInternalSub () throws SAXException {
+        mHandDtd.startInternalSub();
     }
 
     /**
diff --git a/src/share/classes/sun/util/xml/META-INF/services/sun.util.spi.XmlPropertiesProvider b/src/share/classes/sun/util/xml/META-INF/services/sun.util.spi.XmlPropertiesProvider
--- a/src/share/classes/sun/util/xml/META-INF/services/sun.util.spi.XmlPropertiesProvider
+++ b/src/share/classes/sun/util/xml/META-INF/services/sun.util.spi.XmlPropertiesProvider
@@ -1,1 +1,1 @@
-sun.util.xml.PlatformXmlPropertiesProvider
+jdk.internal.util.xml.BasicXmlPropertiesProvider
diff --git a/test/java/util/Properties/Compatibility.xml b/test/java/util/Properties/Compatibility.xml
deleted file mode 100644
--- a/test/java/util/Properties/Compatibility.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd" 
- [<!ENTITY intEnt 'value3'> ]>
-<?PITarget PIContent?>
-<properties>
-<comment>Property With Other Encoding</comment>
-<entry key="Key1">value1</entry>
-<entry key="Key2"><![CDATA[<value2>]]></entry>
-<entry key="Key3">&intEnt;</entry>
-</properties>
diff --git a/test/java/util/Properties/CompatibilityTest.java b/test/java/util/Properties/CompatibilityTest.java
deleted file mode 100644
--- a/test/java/util/Properties/CompatibilityTest.java
+++ /dev/null
@@ -1,107 +0,0 @@
-/*
- * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-/*
- * @test
- * @bug 8005280 8004371
- * @summary Compatibility test
- * @run main CompatibilityTest
- * @run main/othervm -Dsun.util.spi.XmlPropertiesProvider=jdk.internal.util.xml.BasicXmlPropertiesProvider CompatibilityTest
- */
-
-import java.io.FileInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.Properties;
-
-/**
- * This is a behavior compatibility test.
- * Although not defined by the properties.dtd, the constructs
- * in Compatibility.xml are supported by the regular JDK XML
- * Provider.
- *
- * @author: Joe Wang
- */
-public class CompatibilityTest {
-
-    public static void main(String[] args) {
-        testInternalDTD();
-    }
-
-    /*
-     * Not in the spec, but the constructs work with the current JDK
-     */
-    static void testInternalDTD() {
-        String src = System.getProperty("test.src");
-        if (src == null) {
-            src = ".";
-        }
-        loadPropertyFile(src + "/Compatibility.xml");
-    }
-
-    /*
-     * 'Store' the populated 'Property' with the specified 'Encoding Type' as an
-     * XML file. Retrieve the same XML file and 'load' onto a new 'Property' object.
-     */
-    static void loadPropertyFile(String filename) {
-        try (InputStream in = new FileInputStream(filename)) {
-            Properties prop = new Properties();
-            prop.loadFromXML(in);
-            verifyProperites(prop);
-        } catch (IOException ex) {
-            fail(ex.getMessage());
-        }
-    }
-
-    /*
-     * This method verifies the first key-value with the original string.
-     */
-    static void verifyProperites(Properties prop) {
-        try {
-            for (String key : prop.stringPropertyNames()) {
-                String val = prop.getProperty(key);
-                if (key.equals("Key1")) {
-                    if (!val.equals("value1")) {
-                        fail("Key:" + key + "'s value: \nExpected: value1\nFound: " + val);
-                    }
-                } else if (key.equals("Key2")) {
-                    if (!val.equals("<value2>")) {
-                        fail("Key:" + key + "'s value: \nExpected: <value2>\nFound: " + val);
-                    }
-                } else if (key.equals("Key3")) {
-                    if (!val.equals("value3")) {
-                        fail("Key:" + key + "'s value: \nExpected: value3\nFound: " + val);
-                    }
-                }
-            }
-        } catch (Exception e) {
-            fail(e.getMessage());
-        }
-
-    }
-
-    static void fail(String err) {
-        throw new RuntimeException(err);
-    }
-
-}
diff --git a/test/java/util/Properties/invalidxml/IllegalElement.xml b/test/java/util/Properties/invalidxml/IllegalElement.xml
new file mode 100644
--- /dev/null
+++ b/test/java/util/Properties/invalidxml/IllegalElement.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf8" standalone="no"?>
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
+
+<!-- The dtd requires a properties root, but not element -->
+
+<properties>
+<comment>comment</comment>
+    <properties>
+        <entry key="firstKey">value of the first key</entry>
+    </properties>
+</properties>
diff --git a/test/java/util/Properties/invalidxml/invalidDTD.xml b/test/java/util/Properties/invalidxml/invalidDTD.xml
new file mode 100644
--- /dev/null
+++ b/test/java/util/Properties/invalidxml/invalidDTD.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd" 
+ [<!ENTITY intEnt 'value3'> ]>
+<?PITarget PIContent?>
+<properties>
+<comment>Property With Other Encoding</comment>
+<entry key="Key1">value1</entry>
+<entry key="Key2"><![CDATA[<value2>]]></entry>
+<entry key="Key3">&intEnt;</entry>
+</properties>
diff --git a/test/java/util/ResourceBundle/Control/XmlRB.xml b/test/java/util/ResourceBundle/Control/XmlRB.xml
--- a/test/java/util/ResourceBundle/Control/XmlRB.xml
+++ b/test/java/util/ResourceBundle/Control/XmlRB.xml
@@ -2,15 +2,7 @@
 
 <!---->
 
-<!-- DTD for properties -->
-<!DOCTYPE properties [
-<!ELEMENT properties ( comment?, entry* ) >
-<!ATTLIST properties version CDATA #FIXED "1.0">
-<!ELEMENT comment (#PCDATA) >
-<!ELEMENT entry (#PCDATA) >
-<!ATTLIST entry key CDATA #REQUIRED>
-]>
-
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
 <properties>
     <comment>Test data for XMLResourceBundleTest.java</comment>
     <entry key="type">XML</entry>
diff --git a/test/java/util/ResourceBundle/Control/XmlRB_ja.xml b/test/java/util/ResourceBundle/Control/XmlRB_ja.xml
--- a/test/java/util/ResourceBundle/Control/XmlRB_ja.xml
+++ b/test/java/util/ResourceBundle/Control/XmlRB_ja.xml
@@ -2,15 +2,7 @@
 
 <!---->
 
-<!-- DTD for properties -->
-<!DOCTYPE properties [
-<!ELEMENT properties ( comment?, entry* ) >
-<!ATTLIST properties version CDATA #FIXED "1.0">
-<!ELEMENT comment (#PCDATA) >
-<!ELEMENT entry (#PCDATA) >
-<!ATTLIST entry key CDATA #REQUIRED>
-]>
-
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
 <properties>
     <comment>Test data for XMLResourceBundleTest.java</comment>
     <entry key="type">ＸＭＬ</entry>
diff --git a/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB.xml b/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB.xml
--- a/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB.xml
+++ b/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB.xml
@@ -25,15 +25,7 @@
 -->
 <!---->
 
-<!-- DTD for properties -->
-<!DOCTYPE properties [
-<!ELEMENT properties ( comment?, entry* ) >
-<!ATTLIST properties version CDATA #FIXED "1.0">
-<!ELEMENT comment (#PCDATA) >
-<!ELEMENT entry (#PCDATA) >
-<!ATTLIST entry key CDATA #REQUIRED>
-]>
-
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
 <properties>
     <comment>Test data for UserDefaultControlTest.java</comment>
     <entry key="type">XML</entry>
diff --git a/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB_ja.xml b/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB_ja.xml
--- a/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB_ja.xml
+++ b/test/java/util/spi/ResourceBundleControlProvider/providersrc/XmlRB_ja.xml
@@ -25,15 +25,7 @@
 -->
 <!---->
 
-<!-- DTD for properties -->
-<!DOCTYPE properties [
-<!ELEMENT properties ( comment?, entry* ) >
-<!ATTLIST properties version CDATA #FIXED "1.0">
-<!ELEMENT comment (#PCDATA) >
-<!ELEMENT entry (#PCDATA) >
-<!ATTLIST entry key CDATA #REQUIRED>
-]>
-
+<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
 <properties>
     <comment>Test data for UserDefaultControlTest.java</comment>
     <entry key="type">ＸＭＬ</entry>
diff --git a/test/java/util/spi/ResourceBundleControlProvider/rbcontrolprovider.jar b/test/java/util/spi/ResourceBundleControlProvider/rbcontrolprovider.jar
index b7e6a491d7910a79c5f14b8cba79029b252e64f3..f01d60c11b103039ef13d1f582942114ab50ecb1
GIT binary patch
literal 5693
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
A=>Px#