在某些情境，桌面環境執行的程式(Console、Windows Form、WPF… 等)也需要提供API管道供外界呼叫，例如: 先前提到的Word轉PDF服務、ERP UI接受外部(如Excel VBA)匯入資料... 等等。
設計API管道時有不少選擇: DDE、Anonymous Pipe/Named Pipe、Socket... 都可行。對轉行寫桌面程式的ASP.NET開發者來說，還有一個溫馨的好選擇 -- 在桌面程式專案裡寫ASP.NET Web API吧!!
是的，即使沒有IIS，ASP.NET Web API也能照跑不誤，在Windows Form、WPF可以繼續用同一招打天下，對跨界寫桌面程式的ASP.NET開發人員，實在是一大福音。
以下使用Console Application專案做個簡單示範。建好新專案後，透過NuGet Packages Manager尋找self host，可以找到"Microsoft ASP.NET Web API Self Host"套件，二話不說立刻安裝。
ASP.NET Web API Self Host由多個組件構成，但不用擔心，NuGet會自動一一下載安裝好。
安裝完成後，我們要在主程式中加幾行程式，啟動一個小小的Http Server。
第一步
要先透過HttpSelfHostConfiguratio宣告提供Web API的URL。由於向Windows註冊特定的TCP Port需要權限，有兩種做法: 以管理者身分執行Visual Studio及應用程式，或是透過 netsh http add urlacl url=http://+:port_number/ user=machine\username指令授權。依"永遠只授與足以執行的最小權限"的資安原則，用netsh授權雖然手續較麻煩，但比讓整個應用程式都具有管理者權限安全。
註:
開放授權 netsh http add urlacl url=http://+:32767/ user=machine\username
移除權限 netsh http delete urlacl url=http://+:32767/
接著，使用Routes.MapHttpRoute()指定MVC必備的路由設定，就可使用這組設定值宣告一個HttpSelfHostServer並啟動。由於會動用到網路資源，建議使用using HttpSelfHostServer的寫法，確保結束時會透過Dispose()釋放相關資源。
加上一段迴圈，直到使用者輸入exit才結束HttpSelfHostServer。在這段期間，HttpSelfHostServer便能接收HTTP請求，找到適當的Controller提供服務。
排版顯示純文字
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Http;
using System.Web.Http.SelfHost;
namespace SelfHostWebApi
{
class Program
{
static void Main(string[] args)
{
//指定聆聽的URL
var config = new HttpSelfHostConfiguration("http://localhost:32767");
//注意: 在Vista, Win7/8，預設需以管理者權限執行才能繫結到指定URL，否則要透過以下指令授權
//開放授權 netsh http add urlacl url=http://+:32767/ user=machine\username
//移除權限 netsh http delete urlacl url=http://+:32767/
//設定路由
config.Routes.MapHttpRoute("API", "{controller}/{action}/{id}",
new { id = RouteParameter.Optional });
//設定Self-Host Server，由於會使用到網路資源，用using確保會Dispose()加以釋放
using (var httpServer = new HttpSelfHostServer(config))
{
//OpenAsync()屬非同步呼叫，加上Wait()則等待開啟完成才往下執行
httpServer.OpenAsync().Wait();
Console.WriteLine("Web API host started...");
//輸入exit按Enter結束httpServer
string line = null;
do
{
line = Console.ReadLine();
}
while (line != "exit");
//結束連線
httpServer.CloseAsync().Wait();
}
}
}
}
Console Application專案沒有Models、Controllers、Views資料夾，要如何加入Web API Controller讓人有些茫然，此時讓我們回歸ASP.NET MVC的"Convension over Configuration"(以慣例取代設定)原則: 在專案中新增一個名為BlahController的類別並繼承ApiController，Self Host自然會依著類別名稱認出它，並在有人呼叫http:// localhost:32767/Blah時派它上場。
為了測試，我宣告了一個很沒營養的Date方法傳回日期字串，標註[HttpGet]是為方便用瀏覽器輸入URL就能直接看結果(否則預設只接受POST，需要寫JavaScript才能測試)。
排版顯示純文字
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Http;
namespace SelfHostWebApi
{
public class BlahController : ApiController
{
[HttpGet]
public string Date()
{
return DateTime.Today.ToString("yyyy/MM/dd");
}
}
}
實際執行結果如下:
不會寫Socket、不懂Named Pipe，居然也能寫出具有API整合功能的桌面程式~ 衝著這點，讓我們一起呼喊: ASP.NET Web API 好威呀!
資料來源: http://blog.darkthread.net/post-2013-06-04-self-host-web-api.aspx
第一步
要先透過HttpSelfHostConfiguratio宣告提供Web API的URL。由於向Windows註冊特定的TCP Port需要權限，有兩種做法: 以管理者身分執行Visual Studio及應用程式，或是透過 netsh http add urlacl url=http://+:port_number/ user=machine\username指令授權。依"永遠只授與足以執行的最小權限"的資安原則，用netsh授權雖然手續較麻煩，但比讓整個應用程式都具有管理者權限安全。
註:
開放授權 netsh http add urlacl url=http://+:32767/ user=machine\username移除權限 netsh http delete urlacl url=http://+:32767/
排版顯示純文字
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Http;
using System.Web.Http.SelfHost;
namespace SelfHostWebApi
{
class Program
{
static void Main(string[] args)
{
//指定聆聽的URL
var config = new HttpSelfHostConfiguration("http://localhost:32767");
//注意: 在Vista, Win7/8，預設需以管理者權限執行才能繫結到指定URL，否則要透過以下指令授權
//開放授權 netsh http add urlacl url=http://+:32767/ user=machine\username
//移除權限 netsh http delete urlacl url=http://+:32767/
//設定路由
config.Routes.MapHttpRoute("API", "{controller}/{action}/{id}",
new { id = RouteParameter.Optional });
//設定Self-Host Server，由於會使用到網路資源，用using確保會Dispose()加以釋放
using (var httpServer = new HttpSelfHostServer(config))
{
//OpenAsync()屬非同步呼叫，加上Wait()則等待開啟完成才往下執行
httpServer.OpenAsync().Wait();
Console.WriteLine("Web API host started...");
//輸入exit按Enter結束httpServer
string line = null;
do
{
line = Console.ReadLine();
}
while (line != "exit");
//結束連線
httpServer.CloseAsync().Wait();
}
}
}
}
排版顯示純文字
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Http;
namespace SelfHostWebApi
{
public class BlahController : ApiController
{
[HttpGet]
public string Date()
{
return DateTime.Today.ToString("yyyy/MM/dd");
}
}
}
