S3AsyncClient#selectObjectContent documentation incorrect about aws-sdk-java-v2 HOT 3 OPEN

note: perhaps it's actually/also the implementation that's wrong, and it should return a Future<Result> rather than a Future<Void>? It for sure it's not easy to get the results from the ResponseHandler

from aws-sdk-java-v2.

CompletableFuture<Void> is correct, it's not a bug.

SelectObjectContent is an event stream operation, so you need to use the SelectObjectContentResponseHandler to handle the response stream.

I see we don't have a S3 SelectObjectContent example in our Developer Guide, I'll work with our Docs Team and add one. In the meantime, take a look at the code in our Integration Tests and see if it's helpful -
https://github.com/aws/aws-sdk-java-v2/blob/master/services/s3/src/it/java/software/amazon/awssdk/services/SelectObjectContentIntegrationTest.java#L51

from aws-sdk-java-v2.

I see, I would have expected the returned value to hold some sort of API for streaming the response -- sort of like the V1 sync client does.

The examples do help, though it's a bit dishearting to see that the exposed API is so low level: Records message: Can contain a single record, partial records, or multiple records. Depending on the size of the result, a response can contain one or more of these messages. getting a stream of records out of the stream of messages is something I would have expected the SDK to do, not something to be done on the application level.

Documentation with an example that shows getting a stream of messages in CSV and JSON output would be very handy, since that's the intended use.

from aws-sdk-java-v2.