The javadoc of `javafx.scene.image.Image` incorrectly states:

    94    * If a URL uses the "data" scheme, the data must be base64-encoded
    95    * and the MIME type must either be empty or a subtype of the
    96    * {@code image} type.

However, omitting the MIME type of a data URI is specified to imply 
"text/plain" (RFC 2397, section 2). Since the `com.sun.javafx.util.DataURI` 
class is implemented according to this specification, trying to load an image 
without MIME type correctly fails with an `ImageStorageException`: "Unexpected 
MIME type: text".

The solution is to fix the documentation:

      94    * If a URL uses the "data" scheme, the data must be base64-encoded
    + 95    * and the MIME type must be a subtype of the {@code image} type.
    - 95    * and the MIME type must either be empty or a subtype of the
    - 96    * {@code image} type.

-------------

Commit messages:
 - Fixed incorrect documentation of image data URIs

Changes: https://git.openjdk.java.net/jfx/pull/676/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jfx&pr=676&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8277572
  Stats: 32 lines in 2 files changed: 30 ins; 1 del; 1 mod
  Patch: https://git.openjdk.java.net/jfx/pull/676.diff
  Fetch: git fetch https://git.openjdk.java.net/jfx pull/676/head:pull/676

PR: https://git.openjdk.java.net/jfx/pull/676

Reply via email to