You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@cxf.apache.org by Francesco Chicchiriccò <il...@apache.org> on 2013/10/15 14:07:27 UTC
WADL generation: linkJsonToXmlSchema & XMLName
Hi,
I am currently trying to enrich the WADL auto-generated by CXF 2.7.7 in
Syncope.
I currently have these Spring beans defined:
<bean id="wadlGenerator"
class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
<property name="applicationTitle" value="Apache Syncope
${project.version}"/>
<property name="namespacePrefix" value="syncope"/>
<property name="linkJsonToXmlSchema" value="true"/>
<property name="useJaxbContextForQnames" value="true"/>
<property name="ignoreMessageWriters" value="true"/>
<property name="addResourceAndMethodIds" value="true"/>
</bean>
and
<jaxrs:server id="restContainer" address="/"
staticSubresourceResolution="true">
<!-- snip -->
<jaxrs:providers>
<ref bean="jaxbProvider"/>
<ref bean="jsonProvider"/>
<ref bean="exceptionMapper"/>
<ref bean="wadlGenerator"/>
</jaxrs:providers>
</jaxrs:server>
I am currently testing one of available services that now looks as
follows (showing only a couple of methods for simplicity):
@Path("users")
@Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
@Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
public interface UserService {
@GET
@Path("{userId}")
@Descriptions(
@Description(target = DocTarget.METHOD, value = "Returns a
single user matching the provided userId"))
UserTO read(@PathParam("userId") Long userId);
@GET
@XMLName("{http://syncope.apache.org/1.1}users")
List<UserTO> list();
}
Now, while the former becomes (in the WADL)
<method name="GET" id="read">
<doc>Returns a single user matching the provided userId</doc>
<request/>
<response>
<representation mediaType="application/xml" element="syncope1:user"/>
<representation mediaType="application/json" element="syncope1:user"/>
</response>
</method>
which is just fine, the latter is instead reported as
<method name="GET" id="list">
<response>
<representation mediaType="application/xml" element="syncope1:users"/>
<representation mediaType="application/json" element="syncope1:user"/>
</response>
</method>
As you can see, representation/@element is different between JSON and
XML, e.g. for XML the value provided via @XMLName is used, while for
JSON it is reported as if the return type was plain 'UserTO' instead of
'List<UserTO>'.
Without @XMLName, element attribute is not even reported for XML.
Moreover, I would expect to find something in the <schema> section of
the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
suggest.
Any clue?
TIA
Regards.
[1]
http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
--
Francesco Chicchiriccò
ASF Member, Apache Syncope PMC chair, Apache Cocoon PMC Member
http://people.apache.org/~ilgrosso/
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi Francesco,
Sounds good, thanks
Sergey
On 18/10/13 09:50, Francesco Chicchiriccò wrote:
> On 17/10/2013 17:55, Sergey Beryozkin wrote:
>> Hi Francesco,
>>
>> the JSON to schema link issue is fixed now, it should actually work
>> with Produces/Consumes containing application/json only, but there was
>> a bug when multiple media types were set.
>>
>> @XMLName on explicit collections is optional now,
>>
>> I was not able though to reproduce the issue with a package info being
>> not picked up; the schema is generated in such cases too.
>
> Hi Sergey,
> I had to build CXF 2.7.8-SNAPSHOT from sources but then it worked like a
> charm: now JAXB collections are handled correctly, both for JSON and XML
> and additional schema entries are well generated.
>
>> The package of UserTO has no packageinfo, have you added it locally ?
>
> Exactly: at first I thought I could made modifications for RESTful
> documentation with Syncope 1.1.X and then merge to 1.2.X, then I decided
> to work only on latter, in order to not break anything for people
> already using it.
>
>> One other thing to check is whether a complete JAXBContext has even
>> been created, what may've happened is that few types like Response
>> have slipped in which would cause JAXBContext creation to fail, that
>> has been tightened now too,
>>
>> Please try the snapshots
>
> Thanks for the fixes.
>
> Regards.
>
>> On 15/10/13 16:02, Sergey Beryozkin wrote:
>>> Hi
>>> On 15/10/13 13:48, Francesco Chicchiriccò wrote:
>>>> On 15/10/2013 14:43, Sergey Beryozkin wrote:
>>>>> Hi Francesco
>>>>> On 15/10/13 13:07, Francesco Chicchiriccò wrote:
>>>>>> Hi,
>>>>>> I am currently trying to enrich the WADL auto-generated by CXF
>>>>>> 2.7.7 in
>>>>>> Syncope.
>>>>>>
>>>>>> I currently have these Spring beans defined:
>>>>>>
>>>>>> <bean id="wadlGenerator"
>>>>>> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
>>>>>> <property name="applicationTitle" value="Apache Syncope
>>>>>> ${project.version}"/>
>>>>>> <property name="namespacePrefix" value="syncope"/>
>>>>>> <property name="linkJsonToXmlSchema" value="true"/>
>>>>>> <property name="useJaxbContextForQnames" value="true"/>
>>>>>> <property name="ignoreMessageWriters" value="true"/>
>>>>>> <property name="addResourceAndMethodIds" value="true"/>
>>>>>> </bean>
>>>>>>
>>>>>> and
>>>>>>
>>>>>> <jaxrs:server id="restContainer" address="/"
>>>>>> staticSubresourceResolution="true">
>>>>>> <!-- snip -->
>>>>>> <jaxrs:providers>
>>>>>> <ref bean="jaxbProvider"/>
>>>>>> <ref bean="jsonProvider"/>
>>>>>> <ref bean="exceptionMapper"/>
>>>>>> <ref bean="wadlGenerator"/>
>>>>>> </jaxrs:providers>
>>>>>> </jaxrs:server>
>>>>>>
>>>>>> I am currently testing one of available services that now looks as
>>>>>> follows (showing only a couple of methods for simplicity):
>>>>>>
>>>>>> @Path("users")
>>>>>> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>>>> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>>>> public interface UserService {
>>>>>>
>>>>>> @GET
>>>>>> @Path("{userId}")
>>>>>> @Descriptions(
>>>>>> @Description(target = DocTarget.METHOD, value =
>>>>>> "Returns a
>>>>>> single user matching the provided userId"))
>>>>>> UserTO read(@PathParam("userId") Long userId);
>>>>>>
>>>>>>
>>>>>> @GET
>>>>>> @XMLName("{http://syncope.apache.org/1.1}users")
>>>>>> List<UserTO> list();
>>>>>> }
>>>>>>
>>>>>> Now, while the former becomes (in the WADL)
>>>>>>
>>>>>> <method name="GET" id="read">
>>>>>> <doc>Returns a single user matching the provided userId</doc>
>>>>>> <request/>
>>>>>> <response>
>>>>>> <representation mediaType="application/xml"
>>>>>> element="syncope1:user"/>
>>>>>> <representation mediaType="application/json"
>>>>>> element="syncope1:user"/>
>>>>>> </response>
>>>>>> </method>
>>>>>>
>>>>>> which is just fine, the latter is instead reported as
>>>>>>
>>>>>> <method name="GET" id="list">
>>>>>> <response>
>>>>>> <representation mediaType="application/xml"
>>>>>> element="syncope1:users"/>
>>>>>> <representation mediaType="application/json"
>>>>>> element="syncope1:user"/>
>>>>>> </response>
>>>>>> </method>
>>>>>>
>>>>>> As you can see, representation/@element is different between JSON and
>>>>>> XML, e.g. for XML the value provided via @XMLName is used, while for
>>>>>> JSON it is reported as if the return type was plain 'UserTO'
>>>>>> instead of
>>>>>> 'List<UserTO>'.
>>>>>
>>>>> This is a bug to do with linking JSON reps to XML schemas, I'll have a
>>>>> look; I'm actually experimenting with WADL Generator right now anyway
>>>>> :-)
>>>>
>>>> Nice coincidence :-)
>>>> If there is any related issue on JIRA, please report.
>>>>
>>> Sure, https://issues.apache.org/jira/browse/CXF-5336
>>>
>>> There are few issues there I'd like to address, some of them minor, and
>>> I tried to catch major ones in the subject
>>>
>>>>>> Without @XMLName, element attribute is not even reported for XML.
>>>>>>
>>>>> Right, I thought that typically we can't be 100% sure what the wrapper
>>>>> name is, the default would be XMLRootElement's local name + "s" - but
>>>>> it is not guaranteed to be precise; however I think may be we can
>>>>> relax it, users can customize with XMLName if the default name
>>>>> calculation does not work
>>>>
>>>> Sounds reasonable.
>>>>
>>>>>> Moreover, I would expect to find something in the <schema> section of
>>>>>> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
>>>>>> suggest.
>>>>>>
>>>>> has UserTO @XmlRootElement attached to it ?
>>>>
>>>> Sure:
>>>> https://svn.apache.org/repos/asf/syncope/branches/1_1_X/common/src/main/java/org/apache/syncope/common/to/UserTO.java
>>>>
>>>>
>>>>
>>>>
>>>> In addition to this, I have also defined some package-info.java with
>>>> content:
>>>>
>>>> @XmlSchema(namespace = "http://syncope.apache.org/1.1")
>>>> package org.apache.syncope.common.to;
>>>>
>>>> and put
>>>>
>>>> <property name="namespacePrefixes">
>>>> <map>
>>>> <entry key="http://syncope.apache.org/1.1">
>>>> <value>syncope</value>
>>>> </entry>
>>>> </map>
>>>> </property>
>>>>
>>>> in jaxProvider.
>>>>
>>> Looks like it misses on the package info in the explicit collections
>>> case, though I'm pretty sure it works otherwise.
>>> Btw, I'm seeing the issues with the generator adding new XSD elements
>>> into the already generated schema, fixed locally already
>>>
>>> Cheers, Sergey
>>>
>>> Thanks, Sergey
>>>
>>>> Regards.
>>>>
>>>>> Cheers, Sergey
>>>>>
>>>>>> Any clue?
>>>>>> TIA
>>>>>>
>>>>>> Regards.
>>>>>>
>>>>>> [1]
>>>>>> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>>>>>>
>
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Francesco Chicchiriccò <il...@apache.org>.
On 17/10/2013 17:55, Sergey Beryozkin wrote:
> Hi Francesco,
>
> the JSON to schema link issue is fixed now, it should actually work
> with Produces/Consumes containing application/json only, but there was
> a bug when multiple media types were set.
>
> @XMLName on explicit collections is optional now,
>
> I was not able though to reproduce the issue with a package info being
> not picked up; the schema is generated in such cases too.
Hi Sergey,
I had to build CXF 2.7.8-SNAPSHOT from sources but then it worked like a
charm: now JAXB collections are handled correctly, both for JSON and XML
and additional schema entries are well generated.
> The package of UserTO has no packageinfo, have you added it locally ?
Exactly: at first I thought I could made modifications for RESTful
documentation with Syncope 1.1.X and then merge to 1.2.X, then I decided
to work only on latter, in order to not break anything for people
already using it.
> One other thing to check is whether a complete JAXBContext has even
> been created, what may've happened is that few types like Response
> have slipped in which would cause JAXBContext creation to fail, that
> has been tightened now too,
>
> Please try the snapshots
Thanks for the fixes.
Regards.
> On 15/10/13 16:02, Sergey Beryozkin wrote:
>> Hi
>> On 15/10/13 13:48, Francesco Chicchiriccò wrote:
>>> On 15/10/2013 14:43, Sergey Beryozkin wrote:
>>>> Hi Francesco
>>>> On 15/10/13 13:07, Francesco Chicchiriccò wrote:
>>>>> Hi,
>>>>> I am currently trying to enrich the WADL auto-generated by CXF
>>>>> 2.7.7 in
>>>>> Syncope.
>>>>>
>>>>> I currently have these Spring beans defined:
>>>>>
>>>>> <bean id="wadlGenerator"
>>>>> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
>>>>> <property name="applicationTitle" value="Apache Syncope
>>>>> ${project.version}"/>
>>>>> <property name="namespacePrefix" value="syncope"/>
>>>>> <property name="linkJsonToXmlSchema" value="true"/>
>>>>> <property name="useJaxbContextForQnames" value="true"/>
>>>>> <property name="ignoreMessageWriters" value="true"/>
>>>>> <property name="addResourceAndMethodIds" value="true"/>
>>>>> </bean>
>>>>>
>>>>> and
>>>>>
>>>>> <jaxrs:server id="restContainer" address="/"
>>>>> staticSubresourceResolution="true">
>>>>> <!-- snip -->
>>>>> <jaxrs:providers>
>>>>> <ref bean="jaxbProvider"/>
>>>>> <ref bean="jsonProvider"/>
>>>>> <ref bean="exceptionMapper"/>
>>>>> <ref bean="wadlGenerator"/>
>>>>> </jaxrs:providers>
>>>>> </jaxrs:server>
>>>>>
>>>>> I am currently testing one of available services that now looks as
>>>>> follows (showing only a couple of methods for simplicity):
>>>>>
>>>>> @Path("users")
>>>>> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>>> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>>> public interface UserService {
>>>>>
>>>>> @GET
>>>>> @Path("{userId}")
>>>>> @Descriptions(
>>>>> @Description(target = DocTarget.METHOD, value =
>>>>> "Returns a
>>>>> single user matching the provided userId"))
>>>>> UserTO read(@PathParam("userId") Long userId);
>>>>>
>>>>>
>>>>> @GET
>>>>> @XMLName("{http://syncope.apache.org/1.1}users")
>>>>> List<UserTO> list();
>>>>> }
>>>>>
>>>>> Now, while the former becomes (in the WADL)
>>>>>
>>>>> <method name="GET" id="read">
>>>>> <doc>Returns a single user matching the provided userId</doc>
>>>>> <request/>
>>>>> <response>
>>>>> <representation mediaType="application/xml"
>>>>> element="syncope1:user"/>
>>>>> <representation mediaType="application/json"
>>>>> element="syncope1:user"/>
>>>>> </response>
>>>>> </method>
>>>>>
>>>>> which is just fine, the latter is instead reported as
>>>>>
>>>>> <method name="GET" id="list">
>>>>> <response>
>>>>> <representation mediaType="application/xml"
>>>>> element="syncope1:users"/>
>>>>> <representation mediaType="application/json"
>>>>> element="syncope1:user"/>
>>>>> </response>
>>>>> </method>
>>>>>
>>>>> As you can see, representation/@element is different between JSON and
>>>>> XML, e.g. for XML the value provided via @XMLName is used, while for
>>>>> JSON it is reported as if the return type was plain 'UserTO'
>>>>> instead of
>>>>> 'List<UserTO>'.
>>>>
>>>> This is a bug to do with linking JSON reps to XML schemas, I'll have a
>>>> look; I'm actually experimenting with WADL Generator right now anyway
>>>> :-)
>>>
>>> Nice coincidence :-)
>>> If there is any related issue on JIRA, please report.
>>>
>> Sure, https://issues.apache.org/jira/browse/CXF-5336
>>
>> There are few issues there I'd like to address, some of them minor, and
>> I tried to catch major ones in the subject
>>
>>>>> Without @XMLName, element attribute is not even reported for XML.
>>>>>
>>>> Right, I thought that typically we can't be 100% sure what the wrapper
>>>> name is, the default would be XMLRootElement's local name + "s" - but
>>>> it is not guaranteed to be precise; however I think may be we can
>>>> relax it, users can customize with XMLName if the default name
>>>> calculation does not work
>>>
>>> Sounds reasonable.
>>>
>>>>> Moreover, I would expect to find something in the <schema> section of
>>>>> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
>>>>> suggest.
>>>>>
>>>> has UserTO @XmlRootElement attached to it ?
>>>
>>> Sure:
>>> https://svn.apache.org/repos/asf/syncope/branches/1_1_X/common/src/main/java/org/apache/syncope/common/to/UserTO.java
>>>
>>>
>>>
>>>
>>> In addition to this, I have also defined some package-info.java with
>>> content:
>>>
>>> @XmlSchema(namespace = "http://syncope.apache.org/1.1")
>>> package org.apache.syncope.common.to;
>>>
>>> and put
>>>
>>> <property name="namespacePrefixes">
>>> <map>
>>> <entry key="http://syncope.apache.org/1.1">
>>> <value>syncope</value>
>>> </entry>
>>> </map>
>>> </property>
>>>
>>> in jaxProvider.
>>>
>> Looks like it misses on the package info in the explicit collections
>> case, though I'm pretty sure it works otherwise.
>> Btw, I'm seeing the issues with the generator adding new XSD elements
>> into the already generated schema, fixed locally already
>>
>> Cheers, Sergey
>>
>> Thanks, Sergey
>>
>>> Regards.
>>>
>>>> Cheers, Sergey
>>>>
>>>>> Any clue?
>>>>> TIA
>>>>>
>>>>> Regards.
>>>>>
>>>>> [1]
>>>>> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>>>>>
--
Francesco Chicchiriccò
ASF Member, Apache Syncope PMC chair, Apache Cocoon PMC Member
http://people.apache.org/~ilgrosso/
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi Francesco,
the JSON to schema link issue is fixed now, it should actually work with
Produces/Consumes containing application/json only, but there was a bug
when multiple media types were set.
@XMLName on explicit collections is optional now,
I was not able though to reproduce the issue with a package info being
not picked up; the schema is generated in such cases too.
The package of UserTO has no packageinfo, have you added it locally ?
One other thing to check is whether a complete JAXBContext has even been
created, what may've happened is that few types like Response have
slipped in which would cause JAXBContext creation to fail, that has been
tightened now too,
Please try the snapshots
Cheers, Sergey
On 15/10/13 16:02, Sergey Beryozkin wrote:
> Hi
> On 15/10/13 13:48, Francesco Chicchiriccò wrote:
>> On 15/10/2013 14:43, Sergey Beryozkin wrote:
>>> Hi Francesco
>>> On 15/10/13 13:07, Francesco Chicchiriccò wrote:
>>>> Hi,
>>>> I am currently trying to enrich the WADL auto-generated by CXF 2.7.7 in
>>>> Syncope.
>>>>
>>>> I currently have these Spring beans defined:
>>>>
>>>> <bean id="wadlGenerator"
>>>> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
>>>> <property name="applicationTitle" value="Apache Syncope
>>>> ${project.version}"/>
>>>> <property name="namespacePrefix" value="syncope"/>
>>>> <property name="linkJsonToXmlSchema" value="true"/>
>>>> <property name="useJaxbContextForQnames" value="true"/>
>>>> <property name="ignoreMessageWriters" value="true"/>
>>>> <property name="addResourceAndMethodIds" value="true"/>
>>>> </bean>
>>>>
>>>> and
>>>>
>>>> <jaxrs:server id="restContainer" address="/"
>>>> staticSubresourceResolution="true">
>>>> <!-- snip -->
>>>> <jaxrs:providers>
>>>> <ref bean="jaxbProvider"/>
>>>> <ref bean="jsonProvider"/>
>>>> <ref bean="exceptionMapper"/>
>>>> <ref bean="wadlGenerator"/>
>>>> </jaxrs:providers>
>>>> </jaxrs:server>
>>>>
>>>> I am currently testing one of available services that now looks as
>>>> follows (showing only a couple of methods for simplicity):
>>>>
>>>> @Path("users")
>>>> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>>> public interface UserService {
>>>>
>>>> @GET
>>>> @Path("{userId}")
>>>> @Descriptions(
>>>> @Description(target = DocTarget.METHOD, value = "Returns a
>>>> single user matching the provided userId"))
>>>> UserTO read(@PathParam("userId") Long userId);
>>>>
>>>>
>>>> @GET
>>>> @XMLName("{http://syncope.apache.org/1.1}users")
>>>> List<UserTO> list();
>>>> }
>>>>
>>>> Now, while the former becomes (in the WADL)
>>>>
>>>> <method name="GET" id="read">
>>>> <doc>Returns a single user matching the provided userId</doc>
>>>> <request/>
>>>> <response>
>>>> <representation mediaType="application/xml"
>>>> element="syncope1:user"/>
>>>> <representation mediaType="application/json"
>>>> element="syncope1:user"/>
>>>> </response>
>>>> </method>
>>>>
>>>> which is just fine, the latter is instead reported as
>>>>
>>>> <method name="GET" id="list">
>>>> <response>
>>>> <representation mediaType="application/xml"
>>>> element="syncope1:users"/>
>>>> <representation mediaType="application/json"
>>>> element="syncope1:user"/>
>>>> </response>
>>>> </method>
>>>>
>>>> As you can see, representation/@element is different between JSON and
>>>> XML, e.g. for XML the value provided via @XMLName is used, while for
>>>> JSON it is reported as if the return type was plain 'UserTO' instead of
>>>> 'List<UserTO>'.
>>>
>>> This is a bug to do with linking JSON reps to XML schemas, I'll have a
>>> look; I'm actually experimenting with WADL Generator right now anyway
>>> :-)
>>
>> Nice coincidence :-)
>> If there is any related issue on JIRA, please report.
>>
> Sure, https://issues.apache.org/jira/browse/CXF-5336
>
> There are few issues there I'd like to address, some of them minor, and
> I tried to catch major ones in the subject
>
>>>> Without @XMLName, element attribute is not even reported for XML.
>>>>
>>> Right, I thought that typically we can't be 100% sure what the wrapper
>>> name is, the default would be XMLRootElement's local name + "s" - but
>>> it is not guaranteed to be precise; however I think may be we can
>>> relax it, users can customize with XMLName if the default name
>>> calculation does not work
>>
>> Sounds reasonable.
>>
>>>> Moreover, I would expect to find something in the <schema> section of
>>>> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
>>>> suggest.
>>>>
>>> has UserTO @XmlRootElement attached to it ?
>>
>> Sure:
>> https://svn.apache.org/repos/asf/syncope/branches/1_1_X/common/src/main/java/org/apache/syncope/common/to/UserTO.java
>>
>>
>>
>> In addition to this, I have also defined some package-info.java with
>> content:
>>
>> @XmlSchema(namespace = "http://syncope.apache.org/1.1")
>> package org.apache.syncope.common.to;
>>
>> and put
>>
>> <property name="namespacePrefixes">
>> <map>
>> <entry key="http://syncope.apache.org/1.1">
>> <value>syncope</value>
>> </entry>
>> </map>
>> </property>
>>
>> in jaxProvider.
>>
> Looks like it misses on the package info in the explicit collections
> case, though I'm pretty sure it works otherwise.
> Btw, I'm seeing the issues with the generator adding new XSD elements
> into the already generated schema, fixed locally already
>
> Cheers, Sergey
>
> Thanks, Sergey
>
>> Regards.
>>
>>> Cheers, Sergey
>>>
>>>> Any clue?
>>>> TIA
>>>>
>>>> Regards.
>>>>
>>>> [1]
>>>> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>>>>
>>>
>>>
>>
>
>
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi
On 15/10/13 13:48, Francesco Chicchiriccò wrote:
> On 15/10/2013 14:43, Sergey Beryozkin wrote:
>> Hi Francesco
>> On 15/10/13 13:07, Francesco Chicchiriccò wrote:
>>> Hi,
>>> I am currently trying to enrich the WADL auto-generated by CXF 2.7.7 in
>>> Syncope.
>>>
>>> I currently have these Spring beans defined:
>>>
>>> <bean id="wadlGenerator"
>>> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
>>> <property name="applicationTitle" value="Apache Syncope
>>> ${project.version}"/>
>>> <property name="namespacePrefix" value="syncope"/>
>>> <property name="linkJsonToXmlSchema" value="true"/>
>>> <property name="useJaxbContextForQnames" value="true"/>
>>> <property name="ignoreMessageWriters" value="true"/>
>>> <property name="addResourceAndMethodIds" value="true"/>
>>> </bean>
>>>
>>> and
>>>
>>> <jaxrs:server id="restContainer" address="/"
>>> staticSubresourceResolution="true">
>>> <!-- snip -->
>>> <jaxrs:providers>
>>> <ref bean="jaxbProvider"/>
>>> <ref bean="jsonProvider"/>
>>> <ref bean="exceptionMapper"/>
>>> <ref bean="wadlGenerator"/>
>>> </jaxrs:providers>
>>> </jaxrs:server>
>>>
>>> I am currently testing one of available services that now looks as
>>> follows (showing only a couple of methods for simplicity):
>>>
>>> @Path("users")
>>> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>>> public interface UserService {
>>>
>>> @GET
>>> @Path("{userId}")
>>> @Descriptions(
>>> @Description(target = DocTarget.METHOD, value = "Returns a
>>> single user matching the provided userId"))
>>> UserTO read(@PathParam("userId") Long userId);
>>>
>>>
>>> @GET
>>> @XMLName("{http://syncope.apache.org/1.1}users")
>>> List<UserTO> list();
>>> }
>>>
>>> Now, while the former becomes (in the WADL)
>>>
>>> <method name="GET" id="read">
>>> <doc>Returns a single user matching the provided userId</doc>
>>> <request/>
>>> <response>
>>> <representation mediaType="application/xml"
>>> element="syncope1:user"/>
>>> <representation mediaType="application/json"
>>> element="syncope1:user"/>
>>> </response>
>>> </method>
>>>
>>> which is just fine, the latter is instead reported as
>>>
>>> <method name="GET" id="list">
>>> <response>
>>> <representation mediaType="application/xml"
>>> element="syncope1:users"/>
>>> <representation mediaType="application/json"
>>> element="syncope1:user"/>
>>> </response>
>>> </method>
>>>
>>> As you can see, representation/@element is different between JSON and
>>> XML, e.g. for XML the value provided via @XMLName is used, while for
>>> JSON it is reported as if the return type was plain 'UserTO' instead of
>>> 'List<UserTO>'.
>>
>> This is a bug to do with linking JSON reps to XML schemas, I'll have a
>> look; I'm actually experimenting with WADL Generator right now anyway :-)
>
> Nice coincidence :-)
> If there is any related issue on JIRA, please report.
>
Sure, https://issues.apache.org/jira/browse/CXF-5336
There are few issues there I'd like to address, some of them minor, and
I tried to catch major ones in the subject
>>> Without @XMLName, element attribute is not even reported for XML.
>>>
>> Right, I thought that typically we can't be 100% sure what the wrapper
>> name is, the default would be XMLRootElement's local name + "s" - but
>> it is not guaranteed to be precise; however I think may be we can
>> relax it, users can customize with XMLName if the default name
>> calculation does not work
>
> Sounds reasonable.
>
>>> Moreover, I would expect to find something in the <schema> section of
>>> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
>>> suggest.
>>>
>> has UserTO @XmlRootElement attached to it ?
>
> Sure:
> https://svn.apache.org/repos/asf/syncope/branches/1_1_X/common/src/main/java/org/apache/syncope/common/to/UserTO.java
>
>
> In addition to this, I have also defined some package-info.java with
> content:
>
> @XmlSchema(namespace = "http://syncope.apache.org/1.1")
> package org.apache.syncope.common.to;
>
> and put
>
> <property name="namespacePrefixes">
> <map>
> <entry key="http://syncope.apache.org/1.1">
> <value>syncope</value>
> </entry>
> </map>
> </property>
>
> in jaxProvider.
>
Looks like it misses on the package info in the explicit collections
case, though I'm pretty sure it works otherwise.
Btw, I'm seeing the issues with the generator adding new XSD elements
into the already generated schema, fixed locally already
Cheers, Sergey
Thanks, Sergey
> Regards.
>
>> Cheers, Sergey
>>
>>> Any clue?
>>> TIA
>>>
>>> Regards.
>>>
>>> [1]
>>> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>>
>>
>
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Francesco Chicchiriccò <il...@apache.org>.
On 15/10/2013 14:43, Sergey Beryozkin wrote:
> Hi Francesco
> On 15/10/13 13:07, Francesco Chicchiriccò wrote:
>> Hi,
>> I am currently trying to enrich the WADL auto-generated by CXF 2.7.7 in
>> Syncope.
>>
>> I currently have these Spring beans defined:
>>
>> <bean id="wadlGenerator"
>> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
>> <property name="applicationTitle" value="Apache Syncope
>> ${project.version}"/>
>> <property name="namespacePrefix" value="syncope"/>
>> <property name="linkJsonToXmlSchema" value="true"/>
>> <property name="useJaxbContextForQnames" value="true"/>
>> <property name="ignoreMessageWriters" value="true"/>
>> <property name="addResourceAndMethodIds" value="true"/>
>> </bean>
>>
>> and
>>
>> <jaxrs:server id="restContainer" address="/"
>> staticSubresourceResolution="true">
>> <!-- snip -->
>> <jaxrs:providers>
>> <ref bean="jaxbProvider"/>
>> <ref bean="jsonProvider"/>
>> <ref bean="exceptionMapper"/>
>> <ref bean="wadlGenerator"/>
>> </jaxrs:providers>
>> </jaxrs:server>
>>
>> I am currently testing one of available services that now looks as
>> follows (showing only a couple of methods for simplicity):
>>
>> @Path("users")
>> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
>> public interface UserService {
>>
>> @GET
>> @Path("{userId}")
>> @Descriptions(
>> @Description(target = DocTarget.METHOD, value = "Returns a
>> single user matching the provided userId"))
>> UserTO read(@PathParam("userId") Long userId);
>>
>>
>> @GET
>> @XMLName("{http://syncope.apache.org/1.1}users")
>> List<UserTO> list();
>> }
>>
>> Now, while the former becomes (in the WADL)
>>
>> <method name="GET" id="read">
>> <doc>Returns a single user matching the provided userId</doc>
>> <request/>
>> <response>
>> <representation mediaType="application/xml"
>> element="syncope1:user"/>
>> <representation mediaType="application/json"
>> element="syncope1:user"/>
>> </response>
>> </method>
>>
>> which is just fine, the latter is instead reported as
>>
>> <method name="GET" id="list">
>> <response>
>> <representation mediaType="application/xml"
>> element="syncope1:users"/>
>> <representation mediaType="application/json"
>> element="syncope1:user"/>
>> </response>
>> </method>
>>
>> As you can see, representation/@element is different between JSON and
>> XML, e.g. for XML the value provided via @XMLName is used, while for
>> JSON it is reported as if the return type was plain 'UserTO' instead of
>> 'List<UserTO>'.
>
> This is a bug to do with linking JSON reps to XML schemas, I'll have a
> look; I'm actually experimenting with WADL Generator right now anyway :-)
Nice coincidence :-)
If there is any related issue on JIRA, please report.
>> Without @XMLName, element attribute is not even reported for XML.
>>
> Right, I thought that typically we can't be 100% sure what the wrapper
> name is, the default would be XMLRootElement's local name + "s" - but
> it is not guaranteed to be precise; however I think may be we can
> relax it, users can customize with XMLName if the default name
> calculation does not work
Sounds reasonable.
>> Moreover, I would expect to find something in the <schema> section of
>> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
>> suggest.
>>
> has UserTO @XmlRootElement attached to it ?
Sure:
https://svn.apache.org/repos/asf/syncope/branches/1_1_X/common/src/main/java/org/apache/syncope/common/to/UserTO.java
In addition to this, I have also defined some package-info.java with
content:
@XmlSchema(namespace = "http://syncope.apache.org/1.1")
package org.apache.syncope.common.to;
and put
<property name="namespacePrefixes">
<map>
<entry key="http://syncope.apache.org/1.1">
<value>syncope</value>
</entry>
</map>
</property>
in jaxProvider.
Regards.
> Cheers, Sergey
>
>> Any clue?
>> TIA
>>
>> Regards.
>>
>> [1]
>> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>
--
Francesco Chicchiriccò
ASF Member, Apache Syncope PMC chair, Apache Cocoon PMC Member
http://people.apache.org/~ilgrosso/
Re: WADL generation: linkJsonToXmlSchema & XMLName
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi Francesco
On 15/10/13 13:07, Francesco Chicchiriccò wrote:
> Hi,
> I am currently trying to enrich the WADL auto-generated by CXF 2.7.7 in
> Syncope.
>
> I currently have these Spring beans defined:
>
> <bean id="wadlGenerator"
> class="org.apache.cxf.jaxrs.model.wadl.WadlGenerator">
> <property name="applicationTitle" value="Apache Syncope
> ${project.version}"/>
> <property name="namespacePrefix" value="syncope"/>
> <property name="linkJsonToXmlSchema" value="true"/>
> <property name="useJaxbContextForQnames" value="true"/>
> <property name="ignoreMessageWriters" value="true"/>
> <property name="addResourceAndMethodIds" value="true"/>
> </bean>
>
> and
>
> <jaxrs:server id="restContainer" address="/"
> staticSubresourceResolution="true">
> <!-- snip -->
> <jaxrs:providers>
> <ref bean="jaxbProvider"/>
> <ref bean="jsonProvider"/>
> <ref bean="exceptionMapper"/>
> <ref bean="wadlGenerator"/>
> </jaxrs:providers>
> </jaxrs:server>
>
> I am currently testing one of available services that now looks as
> follows (showing only a couple of methods for simplicity):
>
> @Path("users")
> @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
> @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
> public interface UserService {
>
> @GET
> @Path("{userId}")
> @Descriptions(
> @Description(target = DocTarget.METHOD, value = "Returns a
> single user matching the provided userId"))
> UserTO read(@PathParam("userId") Long userId);
>
>
> @GET
> @XMLName("{http://syncope.apache.org/1.1}users")
> List<UserTO> list();
> }
>
> Now, while the former becomes (in the WADL)
>
> <method name="GET" id="read">
> <doc>Returns a single user matching the provided userId</doc>
> <request/>
> <response>
> <representation mediaType="application/xml" element="syncope1:user"/>
> <representation mediaType="application/json" element="syncope1:user"/>
> </response>
> </method>
>
> which is just fine, the latter is instead reported as
>
> <method name="GET" id="list">
> <response>
> <representation mediaType="application/xml" element="syncope1:users"/>
> <representation mediaType="application/json" element="syncope1:user"/>
> </response>
> </method>
>
> As you can see, representation/@element is different between JSON and
> XML, e.g. for XML the value provided via @XMLName is used, while for
> JSON it is reported as if the return type was plain 'UserTO' instead of
> 'List<UserTO>'.
This is a bug to do with linking JSON reps to XML schemas, I'll have a
look; I'm actually experimenting with WADL Generator right now anyway :-)
> Without @XMLName, element attribute is not even reported for XML.
>
Right, I thought that typically we can't be 100% sure what the wrapper
name is, the default would be XMLRootElement's local name + "s" - but it
is not guaranteed to be precise; however I think may be we can relax it,
users can customize with XMLName if the default name calculation does
not work
> Moreover, I would expect to find something in the <schema> section of
> the WADL for '{http://syncope.apache.org/1.1}users', as [1] seems to
> suggest.
>
has UserTO @XmlRootElement attached to it ?
Cheers, Sergey
> Any clue?
> TIA
>
> Regards.
>
> [1]
> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-RepresentingexplicitJAXBcollections
>
>