构建基于WCF Restful Service的服务
前言html
传统的Asmx服务，因为遵循SOAP协议，因此返回内容以xml方式组织。而且客户端须要添加服务端引用才能使用（虽然看到网络上已经提供了这方面的Dynamic Proxy，可是没有这种方式简便），因此给开发和部署带来了不小的麻烦。而且当服务过多的时候，生成的引用文件会很大，以前项目的一个引用文件光引用代码都有5000多行，所有在一个类中。确实不方便维护。json
基于以上几点，就特别研究了一下基于Restful的服务开发，当时手头有两种框架，一个是WCF Restful Service，另外一个是Asp.net Web API。因为对WCF比较熟悉一些，因此就选择了前者。设计模式
Restful Service及其相关网络
说到Restful Service，不得不提到其中的Rest这个关键字。它是用于建立分布式超文本媒体的一种架构方式，咱们能够经过标准的HTTP（GET，POST，PUT，DELETE）操做来构建基于面向资源的软件架构方式（Resource-Oriented Architecture (ROA)）。它是独立于任何技术或者平台的，因此人们常常将符合这种操做规范的服务称为“RESTful services”。由于WCF可以构建符合这种规范的服务，因此咱们常常称之为 WCF Restful Services。架构
因为传统的WCF Service可使用tcp,net.msmq,http等协议进行数据交换，而且采用了RPC（Remote Procedure Call）的工做方式，客户端须要添加对服务端的引用才能完成。可是WCF Restful Service彻底使用Http协议来进行，而且无需添加客户端引用，因此方便不少。app
服务端开发一瞥框架
下面以图书馆的例子来作具体的说明。less
打开VS2010，新建一个WCF REST Service Application项目，而后在项目中，添加一个BookService.cs用于处理逻辑操做，再添加一个BookEntity.cs用于提供实体类。异步
打开Global.asax，能够看到以下代码：tcp
1: void Application_Start(object sender, EventArgs e)
2: {
3: RegisterRoutes();
4: }
5:
6: private void RegisterRoutes()
7: {
8: RouteTable.Routes.Add(new ServiceRoute("BookService", new WebServiceHostFactory(), typeof(BookService)));
9: }
其中RegisterRoutes是设定服务启动的入口点的。
而后是BookEntity实体类的组织方式：
1: public class BookEntity
2: {
3: public int BookID { get; set; }
4:
5: public string BookName { get; set; }
6:
7: public decimal BookPrice { get; set; }
8:
9: public string BookPublish { get; set; }
10: }
这里我就不用多说了，实体类包含图书序号，图书名称，图书价格，出版单位四个属性。
而后就是咱们的核心内容：
1: [ServiceContract]
2: [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]
3: [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
4: public class BookService
5: {
6: public BookService()
7: {
8: bookList = new List<BookEntity>();
9: BookEntity book = new BookEntity();
10: book.BookID = 1;
11: book.BookName = "大话设计模式";
12: book.BookPrice = (decimal)45.2;
13: book.BookPublish = "中国邮电出版社";
14: bookList.Add(book);
15:
16: BookEntity book1 = new BookEntity();
17: book1.BookID = 2;
18: book1.BookName = "测试用例";
19: book1.BookPrice = (decimal)21.0;
20: book1.BookPublish = "清华大学出版社";
21: bookList.Add(book1);
22:
23: BookEntity book2 = new BookEntity();
24: book2.BookID = 3;
25: book2.BookName = "Rework";
26: book2.BookPrice = (decimal)15.4;
27: book2.BookPublish = "Wrox pulishment";
28: bookList.Add(book2);
29: }
30:
31: private static List<BookEntity> bookList;
32:
33: [WebInvoke(Method = "GET"
34: , ResponseFormat = WebMessageFormat.Json
35: , BodyStyle = WebMessageBodyStyle.Bare //不须要任何修饰，不然生成的json没法解析
36: , UriTemplate = "/?bookID={bookID}")] //只接收string类型，若是是其余类型，须要按照 /?para={parameter}的方式来组织。
37: public BookEntity Get(int bookID)
38: {
39: return bookList.Where(p => p.BookID == bookID).FirstOrDefault();
40: }
41:
42: [WebInvoke(Method = "GET"
43: , ResponseFormat = WebMessageFormat.Json
44: , BodyStyle = WebMessageBodyStyle.Bare
45: , UriTemplate = "/")]
46: public List<BookEntity> GetALL()
47: {
48: return bookList;
49: }
50:
51: [WebInvoke(Method = "POST"
52: , ResponseFormat = WebMessageFormat.Json
53: , BodyStyle = WebMessageBodyStyle.Bare
54: , UriTemplate = "/")]
55: public bool Update(BookEntity book)
56: {
57: BookEntity query = (from p in bookList where p.BookID == book.BookID select p).FirstOrDefault();
58: bookList.Remove(query);
59: bookList.Add(book);
60: return true;
61: }
62:
63: [WebInvoke(Method = "PUT"
64: , ResponseFormat = WebMessageFormat.Json
65: , BodyStyle = WebMessageBodyStyle.Bare
66: , UriTemplate = "/")]
67: public bool Add(BookEntity book)
68: {
69: bookList.Add(book);
70: return true;
71: }
72:
73: [WebInvoke(Method = "DELETE"
74: , ResponseFormat = WebMessageFormat.Json
75: , BodyStyle = WebMessageBodyStyle.Bare
76: , UriTemplate = "/")]
77: public bool Delete(BookEntity book)
78: {
79: BookEntity bookCurrent = (from p in bookList where p.BookID == book.BookID select p).FirstOrDefault();
80: return bookList.Remove(bookCurrent);
81: }
82: }
其中，Method 方法主要是代表能够接受客户端的请求类型，这里有四种：GET，POST，PUT，DELETE，其中GET为请求数据，POST为更新数据，PUT为新增数据，DELETE表明着删除数据。
而后ResponseFormat 则表明着返回的数据组织，若是是Json则代表客户端会接收到Json数据，若是是XML则代表客户端会接收到XML组织的数据。BodyStyle 表明返回数据的包装对象，若是是Bare则代表数据无任何包装，原生数据返回；若是是Wrapped则代表数据会在最外层包装一个当前函数名称加上Result的套。好比对于Delete对象，则会返回 DeleteResult:{******}，会形成DataContractJsonSerializer没法进行反序列化。
UriTemplate 主要用于指定操做的URI路径，只要用户输入了合法路径并采用了正确的请求方式，就会触发该函数。
最后说到的就是URI后面跟的参数的问题，因为函数只能接受string类型的，因此若是传入参数是string类型，则可使用UriTemplate = "{bookID}"的路径，反之，则须要加上/?param1={paramname}的方式，好比我代码中使用的是：UriTemplate = "/?bookID={bookID}"。
当一切都弄好之后，让咱们运行一下，访问以下路径，就能够获得结果：
http://localhost:45345/BookService/
获得的结果以下：
[{"BookID":1,"BookName":"大话设计模式","BookPrice":45.2,"BookPublish":"中国邮电出版社"},{"BookID":2,"BookName":"测试用例","BookPrice":21,"BookPublish":"清华大学出版社"},{"BookID":3,"BookName":"Rework","BookPrice":15.4,"BookPublish":"Wrox pulishment"}]
若是访问http://localhost:45345/BookService/?bookID=1，则会获得以下的结果:
{"BookID":1,"BookName":"大话设计模式","BookPrice":45.2,"BookPublish":"中国邮电出版社"}
客户端开发一瞥
初步测试成功后，让咱们来进行一下全面的测试。
首先，在项目中，咱们新建一个Asp.net WebForm Application，用于作测试工做。
而后，在Default.aspx.cs中，针对GET操做，咱们添加以下代码：
1: private void GetBookByID(string id)
2: {
3: WebClient proxy = new WebClient();
4: string serviceURL = string.Empty;
5: DataContractJsonSerializer obj ;
6: if (string.IsNullOrEmpty(id))
7: {
8: serviceURL = string.Format("http://localhost:45345/BookService/");
9: obj = new DataContractJsonSerializer(typeof(List<BookEntity>));
10: }
11: else
12: {
13: serviceURL = string.Format("http://localhost:45345/BookService/?bookID=" + id);
14: obj = new DataContractJsonSerializer(typeof(BookEntity));
15: }
16: byte[] data = proxy.DownloadData(serviceURL);
17: Stream stream = new MemoryStream(data);
18: var result = obj.ReadObject(stream);
19: List<BookEntity> list=new List<BookEntity>();
20: if (result is BookEntity)
21: list.Add(result as BookEntity);
22: else if (result is List<BookEntity>)
23: list = result as List<BookEntity>;
24: GridView1.DataSource = list;
25: GridView1.DataBind();
26: }
在以上代码中，DataContractJsonSerializer 是WCF提供的一个序列化类，用于将对象序列化或者反序列化。
写好以后，咱们点击界面按钮，出现了如下的结果：
针对PUT操做，也就是添加操做，咱们添加以下代码：
1: BookEntity bookEntity = new BookEntity();
2: bookEntity.BookID = Int32.Parse(txtBookID.Text);
3: bookEntity.BookName = txtBookName.Text;
4: bookEntity.BookPrice = decimal.Parse(txtBookPrice.Text);
5: bookEntity.BookPublish = txtBookPublish.Text;
6:
7: DataContractJsonSerializer obj = new DataContractJsonSerializer(typeof(BookEntity));
8: MemoryStream ms = new MemoryStream();
9: obj.WriteObject(ms, bookEntity);
10: byte[] byteSend = ms.ToArray();
11: ms.Close();
12:
13: string serviceURL = string.Format("http://localhost:45345/BookService");
14:
15: WebClient test = new WebClient();
16: test.Headers.Add("Content-Type", "application/json");
17: test.Headers.Add("ContentLength", byteSend.Length.ToString());
18:
19:
20: byte[] responseData = test.UploadData(serviceURL, "PUT", byteSend);
21:
22: string result = Encoding.GetEncoding("UTF-8").GetString(responseData);
23: lblLog.Text = result;
在作这步的时候，须要注意，test.Headers.Add("Content-Type", "application/json") 和test.Headers.Add("ContentLength", byteSend.Length.ToString())须要添加，不然会形成Http 400 返回的错误。而且，向服务端传递实体的时候，能够经过使用UploadData的方式来进行，若是数据量过大，能够考虑使用异步方式传送。
接下来的POST和DELETE方法和上面相似，我都贴一下：
POST方法：
1: BookEntity bookEntity = new BookEntity();
2: bookEntity.BookID = Int32.Parse(txtBookID.Text);
3: bookEntity.BookName = txtBookName.Text;
4: bookEntity.BookPrice = decimal.Parse(txtBookPrice.Text);
5: bookEntity.BookPublish = txtBookPublish.Text;
6:
7: DataContractJsonSerializer obj = new DataContractJsonSerializer(typeof(BookEntity));
8: MemoryStream ms = new MemoryStream();
9: obj.WriteObject(ms, bookEntity);
10: byte[] byteSend = ms.ToArray();
11: ms.Close();
12:
13: string serviceURL = string.Format("http://localhost:45345/BookService");
14:
15: WebClient test = new WebClient();
16: test.Headers.Add("Content-Type", "application/json");
17: test.Headers.Add("ContentLength", byteSend.Length.ToString());
18:
19: byte[] responseData = test.UploadData(serviceURL, "POST", byteSend);
20:
21: string result = Encoding.GetEncoding("UTF-8").GetString(responseData);
22: lblLog.Text = result;
DELETE方法：
1: BookEntity bookEntity = new BookEntity();
2: bookEntity.BookID = Int32.Parse(txtBookID.Text);
3:
4: DataContractJsonSerializer obj = new DataContractJsonSerializer(typeof(BookEntity));
5: MemoryStream ms = new MemoryStream();
6: obj.WriteObject(ms, bookEntity);
7: byte[] byteSend = ms.ToArray();
8: ms.Close();
9:
10: string serviceURL = string.Format("http://localhost:45345/BookService");
11:
12: WebClient test = new WebClient();
13: test.Headers.Add("Content-Type", "application/json");
14: test.Headers.Add("ContentLength", byteSend.Length.ToString());
15:
16:
17: byte[] responseData = test.UploadData(serviceURL, "DELETE", byteSend);
18:
19: string result = Encoding.GetEncoding("UTF-8").GetString(responseData);
20: lblLog.Text = result;
最后获得的效果图以下：
（新增记录）
（更新记录）
（删除记录）
成文仓促，不免有误，还请指出，在此谢过。
源代码下载
Edit：基于本方法构建的Android服务已经在使用中。后续继续跟进各类使用信息。
在StackOverFlow问答以下：点击这里查看
看评论中提到了IContract问题，因为这是Restful Service，不是基于RPC模式，因此不必使用的。不过用上去也没错。
- 1. WCF Restful Service
- 2. WCF4.0 -- RESTful WCF Services(创建基于SSL的服务)
- 3. GraphQL-Basedon-RESTful：基于 RESTful API 的 GraphQL 服务构建
- 4. 利用WCF建立简单的RESTFul Service
- 5. 构建RESTful Web Service
- 6. 如何建立一个RESTful WCF Service
- 7. 如何创建一个RESTful WCF Service
- 8. Practical guide to WCF RESTful service
- 9. WCF Restful Service Get / Post请求
- 10. iPhone中调用WCF RESTFUL Service
- 更多相关文章...
- • Git 服务器搭建 - Git 教程
- • 服务器上的 XML - XML 教程
- • ☆基于Java Instrument的Agent实现
- • Spring Cloud 微服务实战(三) - 服务注册与发现
-
每一个你不满意的现在，都有一个你没有努力的曾经。
- 1. WCF Restful Service
- 2. WCF4.0 -- RESTful WCF Services(创建基于SSL的服务)
- 3. GraphQL-Basedon-RESTful：基于 RESTful API 的 GraphQL 服务构建
- 4. 利用WCF建立简单的RESTFul Service
- 5. 构建RESTful Web Service
- 6. 如何建立一个RESTful WCF Service
- 7. 如何创建一个RESTful WCF Service
- 8. Practical guide to WCF RESTful service
- 9. WCF Restful Service Get / Post请求
- 10. iPhone中调用WCF RESTFUL Service