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

DocumentLS.setAsync(false/true): unclear spec

XMLWordPrintable

    • 1.3
    • sparc
    • solaris_2.6

        Name: sdR10048 Date: 09/26/2003


        Filed By : SPB JCK team (###@###.###)
        JDK : java full version "1.5.0-beta-b20"

        Specification excerpt:
        ======================
        --------- J2SE API spec v.1.5 ---------
        ...
        public void setAsync(boolean async)
                      throws org.w3c.dom.DOMException
        Indicates whether the method DocumentLS.load() should be synchronous or asynchronous. When the async attribute is set to true the load method returns control to the caller before the document has completed loading. The default value of this attribute is true.

        Throws:
        org.w3c.dom.DOMException - NOT_SUPPORTED_ERR: Raised if the implementation doesn't support the mode the attribute is being set to.
        ...
        ---------- end-of-excerpt ---------------

        Problem description
        ===================
        It is not quite clear whether it possible to get DOMException(NOT_SUPPORTED_ERR)in setAsyync(false). Current wording "if the implementation doesn't support the mode the attribute is being set to" accept that we can get exception even in setAsync(false) case.

        I believe that is not correct: if we support DocumentLS then we do support async == false anyway.

        Touched (but not failing) testcases:
        api/org_w3c/dom/ls/DocumentLS/index.html#misc[misc0006]


        ======================================================================

              jsuttorsunw Jeff Suttor (Inactive)
              dsvsunw Dsv Dsv (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: