United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4934462 SPEC: Document that Clip.open() throws IAE
JDK-4934462 : SPEC: Document that Clip.open() throws IAE

Details
Type:
Bug
Submit Date:
2003-10-08
Status:
Resolved
Updated Date:
2003-10-24
Project Name:
JDK
Resolved Date:
2003-10-24
Component:
client-libs
OS:
generic
Sub-Component:
javax.sound
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
5.0
Fixed Versions:
5.0 (b26)

Related Reports
Relates:

Sub Tasks

Description

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

                                    

Comments
EVALUATION


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

Document that Clip.open() throws IAE
                                     
2004-06-10
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b26
tiger-beta


                                     
2004-06-14



Hardware and Software, Engineered to Work Together