RFR: 8271865: SortedList::getViewIndex behaves not correctly for some index values [v3]

[drmarmac]

> This PR adds the missing checks, as well as code documentation that an IndexOutOfBoundsException may be thrown.

drmarmac has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains five additional commits since the last revision:

 - Merge remote-tracking branch 'refs/remotes/origin/master' into fixes/transformation-list-oob
 - use `@code` syntax
 - JavaDoc updates
 - TransformationList.getSourceIndex/getViewIndex should throw IOOBE
 - Add failing test

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

Changes:
  - all: https://git.openjdk.org/jfx/pull/1432/files
  - new: https://git.openjdk.org/jfx/pull/1432/files/b86cdfe8..e72f21cf

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jfx&pr=1432&range=02
 - incr: https://webrevs.openjdk.org/?repo=jfx&pr=1432&range=01-02

  Stats: 18143 lines in 606 files changed: 11428 ins; 4729 del; 1986 mod
  Patch: https://git.openjdk.org/jfx/pull/1432.diff
  Fetch: git fetch https://git.openjdk.org/jfx.git pull/1432/head:pull/1432

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