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

/build/
/dist/
/.idea/
nbproject/private/
/webrev
/.src-rev
/.jib/
.DS_Store
.metadata/
.recommenders/
test/nashorn/script/external
test/nashorn/lib
NashornProfile.txt
**/JTreport/**
**/JTwork/**