RFR: 8293839: Documentation memory consistency effects of runLater

Jens Lidestrom duke at openjdk.org
Thu Sep 15 07:06:31 UTC 2022


Prior to this change it was not clear from the documentation if callers of Platform#runLater must perform
any synchronisation to have writes of the calling thread be visible in the JavaFX Application
Thread. It is important to document either if callers can rely on runLater to do such synchronisation
internally, or to document is users CAN NOT rely on runLater for this.

This change documents that actions in a thread prior to submitting a runnable to
Platform#runLater happen-before actions performed by the runnable in the JavaFX
Application Thread.

runLater inherits the memory consistency effects of InvokeLaterDispatcher in most cases. 
InvokeLaterDispatcher uses BlockingDeque internally. This change documents this
in the same way as it is documented by BlockingDeque.

Other implementations of runLater should have similar memory consistency effects.

-------------

Commit messages:
 - Remove trailing
 - Document memory consistency effects of runLater

Changes: https://git.openjdk.org/jfx/pull/872/files
 Webrev: https://webrevs.openjdk.org/?repo=jfx&pr=872&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8293839
  Stats: 6 lines in 1 file changed: 6 ins; 0 del; 0 mod
  Patch: https://git.openjdk.org/jfx/pull/872.diff
  Fetch: git fetch https://git.openjdk.org/jfx pull/872/head:pull/872

PR: https://git.openjdk.org/jfx/pull/872


More information about the openjfx-dev mailing list