Wednesday, June 20, 2007

Default export granularity

In the comparison of JSR 277 and JSR 291 features, I caused some confusion by saying the default export granularity was 'class' for JSR 277 and 'package' for JSR 291. I'll try to explain.

The primitive unit of export in JSR 277 is the class. You can use a wildcard to export all of a module's classes in a specified package, but that's just syntactic sugar. The wildcard will be expanded to a list of classes in the binary file representing the module's superpackage. There is no runtime notion of an exported package.

The primitive unit of export in JSR 291, on the other hand, is the package. You can filter the set of classes available to importers, but the runtime deals in exported packages rather than classes.

I hope that's a bit clearer. Also, try not to confuse default export granularity with import semantics. JSR 277 supports only module import whereas JSR 291 supports package and module imports.

4 comments:

AlBlue said...

I'm curious ... how does one filter out classes from an export package?

Glyn said...

Using 'include' and 'exclude' directives, e.g.

Export-Package: org.foo.p; exclude:="*Impl"

mcculls said...

thanks, that's much clearer

btw, is it possible for different modules to export a different (but potentially overlapping) set of classes from the same package?

Glyn said...

Distinct modules can certainly export arbitrary sets of classes sharing a common package name and these sets could overlap. This is true in JSR 277 and JSR 291.

A so-called 'split' package occurs when two or more such sets of classes are imported by another module. JSR prohibits split packages whereas JSR 291 accommodates them (but only via require-bundle - never via import-package).

Since each module has its own class loader, two classes sharing a common package name but belonging to distinct modules do not belong to the same runtime package. In particular, they couldn't access each other's package private members.

For this and other reasons split packages need handling with some care. The main reason to support split packages in JSR 291 was the requirement to be able to refactor large 'legacy' packages comprising two or more relatively independent pieces but without impacting code using the packages.

Projects

OSGi (130) Virgo (59) Eclipse (10) Equinox (9) dm Server (8) Felix (4) WebSphere (3) Aries (2) GlassFish (2) JBoss (1) Newton (1) WebLogic (1)

Blog Archive