ASP.NET WebAPI 项目示例（增删改查）

时间 2019-11-06

标签 asp.net asp webapi 项目示例增删栏目 ASP 繁體版

原文原文链接

1.WebApi是什么html

ASP.NET Web API 是一种框架，用于轻松构建能够由多种客户端（包括浏览器和移动设备）访问的 HTTP 服务。ASP.NET Web API 是一种用于在 .NET Framework 上构建 RESTful 应用程序的理想平台。jquery

能够把WebApi当作Asp.Net项目类型中的一种，其余项目类型诸如咱们熟知的WebForm项目，Windows窗体项目，控制台应用程序等。ajax

WebApi类型项目的最大优点就是，开发者不再用担忧客户端和服务器之间传输的数据的序列化和反序列化问题，由于WebApi是强类型的，能够自动进行序列化和反序列化，一下子项目中会见到。json

下面咱们创建了一个WebApi类型的项目，项目中对产品Product进行增删改查，Product的数据存放在List<>列表（即内存）中。api

2.页面运行效果浏览器

如图所示，能够添加一条记录; 输入记录的Id，查询出该记录的其它信息；修改该Id的记录；删除该Id的记录。服务器

3.二话不说，开始建项目app

1）新建一个“ASP.NET MVC 4 Web 应用程序”项目，命名为“ProductStore”,点击肯定，如图框架

2）选择模板“Web API”，点击肯定，如图post

3）和MVC类型的项目类似，构建程序的过程是先创建数据模型（Model）用于存取数据, 再创建控制器层（Controller）用于处理发来的Http请求，最后构造显示层（View）用于接收用户的输入和用户进行直接交互。

这里咱们先在Models文件夹中创建产品Product类： Product.cs，以下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace ProductStore.Models
{
    public class Product
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Category { get; set; }
        public decimal Price { get; set; }
    }
}

4）试想，咱们目前只有一个Product类型的对象，咱们要编写一个类对其实现增删改查，之后咱们可能会增长其余的类型的对象，再须要编写一个对新类型的对象进行增删改查的类，为了便于拓展和调用，咱们在Product之上构造一个接口，使这个接口约定增删改查的方法名称和参数，因此咱们在Models文件夹中新建一个接口： IProductRepository.cs ，以下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ProductStore.Models
{
    interface IProductRepository
    {
        IEnumerable<Product> GetAll();
        Product Get(int id);
        Product Add(Product item);
        void Remove(int id);
        bool Update(Product item);
    }
}

5）而后，咱们实现这个接口，在Models文件夹中新建一个类，具体针对Product类型的对象进行增删改查存取数据，并在该类的构造方法中，向List<Product>列表中存入几条数据，这个类叫：ProductRepository.cs，以下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace ProductStore.Models
{
    public class ProductRepository:IProductRepository
    {
        private List<Product> products = new List<Product>();
        private int _nextId = 1;
        public ProductRepository()
        {
            Add(new Product { Name="Tomato soup",Category="Groceries",Price=1.39M});
            Add(new Product { Name="Yo-yo",Category="Toys",Price=3.75M});
            Add(new Product { Name = "Hammer", Category = "Hardware", Price = 16.99M });
        }


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

        public Product Get(int id)
        {
            return products.Find(p=>p.Id==id);
        }

        public Product Add(Product item)
        {
            if (item == null)
            {
                throw new ArgumentNullException("item");
            }
            item.Id = _nextId++;
            products.Add(item);
            return item;
        }

        public void Remove(int id)
        {
            products.RemoveAll(p=>p.Id==id);
        }

        public bool Update(Product item)
        {
            if (item == null)
            {
                throw new ArgumentNullException("item");
            }
            int index = products.FindIndex(p=>p.Id==item.Id);
            if (index == -1)
            {
                return false;
            }
            products.RemoveAt(index);
            products.Add(item);
            return true;
        }
    }
}

此时，Model层就构建好了。

6）下面，咱们要构建Controller层，在此以前，先回顾一下Http中几种请求类型，以下

