Issues in WADL stylesheet when referencing faults or methods

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|

Issues in WADL stylesheet when referencing faults or methods

Yves Saintillan
Issues in WADL stylesheet when referencing faults or methods

Hello,

I am using the WADL XSL stylesheet and noticed a couple of issues when referencing faults or methods in a WADL:

- When making a reference (href) to a Fault, defined directly  under the application element, the fault is not correctly displayed in the HTML output; in particular, the status of the fault (in the reference or in the definition) does not appear.

- Similarly, when making reference to a method, defined directly under the application element, the name of the method is not displayed in the HTML documentation.

So it seems the XSL stylesheet handles well references to representations, but not faults or methods. Are you aware of these issues ?

Thanks and kind regards,
Yves

Reply | Threaded
Open this post in threaded view
|

Re: Issues in WADL stylesheet when referencing faults or methods

Mark Nottingham-2

Could you provide sample input that triggers this?

Thanks,


On 22/11/2008, at 4:26 AM, SAINTILLAN YVES wrote:

> Hello,
>
> I am using the WADL XSL stylesheet and noticed a couple of issues  
> when referencing faults or methods in a WADL:
>
> - When making a reference (href) to a Fault, defined directly  under  
> the application element, the fault is not correctly displayed in the  
> HTML output; in particular, the status of the fault (in the  
> reference or in the definition) does not appear.
>
> - Similarly, when making reference to a method, defined directly  
> under the application element, the name of the method is not  
> displayed in the HTML documentation.
>
> So it seems the XSL stylesheet handles well references to  
> representations, but not faults or methods. Are you aware of these  
> issues ?
>
> Thanks and kind regards,
> Yves
>


--
Mark Nottingham     http://www.mnot.net/


Reply | Threaded
Open this post in threaded view
|

RE: Issues in WADL stylesheet when referencing faults or methods

Yves Saintillan
Dear Mark,

Sure: please find attached a modified version of WADL for Yahoo
NewsSearch application, that allows to reproduce both issues. In the
WADL, the 'GET' method and 'SearchError' fault elements are both defined
as children of the application element.

Included XSD files, and generated HTML output documentation are also
attached.

Thanks,
Yves

-----Original Message-----
From: Mark Nottingham [mailto:[hidden email]]
Sent: samedi 22 novembre 2008 17:51
To: SAINTILLAN YVES
Cc: [hidden email]
Subject: Re: Issues in WADL stylesheet when referencing faults or
methods

Could you provide sample input that triggers this?

Thanks,


On 22/11/2008, at 4:26 AM, SAINTILLAN YVES wrote:

> Hello,
>
> I am using the WADL XSL stylesheet and noticed a couple of issues when

> referencing faults or methods in a WADL:
>
> - When making a reference (href) to a Fault, defined directly  under
> the application element, the fault is not correctly displayed in the
> HTML output; in particular, the status of the fault (in the reference
> or in the definition) does not appear.
>
> - Similarly, when making reference to a method, defined directly under

> the application element, the name of the method is not displayed in
> the HTML documentation.
>
> So it seems the XSL stylesheet handles well references to
> representations, but not faults or methods. Are you aware of these
> issues ?
>
> Thanks and kind regards,
> Yves
>

--
Mark Nottingham     http://www.mnot.net/


