Commits on Dec 10, 2021

1. Improve BlockingIterable javadoc …

   Motivation:
   
   `BlockingIterable` and `BlockingIterator` methods can throw
   `InterruptedException` using the sneaky-throw mechanism. The reason for
   it is that implementations rely on `BlockingQueue` which may be
   interrupted. However, as `BlockingIterator` extends `Iterator` from the
   JDK, its' method signatures don't list any checked exception. Therefore
   it would be inconsistent to have some methods declare checked
   exceptions, while the overridden ones not.
   
   Modification:
   
   Add javadoc notes to all methods that can throw `InterruptedException`
   to `BlockingIterable` and `BlockingIterator`.
   
   Result:
   
   The runtime behavior is better described via javadoc.

   Dariusz Jędrzejczyk committed Dec 10, 2021
   Configuration menu

   • View commit details
   • Copy full SHA for 40d3d89
   • Browse repository at this point

   Copy the full SHA

   40d3d89 View commit details

   Browse the repository at this point in the history