cxf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Daniel Kulp <dk...@apache.org>
Subject Re: RSFB events and annotations....
Date Fri, 07 Aug 2009 19:39:47 GMT
On Fri August 7 2009 1:44:12 pm Alessio Soldano wrote:
> Daniel Kulp wrote:
> > On Fri August 7 2009 1:20:23 pm Alessio Soldano wrote:
> >> Daniel Kulp wrote:
> > Now, @WSDLDocumentation on a method....   does that document the portType
> > operation, the binding operation, the "response" message, the "return"
> > part in the response message?  How about docs for the request message?
> >
> > That's kind of why I've marked this as a "starting point" that I need to
> > think about some more.   It's probably going to be a collection of
> > annotations for various places.   Kind of @WSDLRequestDocumentation,
> > @WSDLOperationDocumentation, etc....  Not really sure though.   requires
> > a bit more thought.    There's just too many places to stick docs in the
> > wsdl.  :-(
>
> Yes, I agree, there're probably just two ways, providing all those
> annotations (@WSDLDocumentation, @WSDLPortDocumentation,
> @WSDLOperationDocumentation, @WSDLRequestDocumentation, etc.) or having
> something like a parent @WSDLDocumentationCollection annotation defined as:
>
> @Target(ElementType.TYPE)
> @Retention(RetentionPolicy.RUNTIME)
> public @interface @WSDLDocumentationCollection {
>    @WSDLDocumentation[] value();
> }
>
> with @WSDLDocumentation having an attribute for setting the right position.

Oh.  Good idea.  I like this idea.   Thanks!

-- 
Daniel Kulp
dkulp@apache.org
http://www.dankulp.com/blog

Mime
View raw message