United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4722261 : Clarification in spec for javax.imageio.FileImageOutputStream

Details
Type:
Bug
Submit Date:
2002-07-29
Status:
Resolved
Updated Date:
2004-04-02
Project Name:
JDK
Resolved Date:
2003-09-29
Component:
client-libs
OS:
generic
Sub-Component:
javax.imageio
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.0_03
Fixed Versions:
5.0 (tiger)

Related Reports
Relates:

Sub Tasks

Description
An issue has arisen concerning a 1.4 JCK test that is being run on a licensee system.The licensee wants that JCK test javax_imageio/stream/FileImageOutputStream/Ctor should
 be excluded because of bug #4353929. The reason for this test failing on the licensee's system is  a file and a directory can each have the same name at the same time -- ie they have distinct namespaces, not a single shared namespace.  After a detailed discussion with JCK, javax.imageio Engineering team, Mark Reinhold, it was decided that this is an issue with the spec itself.

Proposed changes for spec are in Tiger release time frame.

The spec for FileImageOutputStream should be changed to something like : 

    @throws FileNotFoundException
    If the given file object does not denote an existing, writable regular file
    and a new regular file of that name cannot be created, or if some other
    error occurs while opening or creating the file

                                    

Comments
EVALUATION

The description is only partially correct as primarily this is related
to ambiguities in the java.io.File spec filed as bug 4722178
Specifically there is a difference of interpretation over what the phrase
"instead of a regular file" adds in the context of the circumstances
java.io APIs might throw FileNotFoundException.
This will be a spec clarification only, with no semantic change intended.
No spec change is proposed. Nor are code changes needed. Once the spec
in java.io.File is clarified, then Image I/O API docs can copy the wording
there to adopt the same clarification, and hopefully remove the possibility
of future differences of interpretation, whilst accommodating platform
differences. This will not affect users of the API, nor change the intent
of the specification. 

###@###.### 2002-07-29
============================

Removed reference to directories in the exception documentation.

###@###.### 2003-09-15
===========================
                                     
2002-07-29
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger

FIXED IN:
tiger

INTEGRATED IN:
tiger
tiger-b22


                                     
2004-06-14



Hardware and Software, Engineered to Work Together