On Nov 16, 2008, at 5:56 AM, Gili wrote:
>
> I found some example code at the bottom of:
> https://jersey.dev.java.net/source/browse/*checkout*/jersey/tags/jersey-1.0/api/jersey/com/sun/jersey/api/client/package-summary.html
>
> 1) I would suggest including this example code in the brief
> description of
> WebResource.
>
> 2) It isn't immediately clear what the API will do if a request
> returns a
> failure. Please note that WebResource.get() doesn't document any
> exceptions
> being thrown whereas UniformInterface.get() which it overrides throws
> UniformInterfaceException. You should probably document this @throws
> in any
> class inheriting from UniformInterface to avoid this kind of
> confusion.
>
I fixed it so the exceptions are on the WebResource as well and there
is a @see link to the client package (rather than duplicating the
information).
Paul.
> Gili
>
>
> Gili wrote:
>>
>> Hi Paul,
>>
>> Can you please clarify the documentation of
>> UniformInterface.options(Class<T>)? It's not clear kind of values
>> make
>> sense for "c". I was expecting this method to return a
>> List<MethodType> or
>> something... The Javadoc should probably give an example of typical
>> value
>> for "c".
>>
>> Thanks,
>> Gili
>>
>
> --
> View this message in context: http://n2.nabble.com/UniformInterface.options%28Class%3CT%3E%29-not-clear-tp1505000p1505023.html
> Sent from the Jersey mailing list archive at Nabble.com.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_jersey.dev.java.net
> For additional commands, e-mail: users-help_at_jersey.dev.java.net
>