JDK-4934462 : SPEC: Document that Clip.open() throws IAE
  • Type: Bug
  • Component: client-libs
  • Sub-Component: javax.sound
  • Affected Version: 5.0
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2003-10-08
  • Updated: 2017-05-16
  • Resolved: 2003-10-24
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
5.0 b26Fixed
Related Reports
Relates :  

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

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger-beta FIXED IN: tiger-beta INTEGRATED IN: tiger-b26 tiger-beta

PUBLIC COMMENTS Document that Clip.open() throws IAE

EVALUATION ###@###.### 2003-10-09 Easy to fix in the javadoc. No implementation changes necessary.