ASP.Net MVC Web API
ASP.NET Web API是一個框架,可以輕鬆構建到達各種客戶端(包括瀏覽器和移動設備)的HTTP服務。ASP.NET Web API是在.NET Framework上構建RESTful應用程序的理想平臺。
當要Web上構建API時,可以通過多種方式在Web上構建API。 這些包括HTTP/RPC
,這意味着在遠程過程調用中使用HTTP來通過Web調用諸如方法之類的東西。
這些動詞本身包含在API中,例如:獲取客戶,插入發票,刪除客戶,並且每個這些端點最終都是一個單獨的URI。
下面通過創建一個新的ASP.NET Web應用程序來看看如何構造一個簡單的Web API示例。
第1步 - 打開Visual Studio,然後單擊:文件 -> 新建 -> 項目 菜單選項。
一個新的項目對話框打開。如下圖所示 -
第2步 - 在左側窗格中,選擇:模板 -> Visual C# -> Web 。
第3步 - 在中間窗格中,選擇「ASP.NET Web應用程序」,在名稱字段中輸入項目名稱:WebAPIDemo ,然後單擊確定 以繼續。將看到以下對話框,要求您爲ASP.NET項目設置初始內容。如下圖所示 -
第4步 - 爲了簡單起見,請選擇: 空 選項,並在「爲以下項添加文件夾和核心引用」 部分中選中Web API 複選框,然後單擊 確定 。
第5步 - 它將創建一個基本的MVC項目與最小的預定義的內容。
項目由Visual Studio創建後,在「解決方案資源管理器」窗口中看到許多文件和文件夾。
第6步 - 現在需要添加一個模型。右鍵單擊解決方案資源管理器 中的Models 文件夾,然後選擇:添加 -> 類。將看到添加新項目對話框。
第7步 - 選擇中間平臺的類,並在名稱字段中輸入Employee.cs
。
第8步 - 使用下面的代碼將一些屬性添加到Employee
類。代碼如下所示 -
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
namespace WebAPIDemo.Models
{
public class Employee
{
public int ID { get; set; }
public string Name { get; set; }
public DateTime JoiningDate { get; set; }
public int Age { get; set; }
}
}
第9步 - 添加控制器。右鍵單擊解決方案資源管理器 中的Controllers 文件夾,然後選擇:添加 -> 控制器 。它將顯示「添加基架」對話框 -
第10步 - 選擇:Web API 2控制器 - 空 選項。該模板將爲控制器創建一個具有默認操作的Index
方法。
第11步 - 點擊「添加」按鈕,添加控制器對話框將出現。
第12步 - 將名稱設置爲:EmployeesController,然後單擊「添加」 按鈕。
在Controllers
文件夾中看到一個新的 C# 文件 - EmployeeController.cs
,該文件夾在Visual Studio中打開,並進行一些默認操作。如下代碼 -
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
using WebAPIDemo.Models;
namespace WebAPIDemo.Controllers
{
public class EmployeesController : ApiController
{
Employee[] employees = new Employee[]{
new Employee { ID = 1, Name = "Maxsu", JoiningDate =
DateTime.Parse(DateTime.Today.ToString()), Age = 30 },
new Employee { ID = 2, Name = "Allan", JoiningDate =
DateTime.Parse(DateTime.Today.ToString()), Age = 35 },
new Employee { ID = 3, Name = "AvgWong", JoiningDate =
DateTime.Parse(DateTime.Today.ToString()), Age = 21 }
};
public IEnumerable<Employee> GetAllEmployees()
{
return employees;
}
public IHttpActionResult GetEmployee(int id)
{
var employee = employees.FirstOrDefault((p) => p.ID == id);
if (employee == null)
{
return NotFound();
}
return Ok(employee);
}
}
}
第13步 - 運行這個應用程序,並在瀏覽器中訪問URL:http://localhost:58150/api/employees/
,然後按「Enter」。將看到以下輸出 -
第14步 - 再次訪問URL:http://localhost:58150/api/employees/1
,將看到以下輸出 -