OACC v2.0.0-rc.5

Release date: 2015-11-17

Summary of changes in this release:

• adds support for creating resources with an external id as an alternate resource identifier
• adds externalId to Resource and modifies getId() to return Long instead of a primitive
• adds support for all API methods that take a resource, to handle the alternate externalId identifier
• resolves and validates resource references passed to the API
• normalizes and validates permissions passed to the API
• deprecates the getInstance() permission factory methods that take a boolean indicating the grant option and replaces them with dedicated getInstanceWithGrantOption() methods
• deprecates withGrant in all permissions and replaces it with withGrantOption for clarity
• refactors implementation to remove redundant map traversals and to extract duplicate code blocks
• adds calls to close jdbc statements in tests where it was missing in several instances, and updates Oracle database config properties to use UCP datasource for the tests
• updates test suite for the aforementioned changes

Summary of API changes:

• New feature External id as alternate resource reference
  • Prior to this release, OACC exported a single numerical resourceId as the minimal way of coupling, instead of importing a client value, so as to allow the most flexibility in how clients can integrate OACC into their application.
    Now OACC allows a client application to specify a single String representation of a globally unique externalId to create and reference resources, so that clients can avoid having to store the resourceId generated by OACC
  • adds support to provide alternate resource identifier to createResource() with externalId String parameter
  • allows one-time setting of alternate resource identifier to an existing resource via the new setExternalId() method
  • adds externalId to Resource and modifies getId() to return Long instead of a primitive
• Deprecation deprecates withGrant in all permission objects and replaces it with withGrantOption for clarity
• Deprecation deprecates the getInstance() permission factory methods that take a boolean to indicate the grant option and replaces them with dedicated getInstanceWithGrantOption() methods

Corresponding oacc-db release:
The version of the oacc-db database configuration scripts to be used with this release can be found here.