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 17.x should work fine.

Jira Version

New API Version

8.5+

17.10.0

See Structure API Versions for full version information and downloads.

2. Compatible Changes in the Java API

We have added CoreEffects.setSprint(Issue, Long) method that creates a description of an effect for moving issue to a sprint with a provided id.

EffectorProcessManager.validateStartProcess(String, Map<String, Object>, ForestSpec) method has been added for validating a one-off effector process without starting it.

We have clarified the meaning of Effector.isAvailable() method, please refer to the Javadoc for details.

BulkAccessibleItemType interface has been added to support bulk items loading. Bulk items loading is used to optimize item attributes loading so implementing this interface by an item type class might improve attributes loading performance.

ItemResolver has new methods for resolving multiple items, bulk resolve is used when it is supported by an item type:

  • resolveItems(Collection<ItemIdentity>, Class<T>, BiConsumer<ItemIdentity, T>)
  • resolveItemsUnchecked(Collection<ItemIdentity>, BiConsumer<ItemIdentity, Object>)