具有 JSON 和 XML 的 AJAX 服务示例

项目
09/12/2008

此示例演示如何使用 Windows Communication Foundation (WCF) 来创建异步 JavaScript 和 XML (AJAX) 服务，该服务返回 JavaScript 对象表示法 (JSON) 或 XML 数据。可以从 Web 浏览器客户端使用 JavaScript 代码来访问 AJAX 服务。此示例是基于基本 AJAX 服务示例生成的。

提示

此示例需要安装 .NET Framework 3.5 版才能生成和运行。若要打开项目和解决方案文件，需要使用 Visual Studio 2008。

与其他 AJAX 示例不同的是，此示例不使用 ASP.NET AJAX 和 ScriptManager 控件。在某个其他配置下，WCF AJAX 服务可以从任何 HTML 页面通过 JavaScript 来访问，此处对该方案进行了演示。有关将 WCF 与 ASP.NET AJAX 一起使用的示例，请参见 AJAX 示例。

此示例演示如何在 JSON 和 XML 之间切换操作的响应类型。无论服务是配置为由 ASP.NET AJAX 访问还是由 HTML/JavaScript 客户端页面访问，此功能均可用。

提示

本主题的末尾介绍了此示例的设置过程和生成说明。

为了允许使用非 ASP.NET 客户端，此示例使用下面的配置节。

<system.serviceModel>
     <behaviors>
          <endpointBehaviors>
               <behavior name="Microsoft.Ajax.Samples.CalculatorServiceAjaxBehavior">
                    <webHttp/>
               </behavior>
          </endpointBehaviors>
     </behaviors>
     <services>
          <service name="Microsoft.Ajax.Samples.CalculatorService">
               <endpoint address="ajaxEndpoint" behaviorConfiguration="Microsoft.Ajax.Samples.CalculatorServiceAjaxBehavior" binding="webHttpBinding" contract="Microsoft.Ajax.Samples.ICalculator" />
          </service>
     </services>
</system.serviceModel>

请注意，使用的是 <webHttp> 行为，而不是 <enableWebScript> 行为。webHttp 行为的默认数据格式是 XML，而 enableWebScript 行为的默认数据格式是 JSON。有关 webHttp 行为细节的更多信息，请参见Creating WCF AJAX Services without ASP.NET。

以下示例中的服务是一个标准的 WCF 服务，它具有两个操作。这两个操作都需要针对 WebGetAttribute 或 WebInvokeAttribute 属性使用 Wrapped 正文样式，该样式特定于 webHttp 行为，对于 JSON/XML 数据格式开关没有任何影响。

[OperationContract]
[WebInvoke(ResponseFormat = WebMessageFormat.Xml, BodyStyle = WebMessageBodyStyle.Wrapped)]
MathResult DoMathXml(double n1, double n2);

操作的响应格式被指定为 XML，这是 <webHttp> 行为的默认设置。但是，最好显式指定响应格式。

另一个操作使用 WebInvokeAttribute 属性并显式指定响应的 JSON（而不是 XML）。

[OperationContract]
[WebInvoke(ResponseFormat = WebMessageFormat.Json, BodyStyle = WebMessageBodyStyle.Wrapped)]
MathResult DoMathJson(double n1, double n2);

请注意，在这两种情况下，操作均返回一个复杂类型 MathResult，该类型是一个标准的 WCF 数据协定类型。

客户端网页 XmlAjaxClientPage.htm 包含 JavaScript 代码，当用户单击页面上的**“Perform calculation (return JSON)”（执行计算(返回 JSON)）或“Perform calculation (return XML)”（执行计算(返回 XML)）**按钮时，该代码会调用上面的两个操作之一。用来调用服务的代码将构造 JSON 正文并使用 HTTP POST 发送它。请求是用 JavaScript 手动创建的，这与基本 AJAX 服务示例和使用 ASP.NET AJAX 的其他示例不同。

// Create HTTP request
var xmlHttp;
// Request instantiation code omitted…
// Result handler code omitted…

// Build the operation URL
var url = "service.svc/ajaxEndpoint/";
url = url + operation;

// Build the body of the JSON message
var body = '{"n1":';
body = body + document.getElementById("num1").value + ',"n2":';
body = body + document.getElementById("num2").value + '}';
  
// Send the HTTP request
xmlHttp.open("POST", url, true);
xmlHttp.setRequestHeader("Content-type", "application/json");
xmlHttp.send(body);

当服务进行响应时，响应将显示出来，而不会在页面上的文本框中进一步执行任何处理。这是为了进行演示而实现的，您可以直接遵循所使用的 XML 和 JSON 数据格式。

// Create result handler 
xmlHttp.onreadystatechange=function(){
     if(xmlHttp.readyState == 4){
          document.getElementById("result").value = xmlHttp.responseText;
     }
}

设置、生成和运行示例

请确保已经执行了 Windows Communication Foundation 示例的一次性安装过程。
按照生成 Windows Communication Foundation 示例中的说明生成解决方案 XmlAjaxService.sln。
定位到 https://localhost/ServiceModelSamples/XmlAjaxClientPage.htm（不要在浏览器中从项目目录中打开 XmlAjaxClientPage.htm）。

另请参见

任务

使用 HTTP POST 的 AJAX 服务

通过

具有 JSON 和 XML 的 AJAX 服务示例

设置、生成和运行示例

另请参见

任务

其他资源