001.開始使用ASP.NET Web API 2(一)

原文鏈接:http://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/tutorial-your-first-web-api

(ps:文章只是講解一些如何創建Web API的步驟和一個簡單示例,沒有涉及到路由選擇和方法選擇,后續的一篇是專門講解這方面的。兩篇是一起翻譯的,其實兩篇應該一起發,但一起又會很長,就周六發吧,這篇當是我的見習基礎翻譯文章吧。)

1.前言

HTTP不僅僅致力于網站的頁面,它還是一個強有力的平臺,用來提供服務和展現數據。HTTP是簡單、靈活且無處不在。絕大多數的能想到的平臺都有HTTP的類庫,所以HTTP服務能夠應用于瀏覽器端,移動端以及桌面程序等廣泛的客戶端。ASP.NET WEB API是能由.NET框架提供的一項技術,在本教程中,你將會使用ASP.NET Web API來建立用來返回產品列表的API。

2.建立API工程

在本教程中,你將會使用ASP.NET Web API創建返回產品列表的API。首先在前端頁面,使用jQuery來顯示結果。如下圖

001.開始使用ASP.NET Web API 2(一)

打開vs,選擇新建Web API工程。根據不同的vs版本,新建的方法可能有些不同,但大同小異,大家可自行新建。

3.添加數據模型

一個模型對象在程序中代表了你的數據。ASP.NET Web API能夠了自動的序列化你的模型到JSON、XML或者其它的格式,然后將這些序列化后的數據寫到HTTP的報文消息中。直到客戶端能夠讀到序列化后的數據,能反序列化成對象。大多數客戶端都具有這樣的能力。此外,通過設置在報表消息中請求的頭能返回相應客戶端所需要的數據。(ps:簡單的示例文章中,一些個概念還是可以溫故知新的,比如序列化和反序列化)

讓我們開始建一個簡單的模型來表示一個產品。

001.開始使用ASP.NET Web API 2(一)

文件命名為Product,添加下列的屬性到Product類

 1 namespace ProductsApp.Models
 2 {
 3     public class Product
 4     {
 5         public int Id { get; set; }
 6         public string Name { get; set; }
 7         public string Category { get; set; }
 8         public decimal Price { get; set; }
 9     }
10 }

4.添加API控制器

在Web API中,控制器是處理HTTP請求的對象,我們將添加一個通過產品ID返回該產品信息的一個控制器。

001.開始使用ASP.NET Web API 2(一)

(ps:按步驟點吧,原文圖片截圖挺多,能少用就少用吧)

命名為ProductsController,代碼如下

namespace ProductsApp.Controllers
{
    public class ProductsController : Controller
    {

        Product[] products = new Product[] 
        { 
            new Product{Id = 1, Name = "Tomato Soup", Category = "Groceries", Price = 1},
            new Product{Id = 2, Name = "Tomato Soup", Category = "Groceries", Price = 1},
            new Product{Id = 3, Name = "Tomato Soup", Category = "Groceries", Price = 1}
        };

        public IEnumerable<Product> GetAllProducts()
        {
            return products;
        }

        public IHttpActionResult GetProduct(int id)
        {
            var product = products.FirstOrDefault((p) => p.Id == id);
            if (product == null)
            {
                return HttpFound();
            }
            return Ok(product);
        }
    }
}

為了保持案例簡單,產品數據存儲在這個控制器中一個封閉的數組,當然在真實的程序中,你可以通過從數據庫中或者其它的途徑查詢到數據。

在控制器中定義了兩個方法用來返回產品

GetAllProducts方法返回一個IEnumerable<Product>類型的產品列表

GetProduct方法返回一個產品通過ID

那就對了。我們已經有了Web API了。每一個方法的訪問如下。

001.開始使用ASP.NET Web API 2(一)

相要更多知道關于Web API如何選擇控制器的方法,可以看控制器路由選擇

(ps:下一篇就是這個,上面的代碼其實是有不通的地方,我用的是vs2012,可能沒Web API 2的類庫,所以打不到一些類,網上找了方法,使用NuGet安裝WebApi,但安裝失敗,有知道的話,可以發表下自己的解決辦法。)

5.顯示數據

(ps:靜態的頁面還是不附了,主要的是js,作者使用的是jQuery)

 1 var uri = ‘api/products‘;
 2 
 3     $(document).ready(function () {
 4       // Send an AJAX request
 5       $.getJSON(uri)
 6           .done(function (data) {
 7             // On success, ‘data‘ contains a list of products.
 8             $.each(data, function (key, item) {
 9               // Add a list item for the product.
10               $(‘<li>‘, { text: formatItem(item) }).appendTo($(‘#products‘));
11             });
12           });
13     });
14 
15     function formatItem(item) {
16       return item.Name + ‘: $‘ + item.Price;
17     }
18 
19     function find() {
20       var id = $(‘#prodId‘).val();
21       $.getJSON(uri + ‘/‘ + id)
22           .done(function (data) {
23             $(‘#product‘).text(formatItem(data));
24           })
25           .fail(function (jqXHR, textStatus, err) {
26             $(‘#product‘).text(‘Error: ‘ + err);
27           });
28     }

為了得到產品列表,發送一個請求到”/api/products”

jQuery中的getJSON方法發送一個AJAX請求,作為返回的數據為包含JSON對象的數組。done 方法標識了一個回調函數,當請求成功時執行。

(對應是頁面加載DOM完成的ready回調)

我們依然使用getJSON方法來發送請求,但這次在URL中放上一個id,那請求過來的數據將會是一個產品的信息。

(對應是find函數)

(ps:上面的一些知識對于我來說還是比較好理解的,更不用說大家了,周六晚會發一篇路由的選擇,路由方法選擇還是挺有規律的。由淺入深,以后會多看看更更深層次的文章。)

 

001.開始使用ASP.NET Web API 2(一),布布扣,bubuko.com

001.開始使用ASP.NET Web API 2(一)

上一篇:云计算合同中须把关的9个安全要点


下一篇:亚信安全联合国家计算机病毒应急处理中心 发起病毒疫情调查 共同维护网络新秩序