You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cxf.apache.org by "Sergey Beryozkin (JIRA)" <ji...@apache.org> on 2011/01/11 23:07:46 UTC

[jira] Created: (CXF-3242) Improve the way primitive request or response types are shown in WADL

Improve the way primitive request or response types are shown in WADL
---------------------------------------------------------------------

                 Key: CXF-3242
                 URL: https://issues.apache.org/jira/browse/CXF-3242
             Project: CXF
          Issue Type: Improvement
          Components: JAX-RS
    Affects Versions: 2.3.1
            Reporter: Sergey Beryozkin
            Assignee: Sergey Beryozkin
             Fix For: 2.3.2, 2.4


Gilgal Jones :
 
Sergey,

Here is the response I got on users@wadl.dev.java.net from Marc Hadley:

I assume you are trying to describe a representation that contains a Boolean
- right ?

I think a better way to represent this would as follows:

<representation mediaType="text/plain">
 <param name="result" type="xsd:Boolean" style="plain"/>
</representation>

It might be worth considering switching from text/plain to something with a
bit more structure. E.g. you could use application/x-www-form-urlencoded:
instead of a body of "true" you'd send back "result=true". That little bit
of extra structure will allow you to add additional information in the
future with less chance of breaking (well written) clients. In that case
you'd use style="query" in the param element. Personally I'd use JSON or XML
but I understand the urge to keep things simple.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

[jira] Resolved: (CXF-3242) Improve the way primitive request or response types are shown in WADL

Posted by "Sergey Beryozkin (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3242?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Sergey Beryozkin resolved CXF-3242.
-----------------------------------

    Resolution: Fixed

> Improve the way primitive request or response types are shown in WADL
> ---------------------------------------------------------------------
>
>                 Key: CXF-3242
>                 URL: https://issues.apache.org/jira/browse/CXF-3242
>             Project: CXF
>          Issue Type: Improvement
>          Components: JAX-RS
>    Affects Versions: 2.3.1
>            Reporter: Sergey Beryozkin
>            Assignee: Sergey Beryozkin
>             Fix For: 2.3.2, 2.4
>
>
> Gilgal Jones :
>  
> Sergey,
> Here is the response I got on users@wadl.dev.java.net from Marc Hadley:
> I assume you are trying to describe a representation that contains a Boolean
> - right ?
> I think a better way to represent this would as follows:
> <representation mediaType="text/plain">
>  <param name="result" type="xsd:Boolean" style="plain"/>
> </representation>
> It might be worth considering switching from text/plain to something with a
> bit more structure. E.g. you could use application/x-www-form-urlencoded:
> instead of a body of "true" you'd send back "result=true". That little bit
> of extra structure will allow you to add additional information in the
> future with less chance of breaking (well written) clients. In that case
> you'd use style="query" in the param element. Personally I'd use JSON or XML
> but I understand the urge to keep things simple.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.