OACC Framework v2.0.0-rc.5 Release Notes

Release Date: 2015-11-18 // over 8 years ago
  • ๐Ÿš€ 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.