API Changes in Structure 5.2

1. Minor Java API Release

There are a few API additions coming with this release. The changes are backwards-compatible, so any code using API 16.x should work fine.

See Structure API Versions for full version information and downloads.

2. Compatible Changes in the Java API

2.1. New methods in the Forest interface

We have added three new methods to the Forest interface and its implementation, ArrayForest:

• long getNextSibling(long row)
• long getNextSiblingForIndex(int index)
• int getNextSiblingIndex(int index)

These methods let you find the next sibling of a row. They complement the existing methods for finding the preceding sibling.

2.2. Data Center-specific licenses

We have updated the licensing API to distinguish Jira Data Center-compatible licenses from regular server and legacy licenses. The additions include:

• LicenseData.isDataCenterCompatible() method checks the license is compatible with Jira Data Center;
• LicenseData.getLicenseHosting() method returns an instance of the new StructureLicenseHosting enum, which tells whether this is a Data Center license, a regular server license, or a "legacy" license.
• StructureLicenseError.NO_DATACENTER_SUPPORT is a new error code reported when an incompatible app license is used on a Data Center instance.

3. JavaScript API for adding item details support

We have added a JavaScript API that allows app developers to implement item details support for specific item types. See registerItemDetailsProvider() and ItemDetailsProvider for details.

There is also an API usage sample that implements item details for Jira users. It can be found on API Usage Samples page, see 'user-item-details'.