dev@wadl.java.net

Re: Updated WADL Spec

From: Marc Hadley <Marc.Hadley_at_Sun.COM>
Date: Tue, 03 Feb 2009 17:55:30 -0500

Thanks for the review.

The use of URI references rather than idrefs was deliberate, I'll add
some text to the specification to highlight this.

Marc.

On Feb 3, 2009, at 5:21 PM, Norman Gray wrote:

>
> Marc, hello.
>
> On 2009 Feb 2, at 22:03, Marc Hadley wrote:
>
>> - The namespace was changed to http://wadl.dev.java.net/2009/02.
>> - Resolved issue 13. The status attribute was moved from the
>> representation element to the
>> response element. The cardinality of the response element was
>> changed from 0–1 to 0–many.
>> The fault element was removed.
>
>> I haven't updated the wadl2java code to support these changes yet,
>> I'll be working on that next. In the meantime I'd be grateful if
>> one or more of you could sanity check the updated spec and schemas.
>
>
> The changed spec looks good to me, and I've successfully implemented
> my own XSLT changes to fit the changed schema (so there's no obvious
> gotchas there).
>
> The only comment I'd make is that the cross referencing between
> <representation> elements uses href and id attributes which are
> xsd:anyURI and xsd:token respectively. Though this cross-
> referencing was in the background when I initially raised issue 13,
> it hadn't registered with me until I tried to implement it, that
> this isn't an id/idref relationship.
>
> While I can see some advantage to having the <representation
> href='...'/> point to any URI, I'd have thought the main, and much
> more common, use-case was providing a cross-reference to another
> <representation> in the same document. While this isn't a big deal
> (an in-document cross reference can be handled in XSLT by a bit of
> extra logic which checks that the href starts with '#'), it is a
> little surprising, and I just wanted to flag it, to check it's
> deliberate.
>
> Best wishes,
>
> Norman
>
>
> --
> Norman Gray : http://nxg.me.uk
> Dept Physics and Astronomy, University of Leicester
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_wadl.dev.java.net
> For additional commands, e-mail: dev-help_at_wadl.dev.java.net
>

---
Marc Hadley <marc.hadley at sun.com>
CTO Office, Sun Microsystems.