Allow to detect Entities which no longer match subscription criteria

[armiol]

This is a port of #1504 to master. Here is a full description of the PR, for reviewer's convenience.

This changeset adds an ability to subscribe to changes in Entity states, which make them no longer matching the subscription criteria.

In particular, this will always be the case if Entity becomes archived or deleted.

The new endpoint is available for Spine client under whenNoLongerMatching() DSL, and is a part of Client's request API:

    var client = client();
    client
        /* ... */
        .subscribeTo(Task.class)
        .observe((task) -> { /* ... */ })
        .whenNoLongerMatching(TaskId.class, (idOfNonMatchingEntity) -> { /* ... */})
        .post();

These changes will also become available to other clients (such as web-related client), once this PR is merged.

Another thing is a change in how subscriptions work for events, by which type the parent Bounded Context cannot be determined. This is the case if events of some type are not explicitly declared in handler methods (i.e. returned as a plain EventMessage). Prior to this PR, a new subscription for events of such types was created in every Bounded Context known to SubscriptionService. But the cancellation of such subscriptions did not work properly (did nothing!).

Now, symmetrically to creating a Subscription in "no-parent-context-found" use-case (i.e. creating it in every known Bounded Context), such a subscription is cancelled in all known Bounded Contexts as well.

The library version is now set to 2.0.0-SNAPSHOT.147.

[sonatype-lift]

🛠 Lift Auto-fix

Some of the Lift findings in this PR can be automatically fixed. You can download and apply these changes in your local project directory of your branch to review the suggestions before committing.¹

# Download the patch
curl https://lift.sonatype.com/api/patch/github.com/SpineEventEngine/core-java/1517.diff -o lift-autofixes.diff

# Apply the patch with git
git apply lift-autofixes.diff

# Review the changes
git diff

Want it all in a single command? Open a terminal in your project's directory and copy and paste the following command:

curl https://lift.sonatype.com/api/patch/github.com/SpineEventEngine/core-java/1517.diff | git apply

Once you're satisfied, commit and push your changes in your project.

Footnotes

1. You can preview the patch by opening the patch URL in the browser. ↩

[armiol]

@alexander-yevsyukov PTAL.

[codecov]

Codecov Report

Merging #1517 (0d4a6e5) into master (1eef060) will increase coverage by 0.17%.
The diff coverage is 87.44%.

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #1517      +/-   ##
============================================
+ Coverage     89.71%   89.88%   +0.17%     
- Complexity     4934     4984      +50     
============================================
  Files           635      644       +9     
  Lines         15454    15618     +164     
  Branches        888      901      +13     
============================================
+ Hits          13864    14039     +175     
+ Misses         1286     1266      -20     
- Partials        304      313       +9     

[alexander-yevsyukov]

LGTM with few minor requests on null-checking

[alexander-yevsyukov]

Can we check for null input here, please?

[alexander-yevsyukov]

Please check for null input here too.

[alexander-yevsyukov]

Please check for null input.

[alexander-yevsyukov]

Please check for null input.

[alexander-yevsyukov]

Please add trailing empty line.

[armiol]

As discussed vocally, we don't generally perform null-checks for the ctor parameters if the API is package-level.

Therefore, comments related to this issue were not addressed.