Thursday, April 09, 2009

2009-04-08 Thursday - SOA Governance - Versioning

I'm working on the draft of a proposed SOA Governance policy document (Service/WSDL/XSD Versioning) for a current client engagement, and have found the following links/references to be useful in guiding some of my thinking:

1 Designing and versioning compatible Web services; March 28, 2007; Aditya Narayan, Founder, QCD Microsystems; Irina Singh, Senior Consultant, IBM
http://www.ibm.com/developerworks/websphere/library/techarticles/0705_narayan/0705_narayan.html

2 Best practices for Web services versioning; January 30, 2004; Kyle Brown, Senior Technical Staff Member, IBM; Michael Ellis, Solution Architect, IBM;
http://www.ibm.com/developerworks/webservices/library/ws-version/

3 Web Services Description Language (WSDL) 1.1, W3C Note 15 March 2001
http://www.w3.org/TR/wsdl

4 Web Services Description Language (WSDL) Version 2.0 Part 0: Primer, W3C Recommendation 26 June 2007
http://www.w3.org/TR/2007/REC-wsdl20-primer-20070626/#basics

5 Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language W3C Recommendation 26 June 2007
http://www.w3.org/TR/2007/REC-wsdl20-20070626/

6 Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts W3C Recommendation 26 June 2007
http://www.w3.org/TR/2007/REC-wsdl20-adjuncts-20070626/

7 WSDL 2.0 SOAP Binding Namespace
http://www.w3.org/2007/06/wsdl/soap.xsd

8 W3C Architecture Domain, Web Services Home
http://www.w3.org/2002/ws/Activity

9 WSDL 2.0 SOAP Binding NamespaceW3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures W3C Working Draft 30 January 2009
http://www.w3.org/TR/xmlschema11-1/

10 XML Schema Part 1: Structures Second Edition W3C Recommendation 28 October 2004
http://www.w3.org/TR/xmlschema-1/

11 Versioning XML Vocabularies; By David Orchard; December 03, 2003
http://www.xml.com/lpt/a/1329

12 Extensibility, XML Vocabularies, and XML Schema; By David Orchard; October 27, 2004
http://www.xml.com/lpt/a/1492

13 Web Service Contract Versioning Fundamentals Part I: Versioning and Compatibility; by Thomas Erl, David Orchard and James Pasley;
Published: November 17, 2008 (SOA Magazine Issue XXIII: October-November 2008)
http://www.soamag.com/I23/1108-5.asp

14 Web Service Contract Versioning Fundamentals Part II: Version Identifiers and Versioning Strategies ; by Thomas Erl, David Orchard and James Pasley; Published: Jaunary 19, 2009 (SOA Magazine Issue XXV: January 2009)
http://www.soamag.com/I25/0109-4.asp

15 Versioning Options; Scott Seely; Microsoft Corporation; October 15, 2002
http://msdn.microsoft.com/en-us/library/aa480518.aspx

16 Design Strategies for Web Services Versioning, Adapting to the needs of the business; By Chris Peltz, Anjali Anagol-Subbarao , April 14, 2004, SOA World Magazine
http://soa.sys-con.com/node/44356

17 Zero, One, or Many Namespaces?
http://www.xfront.com/ZeroOneOrManyNamespaces.pdf

18 Checking a Web service for version changes at runtime; Jim Culbert; August 1, 2003
http://searchsoa.techtarget.com/tip/0,289483,sid26_gci917380_mem1,00.html

19 Checking a Web service for version changes at runtime; Jim Culbert; August 1, 2003
http://searchsoa.techtarget.com/tip/0,289483,sid26_gci917380_mem1,00.html

20 Notes on Versioning of XML schemas; O. Newell; MIT Lincoln Laboratory; August 29, 2007
https://wiki.ucar.edu/download/attachments/13927814/VersioningNotes.pdf

21 Checking a Web service for version changes at runtime; Jim Culbert; August 1, 2003Notes on Versioning of XML schemas; O. Newell; MIT Lincoln Laboratory; August 29, 2007XML Schema Versioning Use Cases; Draft - 31 January 2006; W3C XML Schema Working Group
http://www.w3.org/XML/2005/xsd-versioning-use-cases/

22 “… more on XML Schemas”; Roger L. Costello; XML Technologies Course
http://sinbad.dit.upm.es/docencia/grado/curso0607/5%20optional%20Costello%20xml-schemas2.pdf

23 Versioning Web Service Parameters; Don Smith’s MSDN blog; December 3, 2004
http://blogs.msdn.com/donsmith/archive/2004/12/03/274198.aspx

24 One parameter to rule them all: Part 2; Don Smith’s MSDN blog; November 29, 2004
http://blogs.msdn.com/donsmith/archive/2004/11/29/271419.aspx

25 Make minor backward-compatible changes to your Web services; Russell Butek; Web Services Consultant, IBM; November 30, 2004
http://www.ibm.com/developerworks/webservices/library/ws-backward.html

26 [Web] Service Versioning Guidance; Don Smith, January 31, 2006
http://blogs.msdn.com/donsmith/archive/2006/01/31/520338.aspx

27 Principles of Service Design: Service Versioning; John Evdemon, MSDN; August 2005
http://msdn.microsoft.com/en-us/library/ms954726.aspx

28 SOA Change Management (Part 1); Robin Mulkers; November 8, 2005
http://it.toolbox.com/blogs/composite-apps/soa-change-management-part-1-6451

29 Versioning; Codehaus Xfire > Users Guide; Dan Diephouse; March 2007
http://docs.codehaus.org/display/XFIRE/Versioning

30 Designing Extensible, Versionable XML Formats; by Dare Obasanjo; July 21, 2004
http://www.xml.com/pub/a/2004/07/21/design.html

31 Splitting up WSDL: The Importance of targetNamespace; Scott Seely; MSDN; August 20, 2002
http://msdn.microsoft.com/en-us/library/aa480511.aspx

32 Versioning REST Web Services; Peter Williams; May 11, 2008 http://barelyenough.org/blog/2008/05/versioning-rest-web-services/

33 Design Strategies for Web Service Versioning; Chris Peltz, Anjali Anagol-Subbarao; April 5, 2004
http://soa.sys-con.com/node/44356




2009-04-24 Friday Update:

WS02 Governance Server > WSDL tool Checklist

No comments: