Asp.net Core基于MVC框架实现PostgreSQL操作
简单介绍
Asp.net Core最大的价值在于跨平台、跨平台、跨平台。重要的事情说三遍。但是目前毕竟是在开发初期，虽然推出了1.0.0 正式版，但是其实好多功能还没有完善。比方说编译时的一些文件编码问题，辅助工具Tools的一些Bug，还有一些好用的模板和平台实现尚未完成等一些问题。但这毕竟是一个好的开始，并且在Github上，大家都还在积极的完善，你也可以参与进来。地址：https://github.com/aspnet
Asp.net Core在学习的时候，首先你应该跟着微软官方的入门教材来学习，在这里: https://docs.asp.net/en/latest/tutorials/first-mvc-app/start-mvc.html。这个入门教材很浅显易懂的让你了解了Asp.net Core mvc框架以及entity framework core的用法。不过缺点是，使用的是Sql compact数据库，也就是SQL Server数据库。要知道，我们使用Asp.net 的主要目的是实现跨平台部署，所以数据库的选择上，首选肯定不是SqlServer，否则意义何在？当然，目前Entity Framework core暂时还不支持所有数据库。截止2016年7月，支持情况如下：
Database Providers
The following providers are available
- Microsoft SQL Server
- SQLite
- Npgsql (PostgreSQL)
- Microsoft SQL Server Compact Edition
- IBM Data Servers
- InMemory (for Testing)
- Devart (MySQL, Oracle, PostgreSQL, SQLite, DB2, SQL Server, and more)
- MySQL (Coming Soon)
- Oracle (Coming Soon)
所以提供给我们选择的数据库还是有限的（主要是不支持MySql，Devart这东西笔者不了解，不评论）。总得来说，对MS SQL Server的支持肯定是最好的，所以场景允许下，首选Sql server。其次，就DB2和PostgreSQL可选了。笔者不喜欢DB2（很多原因，主要是开发操作管理麻烦，并非说DB2本身存在问题），PostgreSQL其实也不太好用，不过谁叫他免费呢，肯定是好多国内公司首选。
PostgreSQL本身历史悠久，记得好像上世纪80年代就存在了，免费开源，而且是有专门社区维护。设计理念是以健壮性为首选，所以收到光打企业级平台欢迎。关于PostgreSQL和MySQL之间的优缺点，这个其实不太好说，MySQL在损失健壮性的同时，提高了性能，并且支持很多非标准新特性，而PostgreSQL在健壮性上，号称不弱于Oracle，性能优秀，完全支持SQL标准，所以其实并不差。
准备环境
Ubuntu Server（16.04）虚拟机1台，IP：192.168.1.6 预装了PostgreSQL数据库，并配置好防火墙，ssh连接等基础环境。确保能够外部访问。
VS2015 Update3
Putty 和SSH Secure File Transfer Client
服务器环境部署
参考之前的博客：http://blog.csdn.net/lanwilliam/article/details/51880124
开始
-
新建项目，选择Asp.net Core Web Application项目模板。
-
选择Web应用程序模板，然后修改身份验证哪里，选择不进行身份验证。
这里要说一下，Asp.net core项目中，包含一个Identity子项目，在GitHub上有介绍如下：
这里大家一看就知道了，这就是原来提供的ASP.net自带的权限框架。这个框架现在其实非常强大了，还支持Google和TWriter等OAuth用法，不过缺点是只支持SQL Server数据库。如果选择了个人用户账户，那么会默认使用这个框架创建项目。我们希望用PostgreSQL，所以不能选他，很遗憾。而且目前创建控制器等一些内置模板用法，都是基于SqlServer，用到这个Identity，大家如果看过微软的GettingStarted，就会看到介绍，所以建议大家首先学习微软GettingStarted。
当然，不要勾选云中托管。
-
空白项目结构
上图是新建完成的空白项目结构，你会发现Models，Data等文件夹都不存在，这里需要手动新建，并且丢进去一个class。
必须要丢进去个class文件，让类定义的时候声明出Models和Data的命名空间，否则待会生成models文件的时候会报错。
-
增加项目引用
Asp.net core项目有两种方法增加引用，一种是直接修改project.json，另一种是nuget。
上述方法打开控制台
输入如下命令
会发现最后的Tools安装不了，可能nuget没同步过来，可以在project.json中手动添加。
最后的文件如下：
主要是圈选中的部分。可以看到这里我们用来操作PostgreSQL的Provider是Npgsql，这是aspnet下的一个子项目。可以在github找到。
其他EntityFrameworkCore的引用，是从示例项目中搬来的。
-
生成Models文件
这里要说明一下，微软MVC教程中时使用的模板创建的Controller，他会自动创建ApplicationDBContext和对应的Views视图文件，以及一些其他的内容。因为他更新了ApplicationDBContext文件和ApplicationDbContextModelSnapshot文件，所以控制台执行dotnet ef命令才会正常完成，这里无法用到这些方法。因为没选"个人用户账户"，这里请自行尝试。
dotnet ef migrations add Initial
dotnet ef database update
由于自行写DBContext类实现太麻烦，我们这里采取开发中常用的办法，首先设计数据库，然后根据数据库生成类。
在数据库新建表如下：（测试用，看看就好）
然后回到VS2015，在Nuget程序包控制台输入：
Scaffold-DbContext "Server=192.168.1.6;Database=testdb;User ID=test;Password=test;" Npgsql.EntityFrameworkCore.PostgreSQL -OutputDir Models
这个命令不用解释了吧？数据库连接，使用的数据库provider和输出目录。
顺利完成的话,Models下会出现几个类文件。
如果报错的话，请根据错误提示进行处理。处理原则，首先保证程序能够编译通过，然后确保Models下面没有存在本次要生成的同名文件，然后确认目前系统没有其他DBContext存在。现在dotnet core的好多工具都在完善中，健壮性都有待提高。
打开看看生成的文件：
using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata;
namespace PostgresSqlDemo.Models
{
public partial class testdbContext : DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
#warning To protect potentially sensitive information in your connection string, you should move it out of source code. See http://go.microsoft.com/fwlink/?LinkId=723263 for guidance on storing connection strings.
optionsBuilder.UseNpgsql(@"Server=192.168.1.6;Database=testdb;User ID=test;Password=test;");
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Blog>(entity =>
{
entity.ToTable("blog");
entity.Property(e => e.Id)
.HasColumnName("id")
.ValueGeneratedNever();
entity.Property(e => e.Title)
.IsRequired()
.HasColumnName("title")
.HasColumnType("varchar")
.HasMaxLength(300);
entity.Property(e => e.Url)
.IsRequired()
.HasColumnName("url")
.HasColumnType("varchar")
.HasMaxLength(300);
});
modelBuilder.Entity<TbUser>(entity =>
{
entity.HasKey(e => e.Userid)
.HasName("PK_tb_user");
entity.ToTable("tb_user");
entity.Property(e => e.Userid)
.HasColumnName("userid")
.ValueGeneratedNever();
entity.Property(e => e.Age).HasColumnName("age");
entity.Property(e => e.Name)
.IsRequired()
.HasColumnName("name")
.HasColumnType("varchar")
.HasMaxLength(30);
});
}
public virtual DbSet<Blog> Blog { get; set; }
public virtual DbSet<TbUser> TbUser { get; set; }
}
}
Entityframework中，默认是一个数据库使用唯一一个DBContext类进行管理。
-
修改DBContext文件
模板已经提示给你，需要修改这部分代码，实现动态配置连接的目的。
进行如下修改：
注释掉OnConfiguring方法，增加构造函数，我们把注册放到Startup中去完成。
-
添加数据库连接配置项
打开appsetting.json文件，增加如下配置：
其实这就相当于原来asp.net中的Web.config中的ConnectionStrings。
-
注册DBContext
打开StartUP.cs 文件，找到ConfigureServices方法，添加选中代码：
到这里就看明白了吧，注册DBContext，使用Npgsql，并给出数据库连接字符串。
-
增加控制器Controller
在Controller文件夹下新建Controller文件，并添加如下代码：
using Microsoft.AspNetCore.Mvc;
using PostgresSqlDemo.Data;
using PostgresSqlDemo.Models;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
namespace PostgresSqlDemo.Controllers
{
public class TbUserController : Controller
{
private readonly testdbContext _context;
public TbUserController(testdbContext context)
{
_context = context;
}
// GET: tbusers
public async Task<IActionResult> Index()
{
return View(await _context.TbUser.ToListAsync());
}
public async Task<IActionResult> Details(Guid? id)
{
if (id == null)
{
return NotFound();
}
var tbuser = await _context.TbUser.SingleOrDefaultAsync(m => m.Userid == id);
if (tbuser == null)
{
return NotFound();
}
return View(tbuser);
}
// GET: tbusers/Create
public IActionResult Create()
{
return View();
}
// POST: tbusers/Create
// To protect from overposting attacks, please enable the specific properties you want to bind to, for
// more details see http://go.microsoft.com/fwlink/?LinkId=317598.
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create([Bind("Userid,Name,Age")] TbUser tbuser)
{
if (ModelState.IsValid)
{
tbuser.Userid = Guid.NewGuid();
_context.Add(tbuser);
await _context.SaveChangesAsync();
return RedirectToAction("Index");
}
return View(tbuser);
}
// GET: tbusers/Edit/5
public async Task<IActionResult> Edit(Guid? id)
{
if (id == null)
{
return NotFound();
}
var tbuser = await _context.TbUser.SingleOrDefaultAsync(m => m.Userid == id);
if (tbuser == null)
{
return NotFound();
}
return View(tbuser);
}
// POST: tbusers/Edit/5
// To protect from overposting attacks, please enable the specific properties you want to bind to, for
// more details see http://go.microsoft.com/fwlink/?LinkId=317598.
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(Guid id, [Bind("Userid,Name,Age")] TbUser tbuser)
{
if (id != tbuser.Userid)
{
return NotFound();
}
if (ModelState.IsValid)
{
try
{
_context.Update(tbuser);
await _context.SaveChangesAsync();
}
catch (DbUpdateConcurrencyException)
{
if (!tbuserExists(tbuser.Userid))
{
return NotFound();
}
else
{
throw;
}
}
return RedirectToAction("Index");
}
return View(tbuser);
}
// GET: tbusers/Delete/5
public async Task<IActionResult> Delete(Guid? id)
{
if (id == null)
{
return NotFound();
}
var tbuser = await _context.TbUser.SingleOrDefaultAsync(m => m.Userid == id);
if (tbuser == null)
{
return NotFound();
}
return View(tbuser);
}
// POST: tbusers/Delete/5
[HttpPost, ActionName("Delete")]
[ValidateAntiForgeryToken]
public async Task<IActionResult> DeleteConfirmed(Guid id)
{
var tbuser = await _context.TbUser.SingleOrDefaultAsync(m => m.Userid == id);
_context.TbUser.Remove(tbuser);
await _context.SaveChangesAsync();
return RedirectToAction("Index");
}
private bool tbuserExists(Guid id)
{
return _context.TbUser.Any(e => e.Userid == id);
}
}
}
如果你看过Getting Started Asp.net core MVC的话，相信应该能够看懂，基本是把使用新增Controller模板生成的方法修改了一下拿过来用了。
Asp.net core mvc中，默认路由名成为（name）Controller，所以我们这里叫TbUserController，访问的时候是http://youip/TbUser这样。并且默认是触发Index方法。
Controller中，每个方法，都相当于一个客户端Form的Action。没有特殊声明的方法，默认为HttpGet，可以直接请求。需要Post数据的，请手动增加[HttpPost]声明。
Async是C# 5.0后提供的关键字，是自动实现一个异步的方法，需要配合await关键字使用。Await会被自动转换为一个async的异步请求，后面的代码，会被自动放到completed方法中执行。这样处理能够极大的提高服务器的并发性能，具体请自行学习。
-
增加Views页面
增加对应的页面如下：
Index.cshtml
@model IEnumerable
@{
ViewData["Title"] = "Index";
}
<h2>Indexh2>
<p>
<a asp-action="Create">Create Newa>
p>
<table class="table">
<thead>
<tr>
<th>
@Html.DisplayNameFor(model => model.Userid)
th>
<th>
@Html.DisplayNameFor(model => model.Name)
th>
<th>
@Html.DisplayNameFor(model => model.Age)
th>
<th>th>
tr>
thead>
<tbody>
@foreach (var item in Model)
{
<tr>
<td>
@Html.DisplayFor(modelItem => item.Userid)
td>
<td>
@Html.DisplayFor(modelItem => item.Name)
td>
<td>
@Html.DisplayFor(modelItem => item.Age)
td>
<td>
<a asp-action="Edit" asp-route-id="@item.Userid">Edita> |
<a asp-action="Details" asp-route-id="@item.Userid">Detailsa> |
<a asp-action="Delete" asp-route-id="@item.Userid">Deletea>
td>
tr>
}
tbody>
table>
Create.cshtml
@model PostgresSqlDemo.Models.TbUser
@{
ViewData["Title"] = "Create";
}
<h2>Createh2>
<form asp-action="Create">
<div class="form-horizontal">
<h4>TbUserh4>
<hr />
<div asp-validation-summary="ModelOnly" class="text-danger">div>
<div class="form-group">
<label asp-for="Name" class="col-md-2 control-label">label>
<div class="col-md-10">
<input asp-for="Name" class="form-control" />
<span asp-validation-for="Name" class="text-danger" />
div>
div>
<div class="form-group">
<label asp-for="Age" class="col-md-2 control-label">label>
<div class="col-md-10">
<input asp-for="Age" class="form-control" />
<span asp-validation-for="Age" class="text-danger" />
div>
div>
<div class="form-group">
<div class="col-md-offset-2 col-md-10">
<input type="submit" value="Create" class="btn btn-default" />
div>
div>
div>
form>
<div>
<a asp-action="Index">Back to Lista>
div>
@section Scripts {
@{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}
Delete.cshtml
@model PostgresSqlDemo.Models.TbUser
@{
ViewData["Title"] = "Delete";
}
<h2>Deleteh2>
<h3>Are you sure you want to delete this?h3>
<div>
<h4>Blogh4>
<hr />
<dl class="dl-horizontal">
<dt>
@Html.DisplayNameFor(model => model.Userid)
dt>
<dd>
@Html.DisplayFor(model => model.Userid)
dd>
<dt>
@Html.DisplayNameFor(model => model.Name)
dt>
<dd>
@Html.DisplayFor(model => model.Name)
dd>
<dt>
@Html.DisplayNameFor(model => model.Age)
dt>
<dd>
@Html.DisplayFor(model => model.Age)
dd>
dl>
<form asp-action="Delete">
<div class="form-actions no-color">
<input type="submit" value="Delete" class="btn btn-default" /> |
<a asp-action="Index">Back to Lista>
div>
form>
div>
Details.cshtml
@model PostgresSqlDemo.Models.TbUser
@{
ViewData["Title"] = "Details";
}
<h2>Detailsh2>
<div>
<h4>Blogh4>
<hr />
<dl class="dl-horizontal">
<dt>
@Html.DisplayNameFor(model => model.Userid)
dt>
<dd>
@Html.DisplayFor(model => model.Userid)
dd>
<dt>
@Html.DisplayNameFor(model => model.Name)
dt>
<dd>
@Html.DisplayFor(model => model.Name)
dd>
<dt>
@Html.DisplayNameFor(model => model.Age)
dt>
<dd>
@Html.DisplayFor(model => model.Age)
dd>
dl>
div>
<div>
<a asp-action="Edit" asp-route-id="@Model.Userid">Edita> |
<a asp-action="Index">Back to Lista>
div>
Edit.cshtml
@model PostgresSqlDemo.Models.TbUser
@{
ViewData["Title"] = "Edit";
}
<h2>Edith2>
<form asp-action="Edit">
<div class="form-horizontal">
<h4>Blogh4>
<hr />
<div asp-validation-summary="ModelOnly" class="text-danger">div>
<input type="hidden" asp-for="Userid" />
<div class="form-group">
<label asp-for="Name" class="col-md-2 control-label">label>
<div class="col-md-10">
<input asp-for="Name" class="form-control" />
<span asp-validation-for="Name" class="text-danger" />
div>
div>
<div class="form-group">
<label asp-for="Age" class="col-md-2 control-label">label>
<div class="col-md-10">
<input asp-for="Age" class="form-control" />
<span asp-validation-for="Age" class="text-danger" />
div>
div>
<div class="form-group">
<div class="col-md-offset-2 col-md-10">
<input type="submit" value="Save" class="btn btn-default" />
div>
div>
div>
form>
<div>
<a asp-action="Index">Back to Lista>
div>
@section Scripts {
@{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}
-
增加验证脚本引用View文件
<environment names="Development">
<script src="~/lib/jquery-validation/dist/jquery.validate.js">script>
<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js">script>
environment>
<environment names="Staging,Production">
<script src="https://ajax.aspnetcdn.com/ajax/jquery.validate/1.14.0/jquery.validate.min.js"
asp-fallback-src="~/lib/jquery-validation/dist/jquery.validate.min.js"
asp-fallback-test="window.jQuery && window.jQuery.validator">
script>
<script src="https://ajax.aspnetcdn.com/ajax/jquery.validation.unobtrusive/3.2.6/jquery.validate.unobtrusive.min.js"
asp-fallback-src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"
asp-fallback-test="window.jQuery && window.jQuery.validator && window.jQuery.validator.unobtrusive">
script>
environment>
-
修改Layout.cshtml文件
增加如上两个连接。Blog的添加参考TbUser。这里主要是想让大家看出来DBContext的用法，所以特意弄了两个实体类。
-
然后vs里面可以运行了，效果如下：
这里没有改默认的页面。
再看我们加的页面。
并且asp.net mvc默认使用了bootstrap，所以我们可以用chrome的手机模式看看。
-
改成中文显示
改一下TbUser.cs
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
namespace PostgresSqlDemo.Models
{
public partial class TbUser
{
[Display(Name = "用户编号")]
public Guid Userid { get; set; }
[Display(Name = "用户姓名")]
public string Name { get; set; }
[Display(Name = "用户年龄")]
public int? Age { get; set; }
}
}
再看看页面
- 加一下验证
改成中文验证
[Display(Name = "用户姓名")]
[StringLength(10, MinimumLength = 3,ErrorMessage = "字段{0}长度不能小于3，总长度不能大于10")]
[Required]
public string Name { get; set; }
-
最后就是部署到Ubuntu服务器了。
将WebApp项目发布出来，使用SSH Secure File Transfer上传到服务器，然后参照前文发布。
前文：http://blog.csdn.net/lanwilliam/article/details/51880124
总结：
Asp.net Core 目前来说功能性还不完善，暂时不建议大型应用往上迁移，但是如果是小型项目，比较简单，可以在仔细论证后尝试使用。注意仔细论证，因为目前.net core并不是所有类库都能够实现跨平台。简单来说，System.Drawing就无法使用，所以后台画水印就需要其他三方库，这个请自行仔细论证。不过小项目发布到linux虚拟机上面，确实可以省一笔钱。