Javadoc of SAXSource contains implementation detail

XMLWordPrintable

    • Type: CSR
    • Resolution: Approved
    • Priority: P3
    • 10
    • Component/s: 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).
      

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

              Created:
              Updated:
              Resolved: