Nancy简单实战之NancyMusicStore(一)：准备工作和搭建项目

开发环境

OS ： Windows 10 10.0.14393

IDE ： Visual Studio 2015 Community With Update 3

Database ： PostgreSQL 9.6

DBMS ：pgAdmin 4

迁移数据与配置PG远程访问

MVC MusicStore中的数据分为两部分:系统相关数据和MemberShip产生的用户数据



这里我们只需要系统相关的数据，Membership相关的数据就让它见鬼去吧~~

系统相关的数据是存储在SQL Server Compact，通过Database4打开这个数据库，然后将这个数据库生成相关的脚本，对这些脚本简单的修改一下，拿到pg Admin 上执行。

然后还添加了一张新的用户表，建表语句如下

CREATE TABLE public.sysuser
(
sysuserid character varying(100) COLLATE pg_catalog."default" NOT NULL,
sysusername character varying(100) COLLATE pg_catalog."default" NOT NULL,
sysuserpassword character varying(100) COLLATE pg_catalog."default" NOT NULL,
sysuseremail character varying(100) COLLATE pg_catalog."default",
CONSTRAINT sysuser_pkey PRIMARY KEY (sysuserid)
)
WITH (
OIDS = FALSE
)

TABLESPACE pg_default;

ALTER TABLE public.sysuser
OWNER to dev;

数据库和数据表已经建好了，下面还要配置PG可以被远程访问，不然后面在Linux部署的时候会提示无法访问数据库。

只需要修改 pg_hba.conf 这个配置文件

直接将

host all all 127.0.0.1/32 md5

修改为以下配置

host all all 0.0.0.0/0 md5

如果不希望允许所有IP远程访问，则可以将上述配置项中的0.0.0.0设定为特定的IP值。

搭建项目

新建一个空的Web项目，命名为NancyMusicStore，通过Nuget添加本实战用到的相关程序集。

在Package Manager Console窗口通过安装下面的package

Install-Package Nancy -Version 1.4.3

Install-Package Nancy.Hosting.Aspnet -Version 1.4.1

Install-Package Nancy.Viewengines.Razor -Version 1.4.3

Install-Package Nancy.Authentication.Forms -Version 1.4.1

Install-Package Dapper

Install-Package Npgsql -Version 3.1.9

相关package说明：

Nancy 这个就不用说了，Nancy框架的根

Nancy.Hosting.Aspnet 项目基于ASP.NET的宿主环境的

Nancy.Viewengines.Razor 项目用到的模板引擎，也是我们最熟悉的Razor

Nancy.Authentication.Forms 项目用到的身份认证组件，替代MVC MusicStore中的Membership

Dapper，轻量级ORM

Npgsql，访问pg的驱动

添加了不少有用的东西，自然也要干掉不少没有用的东西！！

移除掉没有用到的DLL引用，具体剩下的如下图所示：



可以看到引用十分简洁！

在项目新建两个文件夹，Content和Scripts，把需的资源文件从MVC MUSICSTORE中添加进来。

其中Content文件夹只需要下面的几个：



Scripts文件夹只需要下面两个：



本地的静态资源文件，不是简单的引用就能够使用的。还要在启动器中对静态资源文件的访问支持，如果不添加，资源文件就会报404的错误。

所以我们要建个启动器类：CustomBootstrapper，具体内容如下：

using Nancy;
using Nancy.Authentication.Forms;
using Nancy.Bootstrapper;
using Nancy.Conventions;
using Nancy.Session;
using Nancy.TinyIoc;
using NancyMusicStore.Common;

namespace NancyMusicStore
{
public class CustomBootstrapper : DefaultNancyBootstrapper
{
protected override void ApplicationStartup(TinyIoCContainer container,IPipelines pipelines)
{
//Prevent errors on Linux
StaticConfiguration.DisableErrorTraces = false;
}

protected override void ConfigureApplicationContainer(TinyIoCContainer container)
{
base.ConfigureApplicationContainer(container);
}

protected override void ConfigureConventions(NancyConventions conventions)
{
base.ConfigureConventions(conventions);
conventions.StaticContentsConventions.Add(StaticContentConventionBuilder.AddDirectory("Scripts"));
conventions.StaticContentsConventions.Add(StaticContentConventionBuilder.AddDirectory("Content"));
}
}
}

下面就建立相应的数据模型与数据库的表映射：



数据和模型都有了，下面就在web.config中添加pg的连接字符串：

<connectionStrings>
<add name="pgsqlConn" connectionString="Host=127.0.0.1;Username=dev;Password=123456;Database=nancymusicstore;" />
</connectionStrings>

同时在项目新建一个Common文件夹，在里面添加两个公共的操作类，一个是对Dapper的简单封装DBHelper，另一个是对配置文件的封装ConfigHelper。

首先是ConfigHelper：

using System.Configuration;

namespace NancyMusicStore.Common
{
public class ConfigHelper
{
public static string GetAppSettingByKey(string key)
{
return ConfigurationManager.AppSettings[key].ToString();
}

public static string GetConneectionStr()
{
return ConfigurationManager.ConnectionStrings["pgsqlConn"].ConnectionString.ToString();
}
}
}

包含两个方法，一个读取appsetting的方法，一个是读取连接字符串的方法。主要是用了System.Configuration来处理。

然后是DBHelper：

using Dapper;
using Npgsql;
using System.Collections.Generic;
using System.Linq;
using System.Data;

namespace NancyMusicStore.Common
{
public class DBHelper
{
//open connection
private static IDbConnection OpenConnection()
{
var conn = new NpgsqlConnection(ConfigHelper.GetConneectionStr());
conn.Open();
return conn;
}

//execute
public static int Execute(string sql, object param = null, IDbTransaction transaction = null,
int? commandTimeout = null, CommandType? commandType = null)
{
using (var conn = OpenConnection())
{
return conn.Execute(sql, param, transaction, commandTimeout, commandType);
}
}

//execute
public static object ExecuteScalar(string cmd, object param = null, IDbTransaction transaction = null,
int? commandTimeout = null, CommandType? commandType = null)
{
using (var conn = OpenConnection())
{
return conn.ExecuteScalar(cmd, param, transaction, commandTimeout, commandType);
}
}

//do query and return a list
public static IList<T> Query<T>(string sql, object param = null, IDbTransaction transaction = null,
bool buffered = true, int? commandTimeout = null, CommandType? commandType = null) where T : class
{
using (var conn = OpenConnection())
{
return conn.Query<T>(sql, param, transaction, buffered, commandTimeout, commandType).ToList();
}
}

//do query and return the first entity
public static T QueryFirstOrDefault<T>(string sql, object param = null, IDbTransaction transaction = null,
int? commandTimeout = null, CommandType? commandType = null) where T : class
{
using (var conn = OpenConnection())
{
return conn.QueryFirstOrDefault<T>(sql, param, transaction, commandTimeout, commandType);
}
}
}
}

这里只是对Dapper加了一层封装，其实是可有可无的，是为了Module里面的代码比较简洁才加的。

而且案例调用的全部是存储过程，在项目代码中看不到SQL语句，只能看到存储过程的名字。

至此，我们的准备工作和项目已经搭建好了！

下一篇将开始打造我们NancyMusicStore的首页了！

本文也已经同步到 Nancy之大杂烩