users@jersey.java.net

Re: [Jersey] UniformInterface.options(Class<T>) not clear

From: Gili <cowwoc_at_bbs.darktech.org>
Date: Sat, 15 Nov 2008 20:56:10 -0800 (PST)

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.

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.