Uploaded image for project: 'Jackrabbit Oak'
  1. Jackrabbit Oak
  2. OAK-10252

Distinguish in oak-jackrabbit-api between provider and consumer type interfaces

    XMLWordPrintableJSON

Details

    Description

      Currently there is almost no annotation related to Provider or Consumer type maintained on the interfaces of https://github.com/apache/jackrabbit-oak/tree/trunk/oak-jackrabbit-api.

      That leads to a default of almost all interfaces being assumed ConsumerType and therefore requiring all backwards-incompatible changes (for implementations) a major version increment (which breaks every consuming bundle).

      For ProviderType interfaces (https://docs.osgi.org/javadoc/osgi.annotation/7.0.0/org/osgi/annotation/versioning/ProviderType.html)

      A non-binary-compatible change to a provider type normally requires incrementing the major version of the type's package. This change will require all providers and all consumers to be updated to handle the change. However, a non-binary-compatible change affecting a protected access member only requires incrementing the minor version of the type's package. This change will require all providers to be updated to handle the change, but consumers will not require changes since they only use, and do not extend, the provider type and thus could not access protected access members of the provider type.

      While for ConsumerType interfaces (the default)
      (https://docs.osgi.org/javadoc/osgi.annotation/7.0.0/org/osgi/annotation/versioning/ConsumerType.html)

      A non-binary-compatible change to a consumer type or a binary-compatible change to a consumer type affecting an abstract method normally requires incrementing the major version of the type's package. This change will require all providers and all consumers to be updated to handle the change since consumers that implement or extend the consumer type and all providers must understand the change in the consumer type.

      Attachments

        Issue Links

          Activity

            People

              kwin Konrad Windszus
              kwin Konrad Windszus
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: