thrift js javascript C# Csharp webservice

http://www.cnblogs.com/xxxteam/archive/2013/04/15/3023159.html

利用thrift实现js与C#通讯的例子

关键字：thrift js javascript C# Csharp webservice

1.为什么要用thrift js C#？

1.1 首先，js 通过 thrift 访问C#，实际上是一种c/s模式。thrift是通信工具，js是客户端，C#是服务端。

1.2 使用js直接与thrift server通信。让web开发变得更简单。如果使用Web Service，你需要自己去实现C/S两端的序列化与反序列化操作，还需要自行处理异常，降低了开发效率。而thrift则会自动生成两端的操作类，你只需要处理方法内部的逻辑即可。

1.3 js直接与thrift server通信，可以提高性能，并且用C#开发server，开发效率也非常高。（那些web service弱爆了）

1.4 当然，我们不能只看到优点。用这种方法也有比较明显的缺点：如果使用web service，则网页与web service可以封装在一个工程里，部署到IIS上后，可以存在于一个网站内。而使用了thrift后，你还需要手动管理thrift程序。包括：

1.4.1 你需要拥有服务端的绝对控制权，比如，你可以直接登录服务器的操作系统上进行操作。因此，如果你只有一个网页空间，则不适合这种方法。当然，你也可以用web service里绑定thrift，但这样你又需要自己手动进行序列化与反序列操作，而且两次转换让性能更低，有违初衷

1.4.2 给thrift server程序增加自动启动，与监视程序，来完成thrift的崩溃后自动重启。

2.环境

Win7 - VS2012 - .net 4.0 C# 控制台工程（用来承载thrift）

Win7 - VS2012 - .net 4.0 C# Web工程（用来调试js，超方便）

3.步骤（以下步骤，对于小白来说，有些困难。QQ讨论群：23152359 ）

3.1 去thrift官方下载thrift库，目前是0.9.0。

3.2 去thrift官方下载编译好的win下的thrift编译器，是一个exe文件。

3.3 写一个数据结构定义文件。我在这里只是用了服务，没有定义自定义数据结构。

data.txt：

1 service UserStorage
2 {
3     i32 Sum( 1: i32 arg_number1, 2: i32 arg_number2),
4     string GetString()
5 }

3.4 命令行下，用thrift编译器，对它进行编译：
        run.bat：

1 thrift-0.9.0.exe --gen csharp data.txt
2 thrift-0.9.0.exe --gen js data.txt
3 pause

3.5 建立一个名字为CSharpServer的C#控制台工程，.net 4.0的。

3.6 为这个工程，添加现有项目：thrift库目录\thrift-0.9.0\lib\csharp\src\Thrift.csproj，然后引用这个项目。

3.7 把thrift编译出来的UserStorage.cs（在gen-csharp目录里），拖动到解决方案管理器里的CSharpServer项目的根目录下，UserStorage.cs与Program.cs应该在同一级。

3.8 在CSharpServer项目里创建一个UserStorage的处理类UserStorageHandle.cs：（它应该与UserStorage.cs与Program.cs在同一级）

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5
 6 namespace CSharpServer
 7 {
 8     public class UserStorageHandle : UserStorage.Iface
 9     {
10
11         public UserStorageHandle()
12         {
13             ;
14         }
15
16         public int Sum(int arg_number1, int arg_number2)
17         {
18             int result = arg_number1 + arg_number2;
19             Console.WriteLine(DateTime.Now.ToString() + " 收到请求：Sum，参数：arg_number1 = " + arg_number1.ToString() + "，arg_number2 = " + arg_number2.ToString() + "，返回：result = " + result.ToString());
20             return result;
21         }
22
23         private static int Counter = 0;
24
25         public string GetString()
26         {
27             int currentCounter = System.Threading.Interlocked.Increment(ref UserStorageHandle.Counter);
28             Console.WriteLine(DateTime.Now.ToString() + " 收到请求：GetString，参数：没有，返回：result = \"thrift is OK : " + currentCounter.ToString() + "\"");
29             return "thrift is OK : " + currentCounter.ToString();
30         }
31
32     }
33 }

3.9 主程序Program.cs：

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 using Thrift.Transport;
 6 using Thrift.Protocol;
 7 using Thrift.Server;
 8 using System.Net;
 9
10 namespace CSharpServer
11 {
12     class Program
13     {
14         private static HttpListener httpListener = null;
15         private static THttpHandler httpServer = null;
16
17         static void Main(string[] args)
18         {
19             string serviceUrl = "http://localhost:99/";
20             try
21             {
22                 UserStorageHandle handle = new UserStorageHandle();
23                 UserStorage.Processor processor = new UserStorage.Processor(handle);
24                 TProtocolFactory protocolFactory = new TJSONProtocol.Factory();
25
26                 Program.httpServer = new THttpHandler(processor, protocolFactory);
27
28                 Program.httpListener = new HttpListener();
29                 Program.httpListener.Prefixes.Add(serviceUrl);
30                 Program.httpListener.Start();
31                 IAsyncResult result = Program.httpListener.BeginGetContext(new AsyncCallback(WebRequestCallback), null);
32                 Console.WriteLine("Thrift 服务成功启动，网址是 " + serviceUrl);
33             }
34             catch (System.Exception ex)
35             {
36                 Console.WriteLine("发生错误：" + ex.Message);
37                 Console.WriteLine("按回车键退出");
38                 Console.ReadLine();
39                 return;
40             }
41             Console.WriteLine("若需结束程序，请直接关闭窗口，或按回车。");
42             Console.ReadLine();
43         }
44
45         public static void WebRequestCallback(IAsyncResult result)
46         {
47             if (Program.httpListener == null)
48             {
49                 Console.WriteLine("发生错误：HttpListener已经被关闭");
50                 Console.WriteLine("按回车键退出");
51                 Console.ReadLine();
52                 return;
53             }
54
55             HttpListenerContext httpListenerContext = Program.httpListener.EndGetContext(result);
56
57             Program.httpListener.BeginGetContext(new AsyncCallback(WebRequestCallback), null);
58
59             Program.httpServer.ProcessRequest(httpListenerContext);
60         }
61
62     }
63 }

