[经验] - JQuery.Ajax + 跨域 (crossDomain) + POST + JSON + WCF RESTful, 5大陷阱和解决方案

最近在开发WSS RESTful服务的时候, 碰到了这些个纠结的问题. 在网上查找了半天, 找到n多种解决方案, 但是都是部分的, 要么是没有跨域的情况, 要么是没有post的情况, 要么不是用WCF进行开发. 可就是没有一个解决方案是将所有元素揉合在一起的, 真是奇怪, 然道我研究的是小众?

呵呵, 闲话少说, 直接上陷阱和解决方案:

1. UriTemplate要和<endpointBehaviros><behavior><webHttp>配合使用

用WCF开发REST就不用多说了. 唯一需要注意的是如果使用了UriTemplate来定义REST接口地址, 那么EndpointBehavior不能够继续使用<enableWebScript/>了, 而要改成使用<webHttp/>, 对应的, 在<service><endpoint>中behaviorConfiguration也要设置成WebBehavior.

<endpointBehaviors>
<!--<behavior name="AjaxBehavior">
<enableWebScript/>
</behavior>-->
<behavior name="WebBehavior">
<webHttp />
</behavior>
</endpointBehaviors>

2. 为WebOperation指定输入输出的格式

由于使用了webHttp behavior, 我们需要在ServiceContract中显示指定WebOperation的输入输出msg格式. 否则会在运行时报错找不到对应的序列化反序列化器.

[OperationContract(Name="CreateNew")]
[WebInvoke(RequestFormat=WebMessageFormat.Json, ResponseFormat=WebMessageFormat.Json, UriTemplate="/users", Method="POST")]
string CreateNew(WSSAccount account);

3. 为了满足JQuery.Ajax, 需要改造WCF RESTful service

这一步困扰了我好久, JQuery.Ajax在POST的时候是没法设置ContentType的. 网上好多人讨论这个问题, 我想应该是一个bug或者至少是一个设计的限制. 整体表现就是设置了没有任何效果. 在这种情况下去调用WCF写的RESTful Service就坑爹了. 因为JQuery.Ajax在POST的时候永远将contentType设置成application/x-www-unencoded; 而WCF默认的ContentTypeMapper永远只在收到ContentType=application/json的时候才会用JSON来解析Body中的数据...

没办法了, 只有改写ContentTypeMapper:

public class RESTContentTypeMapper : WebContentTypeMapper
{
public override WebContentFormat GetMessageFormatForContentType(string contentType)
{
if (contentType.IndexOf("json", StringComparison.CurrentCultureIgnoreCase) != -1)
{return WebContentFormat.Json;
}
else if (contentType.IndexOf("xml", StringComparison.CurrentCultureIgnoreCase) != -1)
{return WebContentFormat.Xml;
}
else
{return WebContentFormat.Json;
}
}
}

强行将WebContentFormat.Json作为默认格式, 然后在<system.serviceModel><standardEndpoints>中配置如下:

<standardEndpoints>
<webHttpEndpoint>
<standardEndpoint name="RESTEndpoint" contentTypeMapper="Webus.WSS.Core.RESTful.RESTContentTypeMapper, Core" />
</webHttpEndpoint>
</standardEndpoints>

注意, 这个standardEndpoints只在.net4.0/4.5中才有效, 如果你用的老版本, 那还是算了吧. 配置好了之后, 在<service><endpoint>中endpointConfiguration要设置成"RESTEndpoint", kind要设置成"webHttpEndpoint".

下面来一个完整的配置例子:

<system.serviceModel>
<services>
<service name="s_Authentication" behaviorConfiguration="DefaultBehavior">
<host>
<baseAddresses>
<add baseAddress="http://wss.gdtsearch.com/wss/services/test.Authentication" />
</baseAddresses>
</host>
<endpoint name="Authentication_Web"
address="Authentication_Web"
binding="webHttpBinding"
bindingConfiguration="webHttpBindingJSONP"
contract="Webus.WSS.Core.Authentication.IWSSAuthentication"
behaviorConfiguration="WebBehavior"
endpointConfiguration="RESTEndpoint"
kind="webHttpEndpoint"
bindingNamespace="http://gdtsearch.com/wss/services/Authentication" />
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" />
</service>
</services>
<standardEndpoints>
<webHttpEndpoint>
<standardEndpoint name="RESTEndpoint" contentTypeMapper="Webus.WSS.Core.RESTful.RESTContentTypeMapper, Core" />
</webHttpEndpoint>
</standardEndpoints>

