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之大杂烩