文档章节

ASP.NET 5系列教程 (六): 在 MVC6 中创建 Web API

葡萄城技术团队
 葡萄城技术团队
发布于 2015/02/05 09:44
字数 1269
阅读 6690
收藏 1

ASP.NET 5.0 的主要目标之一是统一MVC 和 Web API 框架应用。

接下来几篇文章中您会了解以下内容:

  • ASP.NET MVC 6 中创建简单的web API。

  • 如何从空的项目模板中启动,及添加控件到应用中。

  • 如何配置 ASP.NET 5.0 管道。

  • 在 IIS 外对立部署应用。

本文的目的是从空的项目开始,逐步讲解如何创建应用。当然,您也可以从“Starter Web” 模板开始,它默认包含了MVC 6、权限、记录等其他模块,同时也内置了有效的控制器和视图在其中。

创建空的 ASP.NET 5 项目

打开 Visual Studio 2015。点击 File 菜单,选择 New > Project。

New Project 对话框中,点击 Templates > Visual C# > Web,选择 ASP.NET Web Application 项目模板。命名为 "TodoApi",点击 OK。

New ASP.NET Project 对话框中,选择 "ASP.NET 5.0 Empty" 模板。

下面的效果图展示了工程结构:

工程包含以下文件:

  • global.json 包含了解决方案级别的设置,允许工程到工程之间的引用。

  • project.json 包含了工程级别的设置。

  • Project_Readme.html  为 readme 文件。

  • Startup.cs 包含启动和配置代码。

Startup.cs 文件中的Startup 类,配置了 ASP.NET 需求管道。当你使用空的项目模板,Startup 类不会有任何实质性的代码加入到管道中:

  Startup
{
     void Configure(IApplicationBuilder app)
    {
        //  here!
    }
}

 

现在,你可以运行应用了,但当前的应用没有任何功能。接下来我们会模拟"Starter Web" 项目模板来添加功能,例如 MVC 6、Entity Framework、身份验证、记录等功能。

添加欢迎界面

打开 project.json 文件。该文件包含了工程设置内容。dependencies 部分用于标注需要的NuGet 包和类库。添加 Microsoft.AspNet.Diagnostics 包到列表中:

"": {
    "": "",
    // Add this:
    "": ""
},

 

输入时, Visual Studio 会提供智能提示:

接下来,打开 Startup.cs 文件,添加以下代码:

 System;
 Microsoft.AspNet.Builder;
 
 
 TodoApi
{
      Startup
    {
         void Configure(IApplicationBuilder app)
        {
            //  code
            app.UseWelcomePage();
        }
    }
}

 

点击  F5 运行,Visual Studio 启动浏览器,打开了 http://localhost:port/,端口号是一个Visual Studio随机分配的数字。运行效果如下:

欢迎界面是检验运行效果的快速入口,无需编写代码。

创建 Web API

 

在本章节中,您将创建一个 ToDo 事项管理列表功能API。首先,我们需要添加 ASP.NET MVC 6 到应用中。

添加 MVC 6 到 project.json 文件的依赖列表中:

"": {
    "": "",
    "": "",
    // :
    "": ""
},

 

接下来,添加 MVC 需求管道到 Startup.cs 文件中,

  • 使用 using 声明Microsoft.Framework.DependencyInjection。

  • 添加以下方法到 Startup 类中。

 void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();
}

 

  • 下面这段代码添加了 MVC 6 需要的所有依赖项,会自动在启动时调用ConfigureServices

     void Configure(IApplicationBuilder app)
    {
        // :
        app.UseMvc();
    }

     

    以下是完整的 Startup 类代码:

     System;
     Microsoft.AspNet.Builder;
     Microsoft.AspNet.Http;
    //  :
     Microsoft.Framework.DependencyInjection;
     
     TodoApi
    {
          Startup
        {
            // Add this method:
             void ConfigureServices(IServiceCollection services)
            {
                services.AddMvc();
            }
     
             void Configure(IApplicationBuilder app)
            {
                // :
                app.UseMvc();
                app.UseWelcomePage();
            }
        }
    }

     

    添加 Model

    model 代表应用的数据域。在本示例中,model 中存储 ToDo 项。 添加以下类到项目中:

     System.ComponentModel.DataAnnotations;
     
     TodoApi.Models
    {
          TodoItem
        {
             int Id { ; ; }
            [Required]
              Title { ; ; }
             bool IsDone { ; ; }
        }
    }

     

    为了保持项目的整洁,我创建了 Models 文件夹用于存放 Model 类,当然这不是必要的操作。

    添加 Controller

    添加 controller 类用于处理 HTTP 请求。添加以下类到项目中:

     Microsoft.AspNet.Mvc;
     System.Collections.Generic;
     System.Linq;
     TodoApi.Models;
     
     TodoApi.Controllers
    {
     
        [Route("")]
          TodoController : Controller
        {
              List<TodoItem> _items =  List<TodoItem>()
            {
                 TodoItem { Id = 1, Title = "" }
            };
     
            [HttpGet]
             IEnumerable<TodoItem> GetAll()
            {
                 _items;
            }
     
            [HttpGet("", Name = "")]
             IActionResult GetById (int id)
            {
                var item = _items.FirstOrDefault(x => x.Id == id);
                 (item == null)
                {
                     HttpNotFound();
                }
     
                  ObjectResult(item);
            }
     
            [HttpPost]
             void CreateTodoItem([FromBody] TodoItem item)
            {
                 (!ModelState.IsValid)
                {
                    Context.Response.StatusCode = 400;
                }
    else
                {
                    item.Id = 1+ _items.Max(x => (int?)x.Id) ?? 0;
                    _items.Add(item);
     
                     url = Url.RouteUrl("",  { id = item.Id },
                        Request.Scheme, Request.Host.ToUriComponent());
     
                    Context.Response.StatusCode = 201;
                    Context.Response.Headers[""] = url;
                }
            }
     
            [HttpDelete("")]
             IActionResult DeleteItem(int id)
            {
                var item = _items.FirstOrDefault(x => x.Id == id);
                 (item == null)
                {
                     HttpNotFound();
                }
                _items.Remove(item);
                  HttpStatusCodeResult(204); // 201 No Content
            }
        }
    }

     

    同样,我创建了 Controllers 文件夹用于存储 controller。

    在后续的章节中我们将进一步阐述关于 Controller 的代码。以下是 controller 实现的一些基础功能:

    image

    例如,下面是获取 ToDo 项目的 HTTP 请求的:

     http://localhost:5000/api/todo HTTP/1.1
    User-Agent: Fiddler
    Host: localhost:5000

     

    下面是 response 流:

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=utf-8
    Server: Microsoft-HTTPAPI/2.0
    : Thu, 30 Oct 2014 22:40:31 GMT
    Content-Length: 46
     
    [{"":1,"":"","":}]

    后续章节中我们将阐述以下内容:

    • 在配置方法中添加以下代码,UseMvc 方法用于添加 MVC 6 到管道。

  • 如何配置 ASP.NET 5.0 管道。

  • 在 IIS 外对立部署应用。