<behaviors>
<endpointBehaviors>
<!--<behavior name="AjaxBehavior">
<enableWebScript/>
</behavior>-->
<behavior name="WebBehavior">
<webHttp />
</behavior>
</endpointBehaviors>
<serviceBehaviors>
<behavior name="DefaultBehavior">
<serviceMetadata httpGetEnabled="True"/>
<serviceDebug includeExceptionDetailInFaults="True"/>
</behavior>
</serviceBehaviors>
</behaviors>

<bindings>
<webHttpBinding>
<binding name="webHttpBindingJSONP" crossDomainScriptAccessEnabled="true"/>
</webHttpBinding>
</bindings>
</system.serviceModel>

View Code

4. JQuery.Ajax - crossDomain要设置为true / post的数据要首先转换成JSON格式

我用于POST数据的代码如下, 却总是得到一个HTTP400的错误, 打开Fiddler一看, 发现Body中的数据根本不是JSON格式, 而是普通的类似于querystring中的name-Value组合的字符串.

function createNewAccount(email, password) {var account = {
"Email": email,
"Password": CryptoJS.MD5(password).toString(CryptoJS.enc.Base64),
"Enabled": true
};

$.ajax({
type: "POST",
crossDomain: true,
url: "http://wss.gdtsearch.com/wss/services/test.Authentication/Authentication_Web/users",
data: account,
dataType: "json",
success: function(msg) {
alert(msg);
},
error: function(a, b, c) {
alert(a + b + c);
}
});
}

没办法, 只好手动将数据转换成JSON了, 好在我找到了一个不错的plugin: https://code.google.com/p/jquery-json/. 代码简单改改就能够用了:

$.ajax({
type: "POST",
crossDomain: true,
url: "http://wss.gdtsearch.com/wss/services/test.Authentication/Authentication_Web/users",
data: $.toJSON(account),
dataType: "json",
success: function(msg) {
alert(msg);
},
error: function(a, b, c) {
alert(a + b + c);
}
});

5. JQuery.ajax的跨域只支持XMLHTTPRequest

一切就绪之后, 终于可以开始测试了. 打开Chrome, 打开Fiddler, 访问页面, 点击按钮运行,,, ,,, ,,, 浏览器貌似正常, Fiddler得到一个HTTP200~! 唯一的遗憾是Chrome的Console会出现一个跨域的JS错误. 看来通过设置crossDomain=true确实可以进行跨域访问, 但是并不完美.

打开IE, 再次测试,,, 报错!? Fiddler中没有任何反应, 甚至连Request都没有发出去, 奇怪? googling... 答案在StackOverflow的一篇文章中找到: http://stackoverflow.com/questions/3362474/jquery-ajax-fails-in-ie-on-cross-domain-calls

OTOH, this page mentions that IE7 and eariler cannot do cross domain calls, but IE8 can, using a different object than XMLHttpRequest, the one JQuery uses. Could you check if XDomainRequest works?

也就是说IE8用的所谓XDomainRequest而非XMLHttpRequest, 但是JQuery只支持XMLHttpRequest... 所以想用IE的同学就断了这个念想吧...

小结 -

研究了两天, 总算将JQuery.Ajax + crossDomain + POST + JSON + WCF RESTful 串起来跑通了, 可是也只能够在Chrome上面跑, FF和Safari没有试, 但是我估计能够行. 硬伤是IE不行, 没想到是这么个结果, 太遗憾了. 不过要实现功能, 也并非无路可走, 关键还是要看你在ServiceContract中要不要用UriTemplate, 如果你能够放弃自己设计RESTful接口的主张, 全盘接受微软的一套, 那么简单用<enableWebScript>+JSONP就行啦; 如果你坚持自己设计RESTful接口, 不妨考虑用NodeJS搭建一个本地的proxy svc来解决跨域的问题. 反正仁者见仁, 智者见智, 动手能力强的TX们自己取舍吧.