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

SPEC: Document that Clip.open() throws IAE

XMLWordPrintable

    • b26
    • generic
    • generic



      Name: fb126949 Date: 10/08/2003


      When calling the open() method without parameters (inherited from interface Line) in an instance of Clip, an IllegalArgumentException is thrown. This behavior has always existed.

      However, javadoc of Line.open() states:
        This method takes no arguments, and opens the
        line with the current settings. For
        SourceDataLine and TargetDataLine objects, this
        means that the line is opened with default
        settings. For a Clip, however, the buffer size
        is determined when data is loaded. Since this
        method does not allow the application to specify
        any data to load, it allocates resources for a
        clip with zero frames of data, and there is no
        means for subsequently loading data into that
        clip. Therefore, you should instead use one of
        the open methods provided in the Clip interface
        to load data into the Clip.

      This is not useful and it was never implemented like that. Therefore the text above should be changed to specify explicitely that IAE is thrown if Clip.open() is called.


      ======================================================================
      ###@###.### 2003-10-22
      checked in bug fix

            kpsmith Kevin Smith (Inactive)
            fbomerssunw Florian Bomers (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: