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

SPEC: description of isRunning(), isActive() is incomplete

XMLWordPrintable



      Name: dkR10031 Date: 12/09/2002



      The J2SE 1.4 API spec reads:

        "javax.sound.sampled
         Interface DataLine

         public boolean isRunning()

         Indicates whether the line is running. The default is false. An open line
         begins running when the first data is presented in response to an
         invocation of the start method, and continues until presentation ceases
         in response to a call to stop or because playback completes."

      The description is incomplete since the specification
      does not specify behavior of the method if data is not presented.

      Also description is ambiguous because specification does not
      define where, when, how, and which "the first data" should be presented in
      response to an invocation of the start method for switching line to
      a running state.

      As well, the specification is unclear about what the distinction of
      the methods isRunning and isActive is.

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

            amenkov Alex Menkov
            dimasunw Dima Dima (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: