W3C home > Mailing lists > Public > www-ws-desc@w3.org > February 2004

RE: Version attribute for WSDL

From: Jeff Mischkinsky <jeff.mischkinsky@oracle.com>
Date: Thu, 12 Feb 2004 22:30:04 -0800
Message-Id: <4.3.2.7.2.20040212222600.0265e5e8@rgmamerimap.oraclecorp.com>
To: <paul.downey@bt.com>, <vbp@hp.com>, <tomj@macromedia.com>, <www-ws-desc@w3.org>

At 09:02 AM 2/12/2004, paul.downey@bt.com wrote:

>I believe the version value is useful information for when the
>interface has been compatibly changed within the same namespace.
>
>+1 Tom's proposal, i can't see any harm and it could be useful
>as a building block for a mechanism for relating an interface
>version to other versions, akin to the 'previous', 'this' and
>'latest' version URLs on W3C publications.

Without defining any semantics I don't see how it can be a useful building 
block. I agree with William's point. All it will tell you is that something 
is probably different. (Not that I don't agree that what Paul would like 
would be a good thing. I just don't see how this proposal gets us there, or 
even close.)
   jeff


>Paul
>
>
>-----Original Message-----
>From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org]On
>Behalf Of Vambenepe, William N
>Sent: 12 February 2004 16:53
>To: Tom Jordahl; www-ws-desc@w3.org
>Subject: RE: Version attribute for WSDL
>
>
>
>
>Thanks Tom for the proposal. I could live with this attribute on
><definitions> but I really don't like it on <interface>. As Glen
>eloquently explained at the F2F, a different interface should use a
>different QName. What does it mean for a binding to reference an
>interface if there are dozens of "versions" of this interface. Can I
>have a binding for only a certain version of an interface? I know we
>don't have to answer this since we "define no semantic" but that doesn't
>make the problem go away.
>
>William
>
>
> > -----Original Message-----
> > From: www-ws-desc-request@w3.org
> > [mailto:www-ws-desc-request@w3.org] On Behalf Of Tom Jordahl
> > Sent: Thursday, February 12, 2004 6:13 AM
> > To: 'www-ws-desc@w3.org'
> > Subject: Version attribute for WSDL
> >
> >
> >
> >
> > In fulfillment of my action item received at the January F2F,
> > here is a
> > proposal to add a version attribute to WSDL to aid in the
> > versioning of WSDL
> > documents and interfaces.
> >
> > I propose that an attribute with the name "version" be added to the
> > <definitions> element of WSDL.  This attribute is for user
> > convenience, and
> > the specification would define no semantics for it,
> > specifically the value
> > of this attribute would NOT be included in the infoset.
> > However, it is
> > expected that WSDL authors and consumers can use this attribute, when
> > present, to differentiate between different revisions of a
> > WSDL document.
> >
> > Example:
> >
> > <definitions version="1" targetNamespace=http://sample.org/>
> > ...
> > </definitions>
> >
> > This proposal is modeled after the version attribute of XML
> > Schema, see
> > section 3.15.2 in Part 1 of the XML Schema specification:
> >   http://www.w3.org/TR/xmlschema-1/#Schemas
> >
> > In our specification, section 2.1.2 would be updated to
> > include the new
> > attribute:
> >
> > 2.1.2 XML Representation of Definitions Component
> >
> > <definitions
> >       targetNamespace="xs:anyURI"
> >       version = "xs:token"? >
> >   <documentation />?
> >   [ <import /> | <include /> ]*
> >   <types />?
> >   [ <interface /> | <binding /> | <service /> ]*
> > </definitions>
> >
> >
> > Additionally, I propose that a similar version attribute be
> > added to the
> > <interface> element of WSDL. This attribute would mirror the
> > definitions
> > attribute.  Again, this would be for user convenience, and
> > the specification
> > would define no semantics for it, specifically the value of
> > this attribute
> > would NOT be included in the infoset.  WSDL authors and
> > consumers could use
> > this attribute, when present, to differentiate between
> > different revisions
> > of an interface.  In particular, this would enable a consumer of the
> > document to know explicitly when an interface they are using
> > has changed.
> >
> > Example:
> > <definitions>
> >   <interface name="myInterface" version="alpha17">
> >     ...
> >   </interface>
> > </definitions>
> >
> >
> > 2.2.2 XML Representation of Interface Component
> > <definitions>
> >   <interface
> >         name="xs:NCName"
> >         extends="list of xs:QName"?
> >         styleDefault="xs:anyURI"?
> >         version = "xs:token"? >
> >     <documentation />?
> >     [ <operation /> | <feature /> | <property /> ]*
> >   </interface>
> > </definitions>
> >
> >
> > --
> > Tom Jordahl
> > Macromedia Server Development
> >
> >

Jeff Mischkinsky                      jeff.mischkinsky@oracle.com
Consulting Member Technical Staff     +1(650)506-1975
Director, Web Services Standards      500 Oracle Parkway M/S 4OP9
Oracle Corporation                    Redwood Shores, CA 94065
Received on Friday, 13 February 2004 01:36:34 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 5 February 2014 07:15:02 UTC