Return-Path: 
 <users-return-29776-apmail-cxf-users-archive=cxf.apache.org@cxf.apache.org>
X-Original-To: apmail-cxf-users-archive@www.apache.org
Delivered-To: apmail-cxf-users-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id DAAD19DD4
	for <apmail-cxf-users-archive@www.apache.org>;
 Sun, 25 Sep 2011 15:39:22 +0000 (UTC)
Received: (qmail 16969 invoked by uid 500); 25 Sep 2011 15:39:22 -0000
Delivered-To: apmail-cxf-users-archive@cxf.apache.org
Received: (qmail 16911 invoked by uid 500); 25 Sep 2011 15:39:22 -0000
Mailing-List: contact users-help@cxf.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:users-help@cxf.apache.org>
List-Unsubscribe: <mailto:users-unsubscribe@cxf.apache.org>
List-Post: <mailto:users@cxf.apache.org>
List-Id: <users.cxf.apache.org>
Reply-To: users@cxf.apache.org
Delivered-To: mailing list users@cxf.apache.org
Received: (qmail 16903 invoked by uid 99); 25 Sep 2011 15:39:22 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 25 Sep 2011 15:39:22 +0000
X-ASF-Spam-Status: No, hits=-0.7 required=5.0
	tests=FREEMAIL_FROM,RCVD_IN_DNSWL_LOW,SPF_PASS,T_TO_NO_BRKTS_FREEMAIL
X-Spam-Check-By: apache.org
Received-SPF: pass (nike.apache.org: domain of sberyozkin@gmail.com designates
 74.125.82.169 as permitted sender)
Received: from [74.125.82.169] (HELO mail-wy0-f169.google.com) (74.125.82.169)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 25 Sep 2011 15:39:12 +0000
Received: by wyf22 with SMTP id 22so5292328wyf.0
        for <users@cxf.apache.org>; Sun, 25 Sep 2011 08:38:52 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding;
        bh=o0hqyknprz4Msoh7BjrGABHx3ajJw8A11Q3FXK7MmFM=;
        b=xFbvHNEBpo2eCcYkJP1ZRaTi/lnRKDBpzpKKp4NcaCZC9gDAutNygIdvMCH5g/wZQ5
         q/PUlOeLbpO+CIYi3xpKv8fMXSxKDxZME6iRcaE/ursS7FKFyAMMPbviUMC304dU2NJw
         qhR2+bppmZtDdt9z8nkZpfHFym9MKWqXZHVTw=
Received: by 10.227.10.67 with SMTP id o3mr4497925wbo.113.1316965132538;
        Sun, 25 Sep 2011 08:38:52 -0700 (PDT)
Received: from [192.168.2.3] ([79.97.76.109])
        by mx.google.com with ESMTPS id fa3sm26513400wbb.3.2011.09.25.08.38.51
        (version=SSLv3 cipher=OTHER);
        Sun, 25 Sep 2011 08:38:52 -0700 (PDT)
Message-ID: <4E7F4B0B.6040807@gmail.com>
Date: Sun, 25 Sep 2011 16:38:51 +0100
From: Sergey Beryozkin <sberyozkin@gmail.com>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
 rv:1.9.2.18) Gecko/20110617 Thunderbird/3.1.11
MIME-Version: 1.0
To: users@cxf.apache.org
Subject: Re: Generated WADL missing <doc/> elements from @Description
 annotation?
References: 
 <CABk45Yuh3jHoHigvJXApVKurP0i_ymS1O8ZEsYYkD=pZ0StoQg@mail.gmail.com>
In-Reply-To: 
 <CABk45Yuh3jHoHigvJXApVKurP0i_ymS1O8ZEsYYkD=pZ0StoQg@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Virus-Checked: Checked by ClamAV on apache.org

Hi


Please see comments inline

On 25/09/11 00:26, Margaret Leber wrote:
> Our CXF JAX-RS Spring app generates perfectly lovely WADL
> documents...except no matter how I try apply @Description annotations
> to the REST interfaces, I find no<doc>  elements on the generated
> WADL.
>
> In the FAQ I read "When using Spring AOP to enable things like
> transactions and security, the generated WSDL is very messed up with
> wrong namespaces, part names, etc...When using Spring AOP, spring
> injects a proxy to the bean into CXF instead of the actual bean. The
> Proxy does not have the annotations on it (like the @WebService
> annotation) so we cannot query the information directly from the
> object like we can in the non-AOP case. The "fix" is to also specify
> the actual serviceClass of the object in the spring config..."
>
> Is it possible that something like this is what's happening to the
> @Description annotations in the WADL case?
>
> (I hope not because to date we have about two dozen service beans
> under one JAX-RS server; gonna be hard to merge them into one service
> class.)
>

What CXF version are you working with ? It has to be 2.4.0 at least.

If WADL is properly generated, then annotations such as @Path are 
visible. But if no @Description is visible at the same time, then may be 
it's a case of an OSGI Import-Package directive missing a 
"org.apache.cxf.jaxrs.model.wadl" value ?

Let me know please if that helps

Cheers, Sergey

> Any thoughts about what I might be doing wrong would be welcome.
>
> Cheers
> MaggieL