Thread-safety documentation

[Philippe Marschall]

Hello

One of the issues I have with the current JDBC specification is it's 
approach to thread-safety documentation or rather lack thereof. This 
leads to repeated discussions, see [1].

It would like to see the new API improving in this area by clearly 
specifying which objects are thread-safe and which ones aren't. An 
obvious candidate for thread-safety would be DataSource.

The only reference to thread-safety I could currently find is:

Results are not required to be thread-safe.

But this affects more or less every class, eg. Transaction.

  [1] https://github.com/pgjdbc/pgjdbc/issues/921

Cheers
Philippe