有了本节如何在 MVC6 中创建 Web API的讲解,相信大家会对ASP.NE的理解又加深了一步。在进行开发时,还可以借助一些开发工具。ComponentOne Studio for ASP.NET 是ASP.NET平台上的一整套完备的开发工具包,用于在各种浏览器中创建和设计具有现代风格的Web应用程序。

原文链接:Create a Web API in MVC 6

 

系列文章目录:

 

© 著作权归作者所有

葡萄城技术团队

葡萄城技术团队

粉丝 387
博文 544
码字总数 792122
作品 17
西安
高级程序员
私信 提问
ASP.NET 5系列教程(七)完结篇-解读代码

在本文中,我们将一起查看TodoController 类代码。 [Route] 属性定义了Controller的URL 模板: 所有符合该模板类型的HTTP 请求都会被路由到该controller。在本例中, 路由的命名规范为对应C...

葡萄城控件技术团队
2015/03/17
0
0
自学MVC看这里——全网最全ASP.NET MVC 教程汇总

MVC架构已深得人心,微软也不甘落后,推出了Asp.net MVC。小编特意整理博客园乃至整个网络最具价值的MVC技术原创文章,为想要学习ASP.NET MVC技术的学习者提供一个整合学习入口。本文从Why,W...

葡萄城控件技术团队
2016/08/18
204
0
【转】ASP.NET WEB API系列教程

from: 西瓜小强 http://www.cnblogs.com/risk/category/406988.html ASP.NET Web API教程(六) 安全与身份认证 摘要: 在实际的项目应用中,很多时候都需要保证数据的安全和可靠,如何来保证数...

夏春涛
2016/08/13
0
0
ASP.NET 5系列教程 (一):领读新特性

近期微软发布了ASP.NET 5.0,本次发布的新特性需求源于大量用户的反馈和需求,例如灵活的跨平台运行时和自主部署能力使ASP.NET应用不再受限于IIS、Cloud-ready环境配置降低了云端部署的门槛,...

葡萄城控件技术团队
2014/11/26
0
0
Asp.Net MVC4入门指南(1)入门介绍

前言 本教程将为您讲解使用微软的Visual Studio Express 2012或Visual Web Developer 2010 Express Service Pack 1 来建立一个ASP.NET MVC4 Web应用程序所需要的基础知识。建议您使用Visual ...

葡萄城控件技术团队
2014/06/11
0
0

没有更多内容

加载失败,请刷新页面

加载更多

全面剖析 Knative Eventing 0.6 版本新特性

前言 Knative Eventing 0.6 版本已经于5月15号正式发布。相比于0.5版本,此次发布包含了一些重要特性及更新。针对这些新特性以及更新,我们如何快速、精准的定位主要技术点。本篇文章针对这些...

阿里云官方博客
5分钟前
0
0
在闲鱼,我们如何用Dart做高效后端开发?

背景 像阿里其他技术团队以及业界的做法一样,闲鱼的大多数后端应用都是全部使用java来实现的。java易用、丰富的库、结构容易设计的特性决定了它是进行业务开发的最好语言之一。后端应用中数...

阿里云云栖社区
7分钟前
3
1
初学Docker容器网络不得不看的学习笔记

【技术沙龙002期】数据中台:宜信敏捷数据中台建设实践|宜信技术沙龙 将于5月23日晚8点线上直播,点击报名 一、关于Docker Docker 是一个开源的应用容器引擎,基于 Go 语言 并遵从Apache2.0...

宜信技术学院
9分钟前
2
0
Django框架配置

今天我们学习Django框架配置,首先先来看一下如何在Django中创建APP! 1.Django中创建APP 首先我们打开PyCharm,找到之前你创建的Django项目,我的项目是First_Project: (1)先选中你要运行...

彩色泡泡糖
11分钟前
0
0
git代码迁移

一、从阿里云code迁移到gitLab 1、在gitLab上新建一个项目Bicon,添加私钥 2、从原地址克隆一份裸版本库 git clone --bare git://xxxx_Bicon.git 这里的地址是阿里云code的地址 3、以镜像推送...

星爵22
12分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部