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
dk...@apache.org
http://www.dankulp.com/blog
