P4
A DESCRIPTION OF THE PROBLEM :
Documentation requirement. Where do you mention the level of threadsafety a class has, built-in?
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
It would be nice, in the reference, to link to a page on threading issues containing the appropriate threading the developer must implement himself for that specific class (or not for that class ). You may have guessed I'm reading "Java Threads" by Oaks and Wong. p. 154 and 157 tells me the Vector class is threadsafe. Can "call add(), remove() and toArray() at the same time without corrupting the internat stator of the Vector object".
ACTUAL -
nothing on the subject. I'm glad I have the "Java threads" book
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/util/Vector.html
Documentation requirement. Where do you mention the level of threadsafety a class has, built-in?
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
It would be nice, in the reference, to link to a page on threading issues containing the appropriate threading the developer must implement himself for that specific class (or not for that class ). You may have guessed I'm reading "Java Threads" by Oaks and Wong. p. 154 and 157 tells me the Vector class is threadsafe. Can "call add(), remove() and toArray() at the same time without corrupting the internat stator of the Vector object".
ACTUAL -
nothing on the subject. I'm glad I have the "Java threads" book
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/util/Vector.html
- duplicates
-
JDK-4078860 API doc comments should describe the concurrency semantics of classes & methods
-
- Open
-