1) SPI packages
My feeling so far is that I would prefer to see the SPI removed from the
JSR. I'm ready to change my mind, if I see how this can make the
implementation of the annotation easier on top of the Restlet API.
Currently, it seems to me that it would make it more complex.
Even if we separate the API and SPI javadocs for our discussion, the result
JSR, as included in the JEE Javadocs, will contain all the packages.
2) Package name
It is indeed confusing to have so many 'ws' packages:
- javax.jws
- javax.jws.soap
- javax.ws.rs
- javax.xml.ws
On the paper, it seems more logical to add our JSR packages under
javax.jws.rs. This brings the issue of the existing annotations inside
javax.jws (HandlerChain, Oneway, WebMethod, WebParam, WebResult, WebService)
which could be assumed to be reused by the subpackage javax.jws.rs, which is
not the case.
Maybe a completely different name such as "javax.net.rs" would be even
better and would reduce the risk of confusion with existing Web Service APIs
(often associated with SOAP-style Web services).
Best regards,
Jerome
> -----Message d'origine-----
> De : Paul.Sandoz_at_Sun.COM [mailto:Paul.Sandoz_at_Sun.COM]
> Envoyé : mardi 10 avril 2007 11:42
> À : dev_at_jsr311.dev.java.net
> Objet : Re: Welcome to JSR 311
>
> Dhanji R. Prasanna wrote:
> >> +1. This should be more intuitive than learning SAAJ
> for instance.
> >> I am always for anything that one can learn almost entirely via
> >> Javadoc and hands-on (which 11 packages may make
> difficult even if
> >> half can be ignored by the lay developer).
> >>
> >
> > Oh no not SAAJ! If we end up like SAAJ we will have
> truly failed :-)
> > Given that we can limit our interaction with the DOM
> API i think we
> > might be on safer ground :-)
> >
> > I think the API looks like it is starting achieve one
> goal, which is
> > to help focus discussion.
> >
> >
> > hehe. =)
> > Yes I suppose my point is that it seems like a quite-lean
> api on the
> > whole, so why the package explosion?
> >
>
> I suppose if you squint and to avoid the SPI packages (and
> javax.ws.rs.messages) then there is not really an explosion.
> Perhaps we
> should have split the javadoc into a separate API and SPI to
> avoid the
> 'assault on the eyes' ?
>
>
> >>
> >> Is there a criteria for choosing what containers get a spi?
> >>
> > Not sure i understand the question, can you give an example?
> >
> >
> > My bad, i misunderstood Marc to mean there were specific
> containers you
> > wanted to support in the spi.
> >
> > We found the container SPI very useful and quick to
> integrate new
> > containers. So we thought it would be useful to present
> this to the
> > EG and see it this is a worth while thing to do i.e. is there a
> > benefit? or is it better to leave this type of thing to each
> > implementation?
> >
> >
> > I wasnt able to find a container impl based on the spi in
> the files on
> > jsr311.dev.java.net--is there a good example somewhere? I
> think seeing
> > it in use would give us a better idea as to its implementability.
> >
>
> OK. I will come up with some examples and send it to the list.
>
>
> >
> > Just a couple of trivial qns:
> > The packages are under javax.ws <http://javax.ws> rather than
> > javax.jws--is this only because jsr311 is not a WSDL-style
> webservice?
>
> Marc can probably answer this and the other questions much
> better that
> I, but i will give it a go.
>
> IMHO i would say jws is very much associated with JSRs 101,
> 109 and 181
> and SOAP-based Web services that can be described by WSDL.
>
>
> > The packages are named javax.ws.rs, rather than
> javax.ws.rest as in the
> > initial proposal--any reason for this change?
> >
>
> We did not want to refer explicitly to 'rest' and thus imply
> that it was
> *the* REST-based API for Java.
>
> See Apache's voting comment:
>
> "On 2007-02-17 Apache Software Foundation voted Yes with the
> following
> comment:
> The ASF thanks the spec lead for making the changes to the title and
> package name as noted in a mail to the EC on 2/16/07 - this was a key
> requirement for us."
>
> Paul.
>
> --
> | ? + ? = To question
> ----------------\
> Paul Sandoz
> x38109
> +33-4-76188109
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_jsr311.dev.java.net
> For additional commands, e-mail: dev-help_at_jsr311.dev.java.net
>