hg: jdk/sandbox: 8217627: HttpClient: The API documentation of BodySubscribers::mapping promotes bad behavior

[chris.hegarty at oracle.com]

Changeset: 04dcc65c9d58
Author:    dfuchs
Date:      2019-01-25 18:13 +0000
URL:       http://hg.openjdk.java.net/jdk/sandbox/rev/04dcc65c9d58

8217627: HttpClient: The API documentation of BodySubscribers::mapping promotes bad behavior
Summary: The API documentation is updated to steer away from blocking in the mapper function, and an alternative is suggested.
Reviewed-by: chegar

! src/java.net.http/share/classes/java/net/http/HttpResponse.java
! test/jdk/java/net/httpclient/examples/JavadocExamples.java