Over a million developers have joined DZone.

Consistency Checks for Eclipse RCP Applications

· Java Zone

Learn more about how the Java language, tools and frameworks have been the foundation of countless enterprise systems, brought to you in partnership with Salesforce.

The Eclipse Runtime enables you to create a well-formed modular architecture for Java applications. Each OSGi bundle has a unique name space and explicitly declares the imported/exported packages, and the Runtime enforces these rules.


However, arranging application jars into a set of OSGi bundles may be tricky and error-prone, especially if the application jars are "strongly connected", that is, have lots of cross-references. The typical issues that may arise are

  • redundant classes: two jars contain classes with the same package and class name and the jars are placed in the same OSGi bundle. In this case, the classes from one jar will be actually used at run time and the others become "deployment baggage"

  • absent classes: a piece of code references a class that cannot be found within the bundle and is not exported from the other bundles. Unless the "wanted" class appears at run time, ClassNotFoundException will be thrown when control reaches that code.

    If your test suite does not achieve 100% code coverage (including third-party jars), there is a chance that the problem will manifest itself on end user systems.

Static checks to the rescue

To detect such inconsistencies before deployment, you may use Excelsior JET 6.5 beta. The JET Control Panel can analyze your Eclipse RCP application and report the found issues. Under the covers, it takes the OSGi bundles of your application and statically applies the resolution procedure used by the Eclipse Runtime as if the application was started and the bundles were loaded.

The results

When implementing this feature, we were really curious if such warnings would be found in real Eclipse RCP applications, and the answer came soon. Here go two examples:

Eclipse Classic IDE 3.4 (Ganymede)
Redundant (duplicated) classesReferenced absent classesUnresolved super classes

A large commercial RCP application
Redundant (duplicated) classesReferenced absent classesUnresolved super classes

Note that "unresolved super class" is a severe warning. If the code of a method just references an absent class, say, invokes a method or uses a field of that class, ClassNotFoundException is thrown only when the referencing code is executed. You are lucky if that code is on a rarely executed branch and the enclosing method runs fine in most cases ( of course, this is an optimistic assumption :). On the contrary, an absent super class prevents any usage of any classes derived from it because ClassNotFoundException will be thrown immediately when loading such a derived class.

Finally, if the application works flawlessly since it never uses the problematic classes, what is the point of deploying them to end user systems?

Try it yourself

To avoid surprises, check your Eclipse RCP application for consistency before deployment:

  1. Download and install Excelsior JET 6.5 beta
  2. Start the JET Control Panel and click "Eclipse RCP Application" on the welcome screen
  3. Specify the directory to which your RCP application was exported either by the Product Export Wizard or by an automated build process
  4. Go to the page Classpath and press the "Check consistency" button in the bottom pane

As analysis completes, the detailed report will be displayed in a separate dialog.

You may then inspect the problematic bundles and classes and get the report in text form.

Take care!


Now you may perform the consistency checks using the GUI of the Excelsior JET product. We consider implementing a free Eclipse plug-in that provides the functionality. If you find it useful please send us your feedback. Your comments and suggestions are very welcome.

Discover how the Force.com Web Services Connector (WSC) is a code-generation tool and runtime library for use with Force.com Web services, brought to you in partnership with Salesforce.


The best of DZone straight to your inbox.

Please provide a valid email address.

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}