WCF学习之旅—实现支持REST服务端应用（二十三）
在上一篇（WCF学习之旅—实现REST服务（二十二））文章中简单介绍了一下RestFul与WCF支持RestFul所提供的方法，本文讲解一下如何创建一个支持REST的WCF服务端程序。
四、在WCF中创建REST服务
1. 在SCF.Contracts 在创建一个服务契约IBookRestService.
这里提供两个方法，分别采用GET和POST方式访问。
我们可以看到，与普通WCF服务契约不同的是，需要额外用WebGet或者WebInvoke指定REST访问的方式。另外还要指定消息包装样式和消息格式，默认的消息请求和响应格式为XML，若选择JSON需要显式声明。
UriTemplate用来将方法映射到具体的Uri上，但如果不指定映射，将映射到默认的Uri。比如采用Get访问的GetBook方法，默认映射是:/ GetBook?BookId={BookId}。
在编写代码的过程中，会出现如下图中1的错误，请引用下图2处的
using SCF.Model; using System; using System.Collections.Generic; using System.Linq; using System.ServiceModel; using System.ServiceModel.Web; using System.Text; using System.Threading.Tasks; namespace SCF.Contracts { [DataContractFormat] [ServiceContract] public interface IBookRestService { //[WebGet(UriTemplate = "/Books/Get/{BookId}/{categroy}", BodyStyle = WebMessageBodyStyle.Bare, ResponseFormat = WebMessageFormat.Json)] [WebGet(UriTemplate = "/Books/Get/{BookId}", BodyStyle = WebMessageBodyStyle.Bare)] [OperationContract] List<Books> GetBook(string BookId); //[WebInvoke(Method = "POST", UriTemplate = "/Books/Create", BodyStyle = WebMessageBodyStyle.Bare, ResponseFormat = WebMessageFormat.Json, RequestFormat = WebMessageFormat.Json)] [WebInvoke(Method = "POST", UriTemplate = "/Books/Add", BodyStyle = WebMessageBodyStyle.Bare)] [OperationContract] Result AddBook(Books book); } }
2. 在项目SCF.Model中创建一个实体对象Books与一个返回对象Result，用作数据传输的载体，下面是Books.cs的内容
namespace SCF.Model { using System; using System.Collections.Generic; using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema; using System.Data.Entity.Spatial; using System.Runtime.Serialization; ///DataContract 数据契约：服务端和客户端之间要传送的自定义数据类型 [DataContract(Namespace = "http://tempuri.org/")] public partial class Books { /// <summary> /// 在数据传送过程中，只有成员变量可以被传送而成员方法不可以。 /// 并且只有当成员变量加上DataMember时才可以被序列进行数据传输， /// 如果不加DataMember，客户端将无法获得该属性的任何信息 /// </summary> [DataMember] [Key] public int BookID { get; set; } [DataMember] [Required] public string Category { get; set; } [DataMember] [Required] public string Name { get; set; } [DataMember] public int Numberofcopies { get; set; } [DataMember] public int AuthorID { get; set; } [DataMember] public decimal Price { get; set; } [DataMember] public DateTime PublishDate { get; set; } [StringLength(5)] [DataMember] public string Rating { get; set; } } } using System; using System.Collections.Generic; using System.Linq; using System.Runtime.Serialization; using System.Text; using System.Threading.Tasks; namespace SCF.Model { [DataContract(Namespace = "http://tempuri.org/")] public class Result { [DataMember] public string Message { get; set; } } }
3. 在SCF.WcfService项目中实现在SCF.Contracts项目中定义的服务契约。这里最简单的实现GetBook和AddBook两个方法的逻辑。
using SCF.Contracts; using System; using System.Collections.Generic; using System.Linq; using System.Runtime.Serialization; using System.ServiceModel; using System.Text; using SCF.Model; using SCF.Common; namespace SCF.WcfService { // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码、svc 和配置文件中的类名“BookRestService”。 // 注意: 为了启动 WCF 测试客户端以测试此服务，请在解决方案资源管理器中选择 BookRestService.svc 或 BookRestService.svc.cs，然后开始调试。 public class BookRestService : IBookRestService { Entities db = new Entities(); public Result AddBook(Books book) { Result result = new Result(); try { db.Books.Add(book); db.SaveChanges(); result.Message = string.Format("书名：{0} 已经添加！",book.Name); } catch (Exception ex) { result.Message =ex.Message; } return result; } public List<Books> GetBook(string BookId) { var cateLst = new List<string>(); var cateQry = from d in db.Books orderby d.Category select d.Category; cateLst.AddRange(cateQry.Distinct()); var books = from m in db.Books select m; if (!String.IsNullOrEmpty(BookId)) { books = books.Where(s => s.Name.Contains(BookId)); } List<Books> list = null; list = books.ToList<Books>(); return list; } } }
4. 在配置文件在中配置我们的Rest服务，必须使用WebHttpBehavior对服务的终结点进行配置。
<?xml version="1.0" encoding="utf-8"?> <configuration> <configSections> <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 --> <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework,
Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" /> </configSections> <entityFramework> <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework" /> <providers> <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" /> </providers> </entityFramework> <system.serviceModel> <bindings> <webHttpBinding> <binding name="RestWebBinding"> </binding> </webHttpBinding> </bindings> <behaviors> <serviceBehaviors> <behavior name="metadataBehavior"> <serviceMetadata httpGetEnabled="true" httpGetUrl="http://127.0.0.1:8888/BookService/metadata" /> <serviceDebug includeExceptionDetailInFaults="True" /> </behavior> <behavior name="RestServiceBehavior"> </behavior> </serviceBehaviors> <endpointBehaviors> <behavior name="RestWebBehavior"> <!--这里必须设置--> <webHttp /> </behavior> </endpointBehaviors> </behaviors> <services> <service behaviorConfiguration="metadataBehavior" name="SCF.WcfService.BookService"> <endpoint address="http://127.0.0.1:8888/BookService" binding="wsHttpBinding" contract="SCF.Contracts.IBookService" /> </service> <service name="SCF.WcfService.BookRestService" behaviorConfiguration="RestServiceBehavior"> <endpoint address="http://127.0.0.1:8888/" behaviorConfiguration="RestWebBehavior" binding="webHttpBinding" bindingConfiguration="RestWebBinding" contract="SCF.Contracts.IBookRestService"> </endpoint> </service> </services> </system.serviceModel> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2" /> </startup> <connectionStrings> <add name="Entities" connectionString="metadata=res://*/BookModel.csdl|res://*/BookModel.ssdl|res://*/BookModel.msl;
provider=System.Data.SqlClient;provider connection string="data source=.\SQLEXPRESS;initial catalog=Test;
integrated security=SSPI;MultipleActiveResultSets=True;App=EntityFramework"" providerName="System.Data.EntityClient" /> </connectionStrings> </configuration>