get 类型用于从服务器端获取数据，且不该该对服务器端有任何操做和影响

post 类型用于发送数据到服务器端，建立一条新的数据，对服务器端产生影响

put 类型用于向服务器端更新一条数据，对服务器端产生影响（也可建立一条新的数据但不推荐这样用）

delete 类型用于删除一条数据，对服务器端产生影响

这样，四种请求类型恰好可对应于对数据的查询，添加，修改，删除。WebApi也推荐如此使用。在WebApi项目中，咱们请求的再也不是一个具体页面，而是各个控制器中的方法（控制器也是一种类，默认放在Controllers文件夹中）。下面咱们将要创建一个ProductController.cs控制器类，其中的方法都是以“Get Post Put Delete”中的任一一个开头的，这样的开头使得Get类型的请求发送给以Get开头的方法去处理，Post类型的请求交给Post开头的方法去处理，Put和Delete同理。

而以Get开头的方法有好几个也是能够的，此时如何区分到底交给哪一个方法执行呢？这就取决于Get开头的方法们的传入参数了，一下子在代码中能够分辨。
构建Controller层，在Controllers文件夹中创建一个ProductController.cs控制器类，以下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using ProductStore.Models;
using System.Web.Http;
using System.Net;
using System.Net.Http;

namespace ProductStore.Controllers
{
    public class ProductsController : ApiController
    {
        static readonly IProductRepository repository = new ProductRepository();

        //GET:  /api/products
        public IEnumerable<Product> GetAllProducts()
        {
            return repository.GetAll();
        }

        //GET: /api/products/id
        public Product GetProduct(int id)
        {
            Product item = repository.Get(id);
            if (item == null)
            {
                throw new HttpResponseException(HttpStatusCode.NotFound);            
            }
            return item;
        }

        //GET: /api/products?category=category
        public IEnumerable<Product> GetProductsByCategory(string category)
        {
            return repository.GetAll().Where(p=>string.Equals(p.Category,category,StringComparison.OrdinalIgnoreCase));
        }

        //POST: /api/products
        public HttpResponseMessage PostProduct(Product item)
        {
            item = repository.Add(item);

            var response = Request.CreateResponse<Product>(HttpStatusCode.Created,item);
            string uri = Url.Link("DefaultApi", new { id=item.Id});
            response.Headers.Location = new Uri(uri);

            return response;
        }

        //PUT: /api/products/id
        public void PutProduct(int id, Product product)
        {
            product.Id = id;
            if (!repository.Update(product))
            {
                throw new HttpResponseException(HttpStatusCode.NotFound);
            }
        }

        //Delete: /api/products/id
        public void DeleteProduct(int id)
        {
            Product item = repository.Get(id);
            if (item == null)
            {
                throw new HttpResponseException(HttpStatusCode.NotFound);
            }
            repository.Remove(id);
        }
    }
}

使该类继承于ApiController类，在其中实现处理各类Get,Post,Put,Delete类型Http请求的方法。

每个方法前都有一句注释，标识了该方法的针对的请求的类型（取决于方法的开头），以及要请求到该方法，须要使用的url。

这些url是有规律的，见下图：

api是必须的，products对应的是ProductsControllers控制器，而后又Http请求的类型和url的后边地址决定。

这里，咱们除了第三个“Get a product by category”,其余方法都实现了。

7）最后，咱们来构建View视图层，咱们更改Views文件夹中的Home文件夹下的Index.cshtml文件，这个文件是项目启动页，以下：

<div id="body">
    <script src="~/Scripts/jquery-1.8.2.min.js"></script>
    <section >   <h2>添加记录</h2>   Name:<input id="name" type="text" /><br />   Category:<input id="category" type="text" />   Price:<input id="price" type="text" /><br />   <input id="addItem" type="button" value="添加" />
    </section>

    <section>
        <br />
        <br />   <h2>修改记录</h2>   Id：<input id="id2" type="text" /><br />   Name:<input id="name2" type="text" /><br />   Category:<input id="category2" type="text" />   Price:<input id="price2" type="text" /><br />   <input id="showItem" type="button" value="查询" />   <input id="editItem" type="button" value="修改" />   <input id="removeItem" type="button" value="删除" />
    </section>

