Nancy简介

Nancy是一个轻量级的独立的框架,下面是官网的一些介绍:

  • Nancy 是一个轻量级用于构建基于 HTTP 的 Web 服务,基于 .NET 和 Mono
    平台,框架的目标是保持尽可能多的方式,并提供一个super-duper-happy-path所有交互。
  • Nancy
    设计用于处理 DELETEGETHEADOPTIONSPOSTPUT``和 PATCH 等请求方法,并提供简单优雅的
    DSL 以返回响应。让你有更多时间专注于你的代码和程序。

官方地址:http://nancyfx.org   GitHub:https://github.com/NancyFx/Nancy

Nancy 在前两天 发布了一个  v2.0.0-barneyrubble
版本,支持ASP.NET Core 1.0。

如何在 ASP.NET Core 中使用 Nancy 框架,下面我们就来学习。

  • ASP.NET Core 运行原理剖析1:初始化WebApp模版并运行
    • 核心框架
    • ASP.NET Core APP 创建与运行
    • 总结

创建ASP.NET Core Nancy项目

宿主使用 ASP.NET Core Host Kestrel

首先新建一个ASP.NET Core 应用程序,下一步选择空的模板。

图片 1

图片 2

 

下面来添加引用。

首先添加 Microsoft.AspNetCore.Owin

Install-Package Microsoft.AspNetCore.Owin

然后添加 Nancy

Install-Package Nancy -Pre

添加好以后我们就可以来编写代码。

在 Startup.cs 添加 Nancy.Owin 引用,并在Configure 方法加入如下代码:

        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole();

            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            app.UseOwin(x => x.UseNancy());
        }

 

然后我们来添加Module,可以理解为是 Nancy的 Controller 。

这里添加一个HomeModule,我们添加一个类 HomeModule.cs
,然后继承 NancyModule。

    public class HomeModule:NancyModule
    {
        public HomeModule()
        {
            Get("/", r => "Nancy running on ASP.NET Core LineZero");
            Get("/{name}", r => "简单的路由模板,路由参数:"+r.name);
            Get("/404", r => HttpStatusCode.NotFound);
        }
    }

 

然后运行程序,这里我们使用 Kestrel 运行。

http://localhost:5000

图片 3

 

http://localhost:5000/linezero

图片 4

http://localhost:5000/404

图片 5

这个是Nancy自带的404,我们也可以自己处理。

本篇主要讲解Nancy 在 ASP.NET
Core中的使用,更多Nancy的介绍及使用,可以参考我之前的一些文章,Nancy
是的一个非常轻量型的框架。

 

如果你觉得本文对你有帮助,请点击“推荐”,谢谢。

之前两篇文章简析.NET Core 以及与 .NET Framework的关系和.NET
Core的构成体系从总体上介绍.NET Core,接下来计划用一个系列对ASP.NET
Core的运行原理进行剖析。

ASP.NET Core 是新一代的 ASP.NET,早期称为 ASP.NET
vNext,并且在推出初期命名为ASP.NET 5,但随着 .NET Core 的成熟,以及
ASP.NET 5的命名会使得外界将它视为 ASP.NET
的升级版,但它其实是新一代从头开始打造的 ASP.NET
核心功能,因此微软宣布将它改为与 .NET Core 同步的名称,即 ASP.NET Core。

ASP.NET Core 可运行于 Windows 平台以及非 Windows 平台,如 Mac OSX 以及
Ubuntu Linux 操作系统,是 Microsoft 第一个具有跨平台能力的 Web
开发框架。

微软在一开始开发时就将 ASP.NET Core 开源,因此它也是开源项目的一员,由
.NET 基金会 (.NET Foundation) 所管理。

正式版的.NET Core已于今天发布(2016年6月27日),具体可看微软 .NET Core
1.0 正式发布下载

核心框架

ASP.NET Core 在 .NET Core 的基础上发展,目前规划的功能有:

  • ASP.NET Core MVC: ASP.NET Core MVC
    提供了开发动态web站点的API,包括了WebPages 和 WebAPI
    ,最终可运行在IIS 或 自托管(self-hosted)的服务器中。

  • DependencyInjection: 包含了通用的依赖注入接口,用于在ASP.NET Core
    MVC中使用。

  • Entity Framework Core:
    与之前版本的EntityFramework版本类似是一个轻量级的ORM框架,包括了Linq,POCO和Codefirst的支持。

  • ASP.NET Core Identity: 用于在ASP.NET Core web
    applications构建用户权限系统的框架,包括了membership、login等功能,同时也可以方便的扩展和自定义。

