File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
The moose likes Cattle Drive and the fly likes Reliability of Java source Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » This Site » Cattle Drive
Bookmark "Reliability of Java source" Watch "Reliability of Java source" New topic

Reliability of Java source

Michael Matola
Ranch Hand

Joined: Mar 25, 2001
Posts: 1793
Back in this old thread I wrote, regarding the Java source code files that come with the SDK:
I think there's some disclaimer from Sun that they don't guarantee that the source code provided is what they actually compile into Java, but that it's some "typical" implementation.

And Marilyn replied:
I've heard others say that, but I've never seen any disclaimer like that.

I did find what I think I was basing my assertion on in the readme.html file that comes with the SDK.
From that document:

Source Code
(In Java programming language source files for all classes that make up the Java 2 core API (that is, sources files for the java.*, javax.* and some org.* packages, but not for com.sun.* packages). This source code is provided for informational purposes only, to help developers learn and use the Java programming language. These files do not include platform-specific implementation code and cannot be used to rebuild the class libraries. To extract these file, use any common zip utility. Or, you may use the Jar utility in the Java 2 SDK's bin directory:
jar xvf

So I *was* overstating the case.
I think when I read some previous version of this statement some time ago I mistakenly combined "for informational purposes only" and "cannot be used to rebuild the class libraries" into "is not guaranteed to be the actual source." Plus hearing others make the same false conclusion and claims as I did probably just reinforced the error.
So there we have it! It's the real source, but you don't have everything you need to compile it all into Java. (And of course we should all code to the API as specified in documentation and not to source we read, because the implementation could always change in future releases.)
Marilyn de Queiroz

Joined: Jul 22, 2000
Posts: 9059
Thanks for the update, Michael

"Yesterday is history, tomorrow is a mystery, and today is a gift; that's why they call it the present." Eleanor Roosevelt
I agree. Here's the link:
subject: Reliability of Java source
It's not a secret anymore!