3.10 按F5，启动CSharpServer项目。

3.11 新开一个VS2012（内存不够的赶快去买），建立一个叫JsProject的C# .net 4.0 Web空工程。

3.12 去jquery官网下载jquery-1.9.1.js（mini版也行，随便）

3.13 把thrift编译的js文件data_types.js与UserStorage.js，thrift库的js库文件（thrift库目录\thrift-0.9.0\lib\js\thrift.js），以及刚下载的jq文件jquery-1.9.1.js，全部拖动到解决方案资源管理器的JsProject项目的根目录下：

data_types.js \ jquery-1.9.1.js \ thrift.js \ UserStorage.js 应该与Web.config在同一级。

3.14 在根目录下创建一个Test.html文件，Test.html 应该与Web.config在同一级：

Test.html：

 1 <!DOCTYPE html>
 2 <html xmlns="http://www.w3.org/1999/xhtml">
 3 <head>
 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
 5     <title></title>
 6     <script type="text/javascript" src="jquery-1.9.1.js"></script>
 7     <script type="text/javascript" src="data_types.js"></script>
 8     <script type="text/javascript" src="thrift.js"></script>
 9     <script type="text/javascript" src="UserStorage.js"></script>
10
11     <script>
12         $(document).ready(function ()
13         {
14             var debugPosation = 0;
15             try
16             {
17                 var transport = new Thrift.Transport("http://localhost:99");
18                 var protocol = new Thrift.Protocol(transport);
19                 var client = new UserStorageClient(protocol);
20
21                 var result_GetString = client.GetString();
22                 var result_Sum = client.Sum(255, 322);
23             }
24             catch (e)
25             {
26                 alert("出错鸟：" + e.message);
27             }
28         });
29     </script>
30 </head>
31 <body>
32 </body>
33 </html>

3.15 给Test.html的 “ var debugPosation = 0; ” 这一行，下断点，然后F5，就可以看到效果了。

4.注意两个问题

4.1 由于web服务一般都是80端口，如果thrift端口与其不同，js在访问时会遇到跨域问题，js报错e.message = "拒绝访问"。但是，对于传说中的windows server，完全没有问题，因为，windows server支持.net的传说中的端口复用功能！因此，假设部署后，网站的iis的url为：http://www.baidu.com/XXX，则你最好给thrift server留一个二级域名，比如 http://www.baidu.com/ThriftService ，把这个留给thrift。最后，直接把thrift server的监听url，设置为这个 http://www.baidu.com/ThriftService 就OK了，不会有端口冲突问题，因为win Server + .net 支持tcp端口复用！！！！ 如果你的网站的url还带有端口，比如 http://www.baidu.com:9999/XXX，或者IP形式：http://11.2.33.44:9999/XXX，则thriftservice也需要与它的端口相同，比如：http://www.baidu:9999/ThriftService 或 http://11.2.33.44:9999/ThriftService 。问，网站端口与thriftserver端口并不是80，而是9999，有没有问题？答：木有问题，端口复用功能依然会发挥作用。不过，端口复用技术，是通过让IIS和ThriftServer，把端口监听的工作，都交给System.exe去做，所有如果要做防火墙，要注意一下。防火墙参见这个帖子：http://www.cnblogs.com/xxxteam/archive/2013/04/22/3036082.html

4.2 网址的最后一个斜杠问题。js访问thrift service，网址最后一个字符，是不带斜杠的。比如http://www.baidu.com/XXX/，这个就是错误的，因为最后一个是斜杠。应该去掉最后一个斜杠，更正为： http://www.baidu.com/XXX  。而ThriftServer的监听网址，则最后一个斜杠是不能省去的。坑爹吧？当然了，这个问题可能会因为日后的补丁被修正，所以大家自己留意一下。

5.为什么不能使用js + thrift server方案？

看到这里傻眼了吧？上面白忙活大半天，但最后居然发现这个方案有问题？是的。

5.1 Thrift的定义，仅仅是一个通信工具，它不是能7*24运行的类似于iis这种服务提供程序。相对于wcf来说，thrift简单，所以高效。但正是因为它简单，所以它缺少很多在复杂网络环境下充当服务端的功能。在实际使用中，如果把它当成webService Server，则经常出问题。而且很多问题是try catch也抓不住，直接导致宿主程序崩溃的。所以，如果希望构建一个稳定的webService server，还是使用wcf之类的稳定方案为妙。

不过，这并不是说thrift就不行。thrift可以在系统内部来进行数据传输，但绝对不能放在外部。

5.2 js + thrift不支持异步调用！原因是，js只有以ajax方式进行远程服务调用才具有异步功能，但thrift封装的远程服务调用，不是ajax方式的。

其他更多问题详见 http://www.cnblogs.com/xxxteam/archive/2013/04/24/3040839.html

 

分类: C#