ASP.NET Core APP 创建与运行

一、安装the .NET Core SDK for Windows(Linux、MAC)

以Windows为例,,
安装完成后可以用命令dotnet -v查看版本号。

C:\Users\stephen>dotnet -vTelemetry is: Enabled.NET Command Line Tools (1.0.0-preview1-002702)Usage: dotnet [common-options] [command] [arguments]

二、命令行生成模版项目

开发一个webapp可以从零开始创建文件,也可以通过命令行生成一个空的项目模版,下面的代码用于从零开始创建模版。

mkdir aspnetcoreappcd aspnetcoreappdotnet new

依次执行命令后,便可在当前路径下,生成模版。

图片 6

模版包括以下三个文件:

  • project.json:

主掌项目的运行期的配置设置,包含项目的包参考 (Package
References)、项目的基本设置、引导指令、包含或排除指定目录、以及建造时的相关事件指令等。

  • Program.cs:

程序入口文件

  • project.lock.json:

与project.json相比,是project.json文件中引用包的完整引用列表。

三、修改project.json

project.json是用于定义项目需要依赖的资源,每个WebApp 需要一个hosting
程序(IIS、IISExpress等),而此次使用Kestrel
(什么是kestrel?),在project.json中加入对Kestrel的依赖代码清单如下。

"dependencies": {  "Microsoft.NETCore.App": {    "type": "platform",    "version": "1.0.0-rc2-3002702"  },  "Microsoft.AspNetCore.Server.Kestrel": "1.0.0-rc2-final"},

四、下载依赖包部署网站

在WebApp部署时(dotnet
restore)根据project.json的依赖文件,依靠nuget下载依赖包,完成对整个程序的restore。(类似于Nodejs的
npm restore)

C:\Users\stephen\.nuget\packages可以看到nuget已经下载到本地的包,在开始部署前nuget是不会加载依赖包,下图可看到目前nuget并没有下载任何包。

图片 7

然后执行命令

dotnet restore

可以看到,nuget已经自动将需要依赖包下载到本地

图片 8

五、添加Startup.cs文件

对于一个ASP.NET Core 程序而言,Startup Class 是必须的。ASP.NET
Core在程序启动时会从assemblies中找到名字叫Startup的类,如果存在多个名为Startup的类,则会先找到项目根名称空间下的Startup类。

在Startup必须定义Configure方法,而configureServices方法则是可选的,方法会在程序第一次启动时被调用,类似传统的ASP.NET
MVC的路由和应用程序状态均可在Startup中配置,也可以在此安装所需中间件等等。Startup的详细功能的对于startup.cs中的configure和configureServices方法会在后续文章中详解

在刚才文件路径下添加Startup.cs文件,并复制如下代码:

using System;using Microsoft.AspNetCore.Builder;using Microsoft.AspNetCore.Hosting;using Microsoft.AspNetCore.Http;namespace aspnetcoreapp{    public class Startup    {        public void Configure(IApplicationBuilder app)        {            app.Run(context =>            {                return context.Response.WriteAsync("Hello from ASP.NET Core!");            });        }    }}

六、Web Hosting 配置

在Program.cs文件中复制如下代码,指定WebApp宿主程序为Kestrel:

using System;using Microsoft.AspNetCore.Hosting;namespace aspnetcoreapp{    public class Program    {        public static void Main(string[] args)        {            var host = new WebHostBuilder()                .UseKestrel()                .UseStartup<Startup>()                .Build();            host.Run();        }    }}

七、编译

dotnet build

代码完成后,需要调用Roslyn编译器将代码编译为assemblies,存储至bin文件夹中。按照上一节所述(简析
.NET Core 构成体系),
ASP.NET Core App
可以编译为IL的assemblies外,还可以通过native直接编译为机器码。

图片 9

八、启动

输入启动命令,Kestrel托管WEB程序,并在5000端口监听,至此整个程序启动起来。

dotnet run

图片 10

图片 11

总结

本节介绍了ASP.NET Core 项目从创建、配置、编译、发布、运行的过程,ASP.NET
Core与之前的ASP.NET相比具有更高的透明度和灵活性,可以快速的在各个操作系统中开发与运行。

本节使用Windows操作系统,但目前微软也在 linuxmac
下提供了类似的命令行工具,方便在 linuxmac
下开发与部署,在后面文章中会详细讲解,本节不再累述。


参考链接

https://docs.asp.net/en/1.0.0-rc2/getting-started.html

相关文章