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

1.WebApi是什么

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

可以把WebApi看成Asp.Net项目类型中的一种，其他项目类型诸如我们熟知的WebForm项目，Windows窗体项目，控制台应用程序等。

WebApi类型项目的最大优势就是，开发者再也不用担心客户端和服务器之间传输的数据的序列化和反序列化问题，因为WebApi是强类型的，可以自动进行序列化和反序列化，一会儿项目中会见到。

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

2.页面运行效果

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

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

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

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

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类中的每个字段同名对应，在服务器端接收数据的时候，我们并没有对接收到的数据进行序列化，而返回数据给客户端的时候也并没有对数据进行反序列化，大大节省了以前开发中不停地进行序列化和反序列化的时间。

时间： 2024-11-08 20:21:04

ASP.NET WebAPI 项目示例（增删改查）的相关文章

ASP.NET WebAPI --- 简单实现增删改查

先理解一下WebAPI的概念,官方给的很详细: 什么是Web API? 在我们了解什么是Web API之前,让我们看看什么是API(应用程序编程接口). 根据维基百科的API定义:在计算机编程中,应用程序编程接口(API)是一组用于构建软件和应用程序的子例程定义,协议和工具. 简单来说,API是某种接口,它具有一组允许程序员访问应用程序,操作系统或其他服务的特定功能或数据的功能. Web API顾名思义,是一个可以使用HTTP协议访问的Web上的API.这是一个概念,而不是一种技术.我们可以使用

Rhythmk 学习 Hibernate 01 - maven 创建Hibernate 项目之 增删改查入门

1.环境: Maven :3.1.1 开发工具:Spring Tool Suite 数据库 : Mysql  5.6 2.项目文件结构 文件代码: 2.1 .pom.xml <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.ap

Asp.net简单三层+Sqllite 增删改查

新建项目à新建一个空白解决方案 在Model新建一个实体类 using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks;     namespace factory.Model {     public class factorys     {     //ID INTEGER PRIMARY KEY AUTOINCREMENT

asp.net中的DataGridView增删改查加分页

前台页面: <%@ Page Language="C#" AutoEventWireup="true" CodeFile="StaffManager.aspx.cs" Inherits="adminmaster_StaffManager" EnableEventValidation="true" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTM

asp.net 的xml数据增删改查

A.前台html页面 <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title></title> <link href="handle/admin-style.css" rel="stylesheet" type="text/css&q

在 idea 下搭建的第一个MyBatis项目及增删改查用法

Mybatis搭建第一个项目 1. 简介 1.1 什么是 MyBatis? MyBatis 是一款优秀的持久层框架,它支持定制化 SQL.存储过程以及高级映射.MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集.MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型.接口和 Java 的 POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录. 如何获取Mybatis? GitHub 源码:https://gith

Asp.Net MVC EF-DbFirst之增删改查

控制器及动作方法: using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Mvc; using Mvc5Test.Models; using System.Data.Entity.Infrastructure; namespace Mvc5Test.Controllers { //用户的请求总是先发到控制器的某个Action方法,再由Action方

ASP.NET MVC增删改查

ASP.NET MVC中的增删改查 基本都要使用C控制器中的两个action来完成操作,一个用于从主界面跳转到新页面.同时将所需操作的数据传到新界面,另一个则对应新界面的按钮,用于完成操作.将数据传回主界面以及跳转回主界面.根据不同情况使用不同的传值方法. 在M模型层中定义所需的LinQ操作,在C按需引用. 添加:View中提交元素,表单元素使用form表单提交,按钮的使用submit,在控制器C中获取元素,在模型层M的写法,在C中调用. 删除,可使用MVC中的路由功能 url="{contro

webapi初学项目(增删改查)

初学wenapi做了一个从数据库增删改查的项目 webapi: 1.创建项目:visual C# —> ASP.NET MVC 4 web应用程序 模板—>web api; 2.注册路由: 路由表中的每一个条目都包含一个路由模板.这个Web API默认的路由模版是"api/{controller}/{id}".在这个模版中,“api”是一个文字式路径片段,而{controller}和{id}则是占位符变量. 当Web API框架接收一个HTTP请求时,它会试图根据路由表中的