Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ


Choose your language

InfoQ Homepage News How Relevant Is Contract First Development Using Angle Brackets?

How Relevant Is Contract First Development Using Angle Brackets?

Leia em Português

This item in japanese

Christian Weyer of Thinktecture, announced the release of a Visual Studio Add-in that enables contract first development of web services using WCF.

It has been a long time where I originally built the Web Services Contract First tool...
This tool - briefly called WSCF - (available both as a command line utility and a simple Visual Studio add-in) was targeted at the ASMX platform.

The idea of contract first development has been around for a long time. The need for contract first arises from the need for a canonical representation of the shape of the messages that flow to and from a service in the form of web service requests. Most popular languages support WSDL and XSD based tools and Schema and WSDL based representations of these message “contracts” as a starting point is arguably a sound approach to having an interoperable solutions.

The contract first development style addresses the impedance mismatch between objects and XML. Since Xml Schema language is a richer representation format its easy to model the contracts taking into consideration the differences to pare down the serialization and interoperability problems, some of which include

  • Inability to map certain constructs of the schema language for e.g. XSD type extensions and restrictions.
  • Inability to mapping or at least efficiently map certain object types to schema types for e.g. Generic lists, HashMaps etc.
  • Inability to represent object graphs effectively in XML especially in Parent/Child relationships where the Parent holds the reference to the children and the Child holds a reference back to the parent object.

Some advantages of using this approach are

  • Defining language agnostic contracts promotes interoperability, provided service designers adhere to WS-I interoperability standards
  • Promotes reuse of contract definition artifacts across the enterprise i.e. XSD and WSDL
  • Allows for controlled versioning of services and lends itself to better governance eventually. is Visual Studio 2008 add-in is an open source project hosted at CodePlex. The capabilities of the tool as listed include.

  • A WSDL Wizard that allows the developer to step through the creation of a WSDL from one or more XSDs
  • A DataContract generator (similar to XSD.exe, XSDObjectGen.exe and Svcutil.exe) that generates the . NET equivalent of the XSD types
  • A service/endpoint stub (SVC) generator and
  • A client proxy generator.

The tool still has a list of known issues, which will hopefully be ironed out by the time the product comes out of beta. The tool also has a walkthrough from the 0.7 version of the WSCF.classic add-in that is still relevant for the most part. Given that Microsoft WCF supports contracts in code, no angle brackets, XSD or WSDL required, how important is it to have tools that focus on modeling message and service contracts using WSDL and XSD?

Rate this Article