ben-manes / caffeine / #5663

100%

master: 100%

push

github

Document EventDispatcher listener behaviors as by-design

Two no-defect EventDispatcher notes:

- The per-key dispatch-queue slot (compute-append vs whenComplete-remove)
  is race-safe without extra locking: compute is atomic (CHM bin lock) so
  a completing future's cleanup can't interleave the chain-append, and
  cleanup is a conditional remove(key, future) that fires only if that
  future is still the head. No lost/reordered event and no leaked slot.

- Listener registrations dedup by MutableCacheEntryListenerConfiguration
  field-equality (Registration wraps the config in an immutable MCELC and
  both register and deregister key by it), not the caller's config equals.
  Two field-equal but custom-equals-distinct configs register once, not
  twice. Intentional and the more spec-defensible reading: it dedups an
  accidental double-register, gives a stable mutation-immune key, and only
  diverges from the RI on absurdly contrived input.

4194 of 4201 branches covered (99.83%)

8455 of 8455 relevant lines covered (100.0%)

1.0 hits per line