Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8186676

Javadoc of SAXSource contains implementation detail

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Approved
    • Icon: P3 P3
    • 10
    • xml
    • None
    • minimal
    • No risk. The change only affects the javadoc.
    • Java API
    • SE

      Summary

      A javax.xml.transform.sax.SAXSource API contains an implementation detail that should be removed.

      Problem

      The specification for the SAXSource constructor contains an implementation detail. It states that it creates a reader via XMLReaderFactory.

      Solution

      The words "via XMLReaderFactory" shall be removed from the specification.

      Specification

      From the specification of public SAXSource(InputSource inputSource), remove the words "via XMLReaderFactory" as follows:

      javax.xml.transform.sax.SAXSource

      public SAXSource​(InputSource inputSource)

        Create a SAXSource, using a SAX InputSource. The Transformer or
      - SAXTransformerFactory creates a reader via XMLReaderFactory (if setXMLReader
      + SAXTransformerFactory creates a reader (if setXMLReader
        is not used), sets itself as the reader's ContentHandler, and calls reader.parse(inputSource).

            joehw Joe Wang
            joehw Joe Wang
            Alan Bateman, Lance Andersen
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: