一、前言

通过前面二十几个章节的学习，我们知道了什么是WCF；WCF中的A、B、C；WCF的传输模式；WCF的寄宿方式；WCF的异常处理。本文综合应用以上知识点，一步一步写一个小的WCF应用程序——书籍管理系统（BookMgr）。

这个示例就是一个非常简单的书籍管理系统，功能有：查询、修改、新增、删除(不包括安全、优化等相关问题)、异常处理。WCF的增删改查和WinForm相差无几。WCF只是把具体“实现”写在“服务端”，而“调用”放在了“客户端”。

二、BookMgr说明

1）Demo的 “服务端”以本机控制台应用程序为宿主，“客户端”以WinForm项目为例。

2）Demo的“服务端”提取数据采用初学者比较容易接受的分层结构进行搭建，分别分为服务层、实体层、数据层。

引用关系如下图所示：

3）Demo数据库为SqlServer，表为Books(sql语句在下载的压缩包中“初始化脚本.sql”)，表结构如下所示：

三、创建WCF服务端项目结构

• BookMgr.Contracts：一个类库项目，定义服务协定（Service Contract），引用System.ServiceMode程序集，见下图。

• BookMgr.Services：一个类库项目，提供对WCF服务的实现。定义在该项目中的所有WCF服务实现了定义在Contracts中相应的服务协定，所以Services具有对Contracts项目的引用。见下图1，图2。

图1

图2

• BookMgr.Hosting：一个控制台（Console）应用，实现对定义在Services项目中的服务的寄宿，该项目须要同时引用Contracts和Services两个项目和System.ServiceMode程序集。见下图1，图2。

图1

图2

• BookMgr.Common：解决方案中公共使用的类。见下图。

• BookMgr.Model：一个对象实体项目，实现对数据库中的表结构进行实体对象构建。通过EF 6来实现。见下图。

• 最终的项目结构图如下。

四、创建BookMgr.Contracts项目代码

1）在项目中创建一个 IBookService接口文件与SQLError文件。见下图。

2）在BookMgr.Contracts中创建一个表示Fault异常的类SQLError.cs。代码如下。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;

using System.Text;
using System.Threading.Tasks; 

namespace BookMgr.Contracts
{
    [DataContract]
    public class SQLError
    {
        private string _operation;
        private string _errorMessage;
        public SQLError(string operation, string errorMessage)

        {
            this._operation = operation;
            this._errorMessage = errorMessage;
        }

        [DataMember]
        public string Operation
        {
            get { return _operation; }
            set { _operation = value; }
        } 

        [DataMember]
        public string ErrorMessage
        {
            get { return _errorMessage; }
            set { _errorMessage = value; }
        }

    }
}

3）在BookMgr.Contracts中IBookService.cs接口文件。并分别创建增、删、改、查、”Add”、“Edit”、“Delete”、“Get，Search”五个方法，分别对应五个功能的服务应用程序WCF服务应用程序。我在“Edit”方法中添加了一个自定义异常返回的特性。具体代码如下。

using System;
using System.Collections.Generic;

using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace BookMgr.Contracts
{

    public interface IBookService
{

  [OperationContract]
         string Add(string bookInfo);

  [OperationContract]
        [FaultContract(typeof(SQLError))]
        string Edit(string bookInfo);

  [OperationContract]
        string Get(string bookId);

  [OperationContract]
        string Delete(string bookInfo);

  [OperationContract]
        string Search(string Category, string searchString); 

    }
}