United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4528008 : java.awt.image.FilteredImageSource methods need more detail behavior description

Details
Type:
Bug
Submit Date:
2001-11-16
Status:
Closed
Updated Date:
2004-03-20
Project Name:
JDK
Resolved Date:
2003-12-08
Component:
docs
OS:
solaris_7,generic,windows_xp
Sub-Component:
guides
CPU:
x86,sparc,generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.0,5.0
Fixed Versions:
5.0 (b31)

Related Reports
Relates:

Sub Tasks

Description
According to the bug evaluation of 4527255:

"The user is not supposed to be calling addConsumer(),
etc.   These methods are only called by classes that implement the ImageConsumer/ImageProducer interfaces."

However, there is no document saying that addConsumer(), removeConsumer() and
isConsumer() should not be called by users. It also needs to be specified what
happens when the metods are called in an invalid context (e.g. from the class
not implementing ImageConsumer/ImageProducer)

In addition, the following methods in java.awt.image.FilteredImageSource need to
specify their behaviors when null is passed as the argument.

addConsumer(ImageConsumer ic) 
isConsumer(ImageConsumer ic) 
removeConsumer(ImageConsumer ic) 
requestTopDownLeftRightResend(ImageConsumer ic) 
startProduction(ImageConsumer ic) 


Name: vsR10238			Date: 09/24/2003



The following JCK1.5 (b04) tests:
api/java_awt/Image/FilteredImageSource/index.html#Consumer [FilteredImageSource0005, FilteredImageSource0006]
api/java_awt/Image/FilteredImageSource/index.html#RTDLRR [FilteredImageSource0007]
fail due to this bug on Tiger b18-b20

The test cases try to call FilteredImageSource.*Consumer with a null argument
and fail with: 

FilteredImageSource0006: Failed. NullPointerException expected

###@###.###

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

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
generic
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b31
tiger-beta

VERIFIED IN:
tiger-beta2


                                     
2004-06-14
EVALUATION

We should say that these methods shouldn't be called.
###@###.### 2003-11-08
                                     
2003-11-08



Hardware and Software, Engineered to Work Together