Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 5DB0C200BFF for ; Tue, 17 Jan 2017 14:08:37 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 5C13F160B52; Tue, 17 Jan 2017 13:08:37 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id A5AD8160B46 for ; Tue, 17 Jan 2017 14:08:36 +0100 (CET) Received: (qmail 62113 invoked by uid 500); 17 Jan 2017 13:08:35 -0000 Mailing-List: contact users-help@cxf.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: users@cxf.apache.org Delivered-To: mailing list users@cxf.apache.org Received: (qmail 62102 invoked by uid 99); 17 Jan 2017 13:08:35 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 17 Jan 2017 13:08:35 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id E8681C2498 for ; Tue, 17 Jan 2017 13:08:34 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 1.364 X-Spam-Level: * X-Spam-Status: No, score=1.364 tagged_above=-999 required=6.31 tests=[HEADER_FROM_DIFFERENT_DOMAINS=0.001, KAM_LAZY_DOMAIN_SECURITY=1, RDNS_DYNAMIC=0.363] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id UvKqmqFGIuZK for ; Tue, 17 Jan 2017 13:08:32 +0000 (UTC) Received: from rovere.tirasa.net (93-56-25-79.ip287.fastwebnet.it [93.56.25.79]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with ESMTPS id 2E6F15FB7F for ; Tue, 17 Jan 2017 13:08:32 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by rovere.tirasa.net (Postfix) with ESMTP id BC4E2295626E3 for ; Tue, 17 Jan 2017 14:08:23 +0100 (CET) X-Virus-Scanned: amavisd-new at tirasa.net Received: from rovere.tirasa.net ([127.0.0.1]) by localhost (rovere.tirasa.net [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id HA5OfG7M3OsR for ; Tue, 17 Jan 2017 14:08:23 +0100 (CET) Received: from rovere.tirasa.net (rovere.tirasa.net [192.168.0.1]) by rovere.tirasa.net (Postfix) with ESMTP id 90D8929561806 for ; Tue, 17 Jan 2017 14:08:23 +0100 (CET) Date: Tue, 17 Jan 2017 14:08:22 +0100 (CET) From: Francesco =?utf-8?Q?Chicchiricc=C3=B2?= To: users Message-ID: <1998676552.2781.1484658502284.JavaMail.zimbra@tirasa.net> In-Reply-To: References: Subject: Re: swagger2feature do not see javadocs ? MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Originating-IP: [192.168.0.1] X-Mailer: Zimbra 8.6.0_GA_1200 (ZimbraWebClient - FF50 (Linux)/8.6.0_GA_1200) Thread-Topic: swagger2feature do not see javadocs ? Thread-Index: zL7YLBylUns27ZlOgF0OCxEo3A2aZw== archived-at: Tue, 17 Jan 2017 13:08:37 -0000 On 17-jan-17, at 13:44, Vjacheslav V. Borisov slavb18@gmail.com wrote: > Hi! >=20 > Playing with > https://github.com/apache/cxf/tree/master/distribution/src/main/release/s= amples/jax_rs/spring_boot >=20 > Added Javadoc to method sayHello >=20 > /** > * sayHello doc > * @param a the a param > * @return > */ > public String sayHello(String a) { > return "Hello2 " + a + ", Welcome to CXF RS Spring Boot World!!!"; > } >=20 > And do not see this documentation in swagger.json / api-docs >=20 > Is javadoc parsing not implemented in swagger.json generation, or i am > missing some switch? The DefaultSwagger2Serializers class requires a JavadocProvider in order to= be able to extract info from Javadocs; use one the methods [1] to configur= e. HTH Regards. [1] https://github.com/apache/cxf/blob/3.1.x-fixes/rt/rs/description-swagge= r/src/main/java/org/apache/cxf/jaxrs/swagger/DefaultSwagger2Serializers.jav= a#L198-L217 --=20 Francesco Chicchiricc=C3=B2 Tirasa - Open Source Excellence http://www.tirasa.net/ Member at The Apache Software Foundation Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail http://home.apache.org/~ilgrosso/