NicoNes

@spericas Sure, I'll do it.

Hi @jansupol , > Javadoc to `getEntity` says: > > > If the entity is represented by an un-consumed input stream the method will return the input stream. > >...

Its not the point of this issue, but following is not totally right > > > If the entity is represented by an un-consumed input stream the method will return...

I agree that javadoc wording (_un-consumed_, _fully consumed_, _consumed_) are a bit confusing. So let's try to make that clear to get a precise idea of what those methods are...

About case 4, I think it's important to be clear that any subsequent invocation of `readEntity(xxx.class)` whatever the xxx type must throw an IllegalStateException: (4) readEntity(Foo.class) -> Foo, readEntity(XXX.class) ->...

@spericas Yes sure I will do it :+1:

Hi Guys, Quick update to let you know that it is in progress. We are working on it with @ronsigal who spoted the same confusion in the doc (https://github.com/eclipse-ee4j/jaxrs-api/issues/706).

Hey @ronsigal, I agree with you on point 1. About point 2, I agree that things would be clearer without this specific `IllegalStateException` and it would be great for a...

Hey guys, Forget about my last comment. I fully agree with @ronsigal. I was reading again the version I sent to him and I figured out that few cases, the...

Hey @spericas , Good catch. In (5), the `InputStream` is fully consumed (i.e inputStream.read()==-1) and also closed. So: (5) **readEntity(Foo.class) -> Foo, readEntity(InputStream.class) -> IllegalStateException** The general rule must be...