當 TODO 應用程式所需的資料結構都定義完成後,下一步就是把服務以「啟用 ASP.NET AJAX 的 WCF 服務」形式開放給用戶端使用。
最直覺的方式是透過 Visual Studio 加入一個啟用 AJAX 的 WCF 服務(.svc)。若選擇自行建立,也可以先新增一個 XML 或文字檔,改名為 ToDOService.svc,再用編輯器寫入 ServiceHost 指令:
<%@ ServiceHost Language="C#" Debug="true" Service="ServiceLibrary.ToDOService" %>
這裡刻意不附帶 CodeBehind 屬性,因為服務的實作放在外部組件(ServiceLibrary)中,.svc 檔只負責宣告要宿主哪一個服務類別。
<system.serviceModel>
<behaviors>
<endpointBehaviors>
<behavior name="ASPNetAJaxBehavior">
<enableWebScript />
</behavior>
<behavior name="WebUI.HelloWorldServiceASPNetAJaxBehavior">
<enableWebScript />
</behavior>
</endpointBehaviors>
</behaviors>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" />
<services>
<service name="ServiceLibrary.ToDOService">
<endpoint behaviorConfiguration="ASPNetAJaxBehavior"
binding="webHttpBinding"
contract="ServiceLibrary.IToDOService" />
</service>
<service name="WebUI.HelloWorldService">
<endpoint address=""
behaviorConfiguration="WebUI.HelloWorldServiceASPNetAJaxBehavior"
binding="webHttpBinding"
contract="WebUI.HelloWorldService" />
</service>
</services>
</system.serviceModel>
enableWebScript 是讓用戶端 JavaScript 得以直接呼叫服務的關鍵。它會產生 JavaScript 代理物件,並要求回應格式為 JSON;缺少這個 behavior,瀏覽器端就拿不到可用的代理。
aspNetCompatibilityEnabled="true" 則是另一個常被忽略的設定。若服務需要用到 ASP.NET 特有的能力,例如 HttpContext、Session 等,就必須開啟這個屬性,讓 WCF 服務能與 ASP.NET 管線整合。反過來說,一旦啟用它,服務就與 ASP.NET 宿主綁定,無法再輕易移到其他宿主環境——這個取捨要在設計階段就想清楚。
設定完成後,在 .svc 檔上按右鍵選擇「在瀏覽器中檢視」。若看到服務的描述頁面,代表宿主已成功;接著就能在前端透過 ScriptManager 的 Services 標籤註冊這個端點,開始以 JavaScript 呼叫服務方法。