United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4907266 : Jar/ZipInputStream.getNextEntry() missing documentation of null return value.

Details
Type:
Bug
Submit Date:
2003-08-15
Status:
Resolved
Updated Date:
2003-11-23
Project Name:
JDK
Resolved Date:
2003-11-23
Component:
core-libs
OS:
linux,windows_2000
Sub-Component:
java.util.jar
CPU:
x86
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0 (b30)

Related Reports
Duplicate:

Sub Tasks

Description

Name: rmT116609			Date: 08/14/2003


FULL PRODUCT VERSION :
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)


A DESCRIPTION OF THE PROBLEM :
Although reasonably well known, the javadoc for ZipInputStream.getNextEntry and the similar methods in JarInputStream make no mention that null is returned when there is no next entry.  Novices will typically try to available or use exception handling once running off the end.


REPRODUCIBILITY :
This bug can be reproduced always.
(Incident Review ID: 199218) 
======================================================================

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b30
tiger-beta


                                     
2004-06-14
PUBLIC COMMENTS

-
                                     
2004-06-10
EVALUATION

Completely agreed.  Unlike exception specifications, knowledge of the null
return is absolutely vital to using this method, even in "casual" mode.
###@###.### 2003-10-30
                                     
2003-10-30



Hardware and Software, Engineered to Work Together