YahooSearch.wadl (5K) Download Attachment
NewsSearchError.xsd (998 bytes) Download Attachment
NewsSearchResponse.xsd (2K) Download Attachment
YahooSearchOutput.html (15K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Issues in WADL stylesheet when referencing faults or methods

Mark Nottingham-2
Fixed; some attributes weren't copied when expanding references. I may  
have missed some more, and there's hopefully a more elegant way to do  
it, but these problems should be gone, at least.

Cheers,


On 24/11/2008, at 10:13 PM, SAINTILLAN YVES wrote:

> Dear Mark,
>
> Sure: please find attached a modified version of WADL for Yahoo
> NewsSearch application, that allows to reproduce both issues. In the
> WADL, the 'GET' method and 'SearchError' fault elements are both  
> defined
> as children of the application element.
>
> Included XSD files, and generated HTML output documentation are also
> attached.
>
> Thanks,
> Yves
>
> -----Original Message-----
> From: Mark Nottingham [mailto:[hidden email]]
> Sent: samedi 22 novembre 2008 17:51
> To: SAINTILLAN YVES
> Cc: [hidden email]
> Subject: Re: Issues in WADL stylesheet when referencing faults or
> methods
>
> Could you provide sample input that triggers this?
>
> Thanks,
>
>
> On 22/11/2008, at 4:26 AM, SAINTILLAN YVES wrote:
>
>> Hello,
>>
>> I am using the WADL XSL stylesheet and noticed a couple of issues  
>> when
>
>> referencing faults or methods in a WADL:
>>
>> - When making a reference (href) to a Fault, defined directly  under
>> the application element, the fault is not correctly displayed in the
>> HTML output; in particular, the status of the fault (in the reference
>> or in the definition) does not appear.
>>
>> - Similarly, when making reference to a method, defined directly  
>> under
>
>> the application element, the name of the method is not displayed in
>> the HTML documentation.
>>
>> So it seems the XSL stylesheet handles well references to
>> representations, but not faults or methods. Are you aware of these
>> issues ?
>>
>> Thanks and kind regards,
>> Yves
>>
>
>
> --
> Mark Nottingham     http://www.mnot.net/
>



--
Mark Nottingham     http://www.mnot.net/


YahooSearch.wadl (6K) Download Attachment
NewsSearchError.xsd (748 bytes) Download Attachment
NewsSearchResponse.xsd (2K) Download Attachment
YahooSearchOutput.html (11K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

RE: Issues in WADL stylesheet when referencing faults or methods

Yves Saintillan
Mark,
Thanks a lot for fixing this, and best wishes for the new year!

I have now a couple of other issues with the stylesheet:

- When a WADL resource makes use of the 'type' attribute to refer to a resource_type element, the documentation does not display correctly the URI of the corresponding resource: only the base URI is displayed. For example, I have modified the previous WADL (see in attachment), so that the resource with path 'newsSearch' makes reference to a resource_type 'searchResourceType'; in the generated documentation (also attached), the relative path 'newsSearch' is missing from the resource URI.

- My other issue is about the queryType attribute of a resource element (which is optional and defaults to application/x-www-form-urlencoded): it seems this attribute is ignored by the stylesheet and does not appear in the generated documentation; is there a particular reason for this ?

Thanks and kind regards,
Yves

-----Original Message-----
From: Mark Nottingham [mailto:[hidden email]]
Sent: mardi 9 d├ęcembre 2008 12:34
To: SAINTILLAN YVES
Cc: [hidden email]
Subject: Re: Issues in WADL stylesheet when referencing faults or methods

Fixed; some attributes weren't copied when expanding references. I may have missed some more, and there's hopefully a more elegant way to do it, but these problems should be gone, at least.

Cheers,


On 24/11/2008, at 10:13 PM, SAINTILLAN YVES wrote:

> Dear Mark,
>
> Sure: please find attached a modified version of WADL for Yahoo
> NewsSearch application, that allows to reproduce both issues. In the
> WADL, the 'GET' method and 'SearchError' fault elements are both
> defined as children of the application element.
>
> Included XSD files, and generated HTML output documentation are also
> attached.
>
> Thanks,
> Yves
>
> -----Original Message-----
> From: Mark Nottingham [mailto:[hidden email]]
> Sent: samedi 22 novembre 2008 17:51
> To: SAINTILLAN YVES
> Cc: [hidden email]
> Subject: Re: Issues in WADL stylesheet when referencing faults or
> methods
>
> Could you provide sample input that triggers this?
>
> Thanks,
>
>
> On 22/11/2008, at 4:26 AM, SAINTILLAN YVES wrote:
>
>> Hello,
>>
>> I am using the WADL XSL stylesheet and noticed a couple of issues
>> when
>
>> referencing faults or methods in a WADL:
>>
>> - When making a reference (href) to a Fault, defined directly  under
>> the application element, the fault is not correctly displayed in the
>> HTML output; in particular, the status of the fault (in the reference
>> or in the definition) does not appear.
>>
>> - Similarly, when making reference to a method, defined directly
>> under
>
>> the application element, the name of the method is not displayed in
>> the HTML documentation.
>>
>> So it seems the XSL stylesheet handles well references to
>> representations, but not faults or methods. Are you aware of these
>> issues ?
>>
>> Thanks and kind regards,
>> Yves
>>
>
>
> --
> Mark Nottingham     http://www.mnot.net/
>

YahooSearch.wadl (5K) Download Attachment
YahooSearchOutput.html (16K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Issues in WADL stylesheet when referencing faults or methods

Mark Nottingham-2
I've applied the patch that Yves sent to me privately -- many thanks  
(and sorry for the delay).

Cheers,


On 07/01/2009, at 4:03 AM, SAINTILLAN YVES wrote:

> Mark,
> Thanks a lot for fixing this, and best wishes for the new year!
>
> I have now a couple of other issues with the stylesheet:
>
> - When a WADL resource makes use of the 'type' attribute to refer to  
> a resource_type element, the documentation does not display  
> correctly the URI of the corresponding resource: only the base URI  
> is displayed. For example, I have modified the previous WADL (see in  
> attachment), so that the resource with path 'newsSearch' makes  
> reference to a resource_type 'searchResourceType'; in the generated  
> documentation (also attached), the relative path 'newsSearch' is  
> missing from the resource URI.
>
> - My other issue is about the queryType attribute of a resource  
> element (which is optional and defaults to application/x-www-form-
> urlencoded): it seems this attribute is ignored by the stylesheet  
> and does not appear in the generated documentation; is there a  
> particular reason for this ?
>
> Thanks and kind regards,
> Yves
>
> -----Original Message-----
> From: Mark Nottingham [mailto:[hidden email]]
> Sent: mardi 9 d├ęcembre 2008 12:34
> To: SAINTILLAN YVES
> Cc: [hidden email]
> Subject: Re: Issues in WADL stylesheet when referencing faults or  
> methods
>
> Fixed; some attributes weren't copied when expanding references. I  
> may have missed some more, and there's hopefully a more elegant way  
> to do it, but these problems should be gone, at least.
>
> Cheers,
>
>
> On 24/11/2008, at 10:13 PM, SAINTILLAN YVES wrote:
>
>> Dear Mark,
>>
>> Sure: please find attached a modified version of WADL for Yahoo
>> NewsSearch application, that allows to reproduce both issues. In the
>> WADL, the 'GET' method and 'SearchError' fault elements are both
>> defined as children of the application element.
>>
>> Included XSD files, and generated HTML output documentation are also
>> attached.
>>
>> Thanks,
>> Yves
>>
>> -----Original Message-----
>> From: Mark Nottingham [mailto:[hidden email]]
>> Sent: samedi 22 novembre 2008 17:51
>> To: SAINTILLAN YVES
>> Cc: [hidden email]
>> Subject: Re: Issues in WADL stylesheet when referencing faults or
>> methods
>>
>> Could you provide sample input that triggers this?
>>
>> Thanks,
>>
>>
>> On 22/11/2008, at 4:26 AM, SAINTILLAN YVES wrote:
>>
>>> Hello,
>>>
>>> I am using the WADL XSL stylesheet and noticed a couple of issues
>>> when
>>
>>> referencing faults or methods in a WADL:
>>>
>>> - When making a reference (href) to a Fault, defined directly  under
>>> the application element, the fault is not correctly displayed in the
>>> HTML output; in particular, the status of the fault (in the  
>>> reference
>>> or in the definition) does not appear.
>>>
>>> - Similarly, when making reference to a method, defined directly
>>> under
>>
>>> the application element, the name of the method is not displayed in
>>> the HTML documentation.
>>>
>>> So it seems the XSL stylesheet handles well references to
>>> representations, but not faults or methods. Are you aware of these
>>> issues ?
>>>
>>> Thanks and kind regards,
>>> Yves
>>>
>>
>>
>> --
>> Mark Nottingham     http://www.mnot.net/
>>



--
Mark Nottingham     http://www.mnot.net/


YahooSearch.wadl (6K) Download Attachment
YahooSearchOutput.html (12K) Download Attachment