cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Sergey Beryozkin (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (CXF-5479) Create a Maven plugin for generating WADL at build time
Date Thu, 03 Apr 2014 09:39:16 GMT

    [ https://issues.apache.org/jira/browse/CXF-5479?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13958667#comment-13958667
] 

Sergey Beryozkin commented on CXF-5479:
---------------------------------------

Hi Freeman

I guess we are talking about using Doclet API, see a link to it from here:
http://stackoverflow.com/questions/13024881/how-to-extract-javadoc-comments-from-the-source-files

So when generating WADL with the plugin we should be able to register a DocumentationProvider
that can utilize Doclet API. 
IMHO EclipseJDT is not what we need, the existing JavaDocs provider that we ship more or less
does the same thing I guess, it parses HTML and attempts to make it portable across different
Java versions.

I think it is not the right way to follow. Perhaps we can split the process, I don't know,
get this plugin run in two phases, one will accumulate JavaDocs only and will build some internal
map (example: ClassA - JavaDocs for ClassA, etc), save it to some temp file if needed to get
it persisted and then when building the actual WADL it will have  DocumentationProvider that
will use the earlier created map to map JavaDocs pieces to WADL docs...

Cheers, Sergey 

> Create a Maven plugin for generating WADL at build time
> -------------------------------------------------------
>
>                 Key: CXF-5479
>                 URL: https://issues.apache.org/jira/browse/CXF-5479
>             Project: CXF
>          Issue Type: New Feature
>          Components: JAX-RS
>            Reporter: Sergey Beryozkin
>            Assignee: Freeman Fang
>         Attachments: CXF-5479.patch
>
>




--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message