Web Service Software Factory 2010

Retired Content

The Web Service Software Factory is now maintained by the community and can be found on the Service Factory site.

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies.
This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Retired: November 2011

patterns & practices Developer Center

patterns & practices Developer Center

May 2010

Summary

The Web Service Software Factory 2010 (also known as the Service Factory) is an integrated collection of resources designed to help you quickly and consistently build Web services that adhere to well-known architecture and design patterns. These resources consist of patterns and architecture topics in the form of written guidance and models with code generation in the form of tools integrated with Visual Studio 2010.

Visual Studio 2008 and Visual Studio 2005 users should use the Web Service Software Factory: Modeling Edition.

Downloads

Web Service Software Factory 2010

Web Service Software Factory 2010 Source Code

Web Service Software Factory Documentation (CHM)

Getting Started

15 Minute Walkthrough

Hands-on Lab: Building a Web Service

Community Web Service Software Factory Community

On This Page

  • System Requirements
  • What's New
  • Community
  • Future Plans
  • Authors and Contributors
  • Related Titles

System Requirements

To use the Web Service Software Factory 2010, you must have the following software installed on your system:

  • Operating system:
    • Windows 7 (x86 or x64)
    • Windows Server 2008 R2 (x64)
    • Windows Server 2008 (x86 or x64) with Service Pack 2
    • Windows Vista (x86 & x64) with Service Pack 1 – all editions except the Starter Edition
    • Windows XP (x86) with Service Pack 3 – all editions except the Starter Edition
    • Windows XP (x64) with Service Pack 2– all editions except the Starter Edition
    • Windows Server 2003 (x86 & x64) with Service Pack 2
    • Windows Server 2003 R2 (x86 and x64)
  • Visual Studio 2010 Ultimate, Premium, or Professional editions (32-bit or 64-bit)
  • Visual Studio 2010 Software Development Kit (SDK)
  • Guidance Automation Extensions (GAX) 2010

To build the Web Service Software Factory 2010 source code, you must have the following additional software installed on your system:

  • Guidance Automation Toolkit (GAX) 2010
  • Visual Studio 2010 Visualization and Modeling SDK

Note

If you use Microsoft Visual Studio 2010 Professional edition, you need to remove the FXCop.Rules.WcfSemantic project and the reference to it from the Web Service Software Factory 2010 (With Tests).sln solution.

What's New

The May 2010 release of the Web Service Software Factory is an update to the February 2008 release. These are the major changes:

  • The MSI installer has been replaced with the new Visual Studio Extensibility infrastructure (VSIX). This also means that if you are building from the source code, you should build a VSIX package for deployment rather than an MSI or WIX installation package. This release contains instructions that can help you to upgrade existing guidance packages, and the Guidance Automation Toolkit (GAT) 2010 will do this for you for new guidance packages.
  • External references have been updated to the latest version of .NET Framework 4.0, Enterprise Library 5.0, and GAX 2010.
  • Data contract models can now reference other data contract models, making data contract composition much easier. This has been a frequent request from the community. This change is possible because the DSL Integration Service (DIS), used to create model element relationships across designers, has been replaced with the Model Bus, a more robust alternative provided by the Visual Studio 2010 SDK.
  • Each model element now has a context menu option that shows the generated code for that element by opening the associated code file.
  • Performance regarding validation and manipulating elements has been improved on big models.
  • A new Generate All Code recipe has been added on each design surface that performs a scoped code generation by traversing all the referenced models. In practice, this means that all the code can be generated from the host model without the need to open the data contract and service contract designers.
  • This version supports cut, copy and paste model elements between the same or different designers. They can be pasted as images into external documents. This and other enhancements are the result of using the new Visualization and Modeling SDK for Visual Studio 2010.
  • WCF Semantic Code Analysis now adds the new rule-set file to the current menu options. You can select the rule-set file in the Code Analysis project properties or you can add it to an existing rule-set so that it will be part of an automated MSBUILD process. This file is located in the main WSSF extension installation folder.
  • A new Remark property has been added to all model elements. Text placed in this property will be added to the generated code in the form of an XML remarks element to complement code documentation.
  • The Service Contract model uses a new dialog for referencing data contract elements. This dialog uses the new Model Bus plumbing to give you a more comprehensive and robust way to select external elements.
  • The host designer is now more consistent with the user experience and metaphors used on the service contract and data contract models.
  • The client proxy generation now uses the built-in Visual Studio dialog for adding service references, which includes advanced features that influence the proxy code generated.
  • The host designer, service contract, and data contract models are fully backward compatible with the existing models (including the new host designer UI).
  • The custom model project has been replaced with a class library project. Models can now be placed in subfolders and also can be copied and pasted between projects more easily. This change also allows the Service Factory to use built in Visual Studio dialogs to create or export models.

Community

This software factory, like many patterns & practices deliverables, is associated with a community site. On the Web Service Software Factory community site, you can post questions, provide feedback, or connect with other users for sharing ideas. Community members can also help Microsoft plan and test future offerings and download additional content such as extensions and training material.

Future Plans

At the time of publication, no new releases of the Web Client Software Factory are planned. The patterns & practices team will continue to collect customer feedback and incorporate it into the product planning process and will be communicated on the community site and the patterns & practices roadmap forum.

Feedback and Support

