Missing source code?

[whm]

Should the source for all the classes in the three 3.1.0 jars be in richfaces-ui-3.1.0-src.zip?

I've really got that stupid question feeling but I'm having trouble finding the source for various RichFaces classes. For one example, HtmlDndParam is in richfaces-ui-3.1.0.jar but not in richfaces-ui-3.1.0-src.zip.

I see this:

% jar tvf richfaces-ui-3.1.0.jar | grep HtmlDndParam
2348 Wed Sep 12 17:39:20 MST 2007 org/richfaces/component/html/HtmlDndParam.class
% jar tvf richfaces-ui-3.1.0-src.zip | grep HtmlDndParam
%

I wondered if maybe some src files have multiple classes so I searched the concatenation of all .java files in the src zip for HtmlDndParam but didn't find even one occurrence.

With a little script I found that richfaces-ui-3.1.0-src.zip has the source for all classes in richfaces-api-3.1.0.jar, but doesn't have source for 20 of the classes in richfaces-impl-3.1.0.jar and also doesn't have the source for 212 of the classes in richfaces-ui-3.1.0.jar

But it's late and I might be missing something... :)

[sergeysmirnov]

[ Update: the links below are out-of-date because new versions are released.
See RichFaces. Most Important Links for the actual links for current version. ]

This is a good question.

As you probably know that RichFaces are built using CDK (Component Development Kit). CDK generates the library based on the meta-data, component templates and hand-written java classes (It also runs the unit test,s generate the tld and api docs etc, but it is another store)

What you see in the richfaces-ui-3.1.0-src.zip is a truly source. I.e. a source for CDK. Those are the same files you can see in the SVN.

To the debug purpose, you need the source code that is generated by CDK before it is compiled into the binary.

Where to take such "source code"?

If you were use Maven, the Maven knows it. If you name is not Maven, you probably need more verbose instructions.

This is a typical place in the Maven repo where the nightly builds (SNAPSHOTs) are stored:
http://maven.exadel.com/org/richfaces/ui/richfaces-ui/3.1.1-SNAPSHOT/

You can see a richfaces-ui-3.1.1-XXXXXXXX.XXXXXXX-X-sources.jar there. It is "source code" for debugging purpose.

Those are the "source code" for nightly API and IMPL jars:
http://maven.exadel.com/org/richfaces/framework/richfaces-api/3.1.1-SNAPSHOT/
http://maven.exadel.com/org/richfaces/framework/richfaces-impl/3.1.1-SNAPSHOT/

The RichFaces 3.1.0 GA:
http://repository.jboss.com/maven2/org/richfaces/ui/richfaces-ui/3.1.0/richfaces-ui-3.1.0-sources.jar
http://repository.jboss.com/maven2/org/richfaces/framework/richfaces-api/3.1.0/richfaces-api-3.1.0-sources.jar
http://repository.jboss.com/maven2/org/richfaces/framework/richfaces-impl/3.1.0/richfaces-impl-3.1.0-sources.jar


P.S. If you have Maven installed and use Eclipse with WTP or Red Hat Dev Studio (ex Exadel Studio), the command :

mvn eclipse:eclipse -DdownloadSources=true -Dwtpversion=1.5

allows to debug with source code automatically included. For more information see:
http://labs.jboss.com/wiki/HowToConfigureMavenForRichFaces

[sergeysmirnov]

Update:
Since Sept 26, 2007, the snapshot are moved to jboss site. So, to take the latest version, in the link above replace:
http://maven.exadel.com/
with
http://snapshots.jboss.org/maven2/