Document the Java BulkProcessor

Closes #7638.
Instead of the inline comments, use callouts, eg:

    public void beforeBulk(long executionId, BulkRequest request) { ... }  <1>

then after the closing `-----------`:

    --------------------------------
    <1> The `beforeBulk` method is called just before a bulk operation is executed