[JSR_283-810] Export packages at version 1.1 in addition to 2.0 Created: 13/Aug/12  Updated: 13/Aug/12

Status: Open
Project: jsr-283
Component/s: javadoc/api
Affects Version/s: None
Fix Version/s: None

Type: Improvement Priority: Major
Reporter: fmeschbe Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: Text File export-version.patch    


The JCR API bundle/library exports the JCR API at version 2.0 – specifically the API is exported with the same version as the bundle version.

Compared to JCR 1.0 (JSR-170) this signifies a major version change. According to the OSGi Semantic Versioning recommendation [1] a major version change on an exported package indicates backwards incompatible changes.

It is my understanding, though, that JCR 2.0 is fully backwards compatible with JCR 1.0 hence the API exports should not indicate backwards incompatiblity.

As a fix I propose to export the API with two versions:

1.1 to support OSGi bundles written against the JCR 1.0 API and
importing with recommended version range [1.0,2)
2.0 to not break bundles written against the JCR 2.0 API bundle

Patch attached.

Generated at Tue Mar 31 18:40:45 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.