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