</div>

8）而后咱们给页面添加js代码，对应上面的按钮事件，用来发起Http请求，以下：

  <script>
        //用于保存用户输入数据
        var Product = {
            create: function () {
                Id: "";
                Name: "";
                Category: "";
                Price: "";
                return Product;
            }
        }

        //添加一条记录 请求类型:POST  请求url:  /api/Products  
        //请求到ProductsController.cs中的 public HttpResponseMessage PostProduct(Product item) 方法
        $("#addItem").click(function () {
            var newProduct = Product.create();
            newProduct.Name = $("#name").val();
            newProduct.Category = $("#category").val();
            newProduct.Price = $("#price").val();

            $.ajax({
                url: "/api/Products",
                type: "POST",
                contentType: "application/json; charset=utf-8",
                data: JSON.stringify(newProduct),
                success: function () {
                    alert("添加成功！");
                },
                error: function (XMLHttpRequest, textStatus, errorThrown) {
                    alert("请求失败，消息：" + textStatus + "  " + errorThrown);
                }
            });
        });

        //先根据Id查询记录  请求类型:GET  请求url:  /api/Products/Id  
        //请求到ProductsController.cs中的 public Product GetProduct(int id) 方法
        $("#showItem").click(function () {
            var inputId = $("#id2").val();
            $("#name2").val("");
            $("#category2").val("");
            $("#price2").val("");
            $.ajax({
                url: "/api/Products/" + inputId,
                type: "GET",
                contentType: "application/json; charset=urf-8",
                success: function (data) {
                    $("#name2").val(data.Name);
                    $("#category2").val(data.Category);
                    $("#price2").val(data.Price);
                },
                error: function (XMLHttpRequest, textStatus, errorThrown) {
                    alert("请求失败，消息：" + textStatus + "  " + errorThrown);
                }
            });
        });

        //修改该Id的记录 请求类型:PUT  请求url:  /api/Products/Id  
        //请求到ProductsController.cs中的 public void PutProduct(int id, Product product) 方法
        $("#editItem").click(function () {
            var inputId = $("#id2").val();
            var newProduct = Product.create();
            newProduct.Name = $("#name2").val();
            newProduct.Category = $("#category2").val();
            newProduct.Price = $("#price2").val();

            $.ajax({
                url: "/api/Products/" + inputId,
                type: "PUT",
                data: JSON.stringify(newProduct), 
                contentType: "application/json; charset=urf-8",
                success: function () {
                    alert("修改为功！ ");
                },
                error: function (XMLHttpRequest, textStatus, errorThrown) {
                    alert("请求失败，消息：" + textStatus + "  " + errorThrown);
                }
            });
        });

        //删除输入Id的记录  请求类型:DELETE  请求url:  /api/Products/Id  
        //请求到ProductsController.cs中的  public void DeleteProduct(int id) 方法
        $("#removeItem").click(function () {
            var inputId = $("#id2").val();
            $.ajax({
                url: "/api/Products/" + inputId,
                type: "DELETE",
                contentType: "application/json; charset=uft-8",
                success: function (data) {                   
                        alert("Id为 " + inputId + " 的记录删除成功！");
                },
                error: function (XMLHttpRequest, textStatus, errorThrown) {
                    alert("请求失败，消息：" + textStatus + "  " + errorThrown);
                }
            });
        });
    </script>

这里，WebApi的一个简单的增删改查项目就完成了，选择执行项目便可测试。注意到，其中用ajax发起请求时，发送到服务器端的数据直接是一个json字符串，固然这个json字符串中每一个字段要和Product.cs类中的每一个字段同名对应，在服务器端接收数据的时候，咱们并无对接收到的数据进行序列化，而返回数据给客户端的时候也并无对数据进行反序列化，大大节省了之前开发中不停地进行序列化和反序列化的时间。