users@jersey.java.net

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

From: Gili <cowwoc_at_bbs.darktech.org>
Date: Mon, 17 Nov 2008 08:02:31 -0800 (PST)

        Don't forget AsyncResource and any other class that subclasses
UniformInterface...

Gili

Paul Sandoz (via Nabble) wrote:
>
> 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@...
> <http://n2.nabble.com/user/SendEmail.jtp?type=node&node=1508924&i=0>
> > For additional commands, e-mail: users-help@...
> <http://n2.nabble.com/user/SendEmail.jtp?type=node&node=1508924&i=1>
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@...
> <http://n2.nabble.com/user/SendEmail.jtp?type=node&node=1508924&i=2>
> For additional commands, e-mail: users-help@...
> <http://n2.nabble.com/user/SendEmail.jtp?type=node&node=1508924&i=3>
>
>
>
> ------------------------------------------------------------------------
> This email is a reply to your post @
> http://n2.nabble.com/UniformInterface.options%28Class%3CT%3E%29-not-clear-tp1505000p1508924.html
> You can reply by email or by visting the link above.
>

-- 
View this message in context: http://n2.nabble.com/UniformInterface.options%28Class%3CT%3E%29-not-clear-tp1505000p1510007.html
Sent from the Jersey mailing list archive at Nabble.com.