Questions? Comments? Suggestions? To provide feedback about this software factory, or to get help with any problems, please visit the Web Service Software Factory Community site. The message board on the community site is the preferred feedback and support channel because it allows you to share your ideas, questions, and solutions with the entire community. The Web Client Software Factory is a guidance offering, designed to be reused, customized, and extended. It is not a Microsoft product. Code-based guidance is shipped "as is" and without warranties. Customers can obtain support through Microsoft Support Services for a fee, but the code is considered user-written by Microsoft support staff.

Authors and Contributors

The Web Service Software Factory 2010 was produced by the following individuals:

  • Program Management: Don Smith, Hanz Zhang (Microsoft Corporation)
  • Development: Hernan de Lahitte (Digit Factory)
  • Testing: Meenakshi Krishnamoorthi, Anitha Ganesan, Ravindra Varman (Infosys Technologies Ltd)
  • Documentation: RoAnn Corbisier (Microsoft Corporation), Richard Burte (ChannelCatalyst.com, Inc.), Sharon Smith (TinaTech, Inc.); Jennifer Burch (DCB Software Testing, Inc)

The previous version of the Service Factory: Modeling Edition (2008) was produced by the following individuals:

  • Program and Product Management: Dmitri Ossipov and Don Smith (Microsoft Corporation)
  • Architect: Wojtek Kozaczynski (Microsoft Corporation)
  • Development: Ade Miller and Bob Brumfield (Microsoft Corporation); Hernan de Lahitte, Nicolás Botto, and Julio C. Panderi (Digit Factory S.R.L.); Pablo Galiano (Clarius Consulting); Oscar Calvo (ArtinSoft)
  • Test: Rohit Sharma and Hanz Zhang (Microsoft Corporation); Mani Krishnaswami, Tarang Gupta, Kannan Raja Kandasamy, Anand Venkatesan, Latha Murugan, Pramod Mehta, Nalini S, Manickavasagam Shanmugasundaram, and Tushar More (Infosys Technologies Ltd)
  • Documentation: Nelly Delgado (Microsoft Corporation); Olaf Conijn (Olaf Conijn BV); Tina Burden McGrayne (TinaTech, Inc.); Alex Homer (Content Master Ltd.)

Early versions of the Service Factory were produced by the following individuals:

  • Program and Product Management: Don Smith, Dmitri Ossipov, Jason Hogg, Sanjeev Garg, and Tom Hollander (Microsoft Corporation)
  • Architect: Wojtek Kozaczynski, Edward Jezierski, and Dragos Manolescu (Microsoft Corporation)
  • Development: Chris Tavares (Microsoft Corporation); Hernan de Lahitte (Digit Factory); Pablo Galiano, Juan Wajnerman, José Escrich (Clarius Consulting); and Brian Button (Asynchrony Solutions, Inc.)
  • Test: Larry Brader and Carlos Farre (Microsoft Corporation); Tushar More, Mani Krishnaswami, Manickavasagam Shanmugasundaram, Arunkumar Sundararajan, Sajjad Nasir Imran, Meenakshi Krishnamoorthi, Muralidharan C Narayanan, Manu Agarwal, Bhavin Raichura, Vinod Kumar S, Venkata Reddy Donthireddy, and Lalitha Sundaram (Infosys Technologies Ltd)
  • Documentation: Nelly Delgado and RoAnn Corbisier (Microsoft Corporation); Lonnie Wall (RDA Corporation); William French (Linda Werner & Associates, Inc.); Paul Slater (Wadeware LLC); Tim Osborn (Ascentium Corporation); Tina Burden McGrayne (TinaTech, Inc.); and Claudette Siroky (CI Design Studio)

Many thanks to the following advisors who provided invaluable assistance:

  • Service Factory – Modeling Edition (February 2008): Edward Bakker (Logica CMG), Dennis Doomen (Aviva Solutions), Clemens Rijnen (Sogeti Netherlands), Gerben van Loon (Avanade), Gerardo de Geest (Avanade), Ludwik Wallin (Volvo Information Technology), Alain De Preter (Unisys), Jos Warmer (Ordina), René Schrieken (LogicaCMG), Antoine Savelkoul (Avanade Netherlands B.V.), Christian Weyer (thinktecture), Attila Hajdrik (Microsoft Corporation), Jezz Santos (Microsoft Corporation), Dennis Mulder (Microsoft Consultancy Services Netherlands), Lenny Fenster (Microsoft Corporation), Karl Schulmeisters (Unisys), Simon Ince (Microsoft Corporation)
  • Early versions of the Service Factory: Edward Bakker and René Schrieken (LogicaCMG); Aaron Skonnard (Pluralsight); Gabriel Gilabert and Patrick Johnston (Thomson Financial); Norman Headlam (Fidelity Investments); Brandon Bohling (Intel Corporation); Alejandro G. Jack (Southworks); Christian Weyer (Thinktecture); Daniel Cazzulino (Clarius Consulting); Steve Millet, Jan Alexander, Andy Gordon, Mark Fussell, Ford McKinstry, Steve Maine, Eugene Osovetsky, Daniel Roth, Jezz Santos, Beat Schwegler, Shy Cohen, Serena Yeoh, Vajira Weerasekera, Sam Keall, Jason McConnell, Pablo Castro, Sanjay Mishra, and Umachandar Jayachandran (Microsoft Corporation)

patterns & practices Developer Center