Pete On Software

RSS Feed

Web Services Software Factory (1 of 5)

Note: All links current as of the time of this blog post

This is the first in a series of five tutorial posts on the Web Services Software Factory. The Web Services Software Factory (WSSF) is a product that has come out of the Microsoft Patterns and Practices Group and its goal is to aid you in the mundane tasks that accompany setting up a robust WCF or ASMX service. The outline of the tutorials will be as follows:

Post 1: Download, Install, and Setup our Demo Project
Post 2: Create Data Contracts and Implement Business Entities and Translators
Post 3: Create Service Contracts and Implement the Methods
Post 4: Create Host Contract, Deploy and Test WSDL
Post 5: Generate Proxy, Create Simple Client, Call Service to Test

The original WSSF version had a lot of XML configuration to create contracts. With the version that came out in February (called the Modeling Edition), Microsoft Patterns and Practices added a lot of visual designers and even more code generation to the product. However, that is enough of the prelude, lets get into the example.

First you have to do some downloading and installing. You must first download and install GAX (Guidance Automation Extensions) 1.4. It can be found here. Installation is very simple and you just have to run the installer and accept the defaults to go on.

Next, you have to download the WSSF itself. Go here and download the product. If you are on Vista, you have to run the installer from an elevated command prompt. To do that you merely have to get the command prompt to show up in your start menu (either by searching or because you’ve saved it there as I have) and right click on it. Run As Administrator will be one of your options as shown below. After you have the prompt, execute the installer.
Get Elevated Command Prompt

You will then get the installation wizard and again you can accept the defaults and move on.
Install WSSF

Once you have installed the WSSF, start Visual Studio 2008 and click File–> New –> Project. Then select Guidance Packages, Service Factory: Modeling Edition, and then Model Project. Chose a directory and call the project MyCryptographyService and click OK. Note: we are going to do WCF, so make sure that you target Framework 3.0 at a minimum. I’m going to choose 3.5 just to run the “latest and greatest” :-)
Create Modeling Edition Project

Rename the MyCryptographyService model project file to MyCryptographyService.model (so we can add a project of that same name later).
Rename Default Model

Right click on the solution and choose Add–> WCF Implementation Projects.
Add WCF Implementation Project Menu

This brings up the Add New Project dialog yet again. Name it MyCryptographyService (this is why we renamed earlier) and click OK.
Adding the new WCF Project

Visual Studio will grind away for a second and when it is done, it will have produced a boatload of projects for you in your solution. You will also notice that the projects that should reference each other already do, helping you along in making sure that you separate your code properly. Build your project and everything should build nicely. It doesn’t do much now, but more will come next time. If you have errors, please make sure that you followed the steps correctly.
Solution Explorer Populated with Projects

Next time we will dig into the designers and begin to implement the entities in our project.

13 Comments

Jeffrey Meyer  on May 14th, 2008

This is great, tuna! I’ve heard a lot of good things about this tool. Can’t wait for Part 2!

Pete on Software  on May 27th, 2008

You can find Part Two of this tutorial over here.

Pete on Software  on July 20th, 2008

[…] you missed the beginning of the series, you should check out Part 1 and Part 2 before beginning this part if you want to follow […]

Pete on Software  on July 20th, 2008

[…] in the home stretch. If you haven’t already, you may want to take a look at tutorial parts 1, 2, and 3 before beginning this […]

Pete on Software  on July 20th, 2008

[…] have landed. This is tutorial part 5 of 5. In parts 1-4 (part 1 starts here) we created a web service that does some simple encryption, decryption, and hashing. Before […]

Uday  on July 12th, 2009

hi,

The tutorial is very good and understandable.can u please send the tutorial for ASMX Implementation.

Regards,
Uday

Prashant  on October 24th, 2009

Hi,
Thanks Thanks

This is tutorial is realy too good.
but pls send me ASMX Implementation tutorial.

Thanks and Regard
Prashant Gadekar
Sr Developer
VirtueTech India

Satya Ramani  on April 24th, 2010

Hey Pete,

Finally, I went through your WCF sample project and all 5 series of WSSF and it was excellent!!!

Thanks again,
Satya

Pete  on April 25th, 2010

Satya,

Glad you found it useful and I hope that things are going well for you.

Randhir  on July 12th, 2010

Hi,
When we change the Service name and and new WCF Service Implementation it say with this name a service is already exist. Please suggest me because i carefully checked but not getting the reason.

Thanks in advance

Pete  on July 12th, 2010

Can you maybe zip your solution and document your problem a little better so I could look at it? The way your comment is worded, it could be lots of things.

Satya  on August 2nd, 2011

Pete,

I am really doing good and I am in MI now.Recently I had spent couple of hours to findout your blog but could not but today I was browsing something personal and accidently got a lead to access your blog…it was really excitng!

I will soon read more from this blog.

You have a good time!
Satya

Pete  on August 4th, 2011

Satya,

Glad you are doing well. Funny how one thing can lead to another and you never know where you’ll end up.

Leave a Comment