初识ASP.NET Mvc5+EF7的奇妙之旅
话说今年微软是很给力的,win10算是吸引了大众的眼球了,而最新的.net5框架更是ok。
最新的.net5进行了开源,同时利用nuget以及node和bower进行了跨平台化;这意味这可以直接在mac或者linux上使用.net进行开发。
而最新的mvc5和ef框架也算是进行了换脸了,跟之前mvc4的项目都不一样,如果进行移植除了核心代码可以拷贝过来,其他的统统要重新来过。
最近准备改版一下网站,所以尝试了一把最新的框架;当然由于现在还是预览版所以改动什么的都超大,所以也走了不少弯路;特在此记录一下。
项目准备
工具:vs2015/visual studio code 2015
mvc5 vs 插件:最新的预览版为beta7
由于是beta7,而微软官方的说明文档和例子大部分可以适用,但是有些地方也是不对的,比如ef的命令,ef beta3 与 beta7差别很大,这也就是预览版的缺点,时不时的就改动了。
另外我这里使用的是vs2015而非visual studio code ,毕竟有好点的肯定就用好的啊。
开工
新建项目
打开vs,点击文件-新建-项目-web
这里起名叫做:musicbank,就是一个音乐店吧。
在这里我们来一个空的就好。我们来自己建立model/ef….
ok,项目建立好了后,我们看见的是这样的。
可以看见我们的项目其实是在 src 文件夹下面。而项目中除了引用+简单设置以外就没有任何东西。
环境搭配
项目有了,但是却并不能直接用,我们需要搭建环境,比如我们需要引入ef等等。
dependencies
打开文件“project.json” 我们修改dependencies部分为:
"dependencies": { "microsoft.aspnet.server.iis": "1.0.0-beta7", "microsoft.aspnet.server.weblistener": "1.0.0-beta7", "microsoft.aspnet.staticfiles": "1.0.0-beta7", "microsoft.aspnet.mvc": "6.0.0-beta7", "entityframework.commands": "7.0.0-beta7", "entityframework.sqlserver": "7.0.0-beta7", "microsoft.framework.configuration.json": "1.0.0-beta7", "microsoft.framework.configuration.usersecrets": "1.0.0-beta7" },
在这里添加了对mvc、ef、configuration的依赖。
mvc的作用主要用于控制器的解析等操作,包括了webapi。
ef当然就是数据库了。
configuration 用来读取本地配置,方便设置。
commands
打开文件“project.json” 我们修改commands部分为:
"commands": { "web": "microsoft.aspnet.hosting --config hosting.ini", "ef": "entityframework.commands" },
commands模块的主要作用是命令行执行,可简化操作,比如实际执行时输入 “ef” 即可代表 “entityframework.commands”。
model
ok,在这里我们先建立文件夹 models,随后我们在model文件夹上右键-添加-类:
artist
using system; using system.collections.generic; using system.componentmodel.dataannotations; using system.componentmodel.dataannotations.schema; namespace musicbank.models { public class artist { [key] [databasegeneratedattribute(databasegeneratedoption.identity)] public guid id { get; set; } [required] public string name { get; set; } [required] public int age { get; set; } public virtual list<audio> audio { get; set; } } }
一个歌唱家,有个名字和年龄,然后有n个歌曲。
audio
using system;
using system.componentmodel.dataannotations;
using system.componentmodel.dataannotations.schema;
namespace musicbank.models
{
public class audio
{
[key]
[databasegeneratedattribute(databasegeneratedoption.identity)]
public guid id { get; set; }
[required]
public string name { get; set; }
[required]
public int type { get; set; }
[required]
public string src { get; set; }
[required]
public guid artistid { get; set; }
public artist artist { get; set; }
}
}
歌曲也简化了,一个名字,一个类型,一个源文件,属于某个歌唱家。
musiccontext
这个想必大家不陌生吧,用于数据库的查询等操作就全靠这个了;算是ef的精髓。
using microsoft.data.entity; namespace musicbank.models { public class musiccontext : dbcontext { public dbset<audio> audio { get; set; } public dbset<artist> artists { get; set; } } }
这里只需要添加两个表就ok。
sampledata
为了方便,这里我直接在创建数据库的时候就进行数据的初始化工作,添加一些默认数据。
using microsoft.framework.dependencyinjection; using system; using system.linq; namespace musicbank.models { public class sampledata { public static void initialize(iserviceprovider serviceprovider) { var context = serviceprovider.getservice<musiccontext>(); if (context.database.ensurecreated()) { if (!context.artists.any()) { var austen = context.artists.add( new artist { name = "austen", age = 21 }).entity; var dickens = context.artists.add( new artist { name = "dickens", age = 25 }).entity; var cervantes = context.artists.add( new artist { name = "cervantes", age = 27 }).entity; context.audio.addrange( new audio() { name = "pride", type = 1, artist = austen, src = "pride.mp3" }, new audio() { name = "northanger", type = 2, artist = austen, src = "northanger.mp3" }, new audio() { name = "david", type = 3, artist = dickens, src = "david.mp3" }, new audio() { name = "donquixote", type = 1, artist = cervantes, src = "donquixote.mp3" } ); context.savechanges(); } } } } }
首先这是一个静态方法,需要传入一个“iserviceprovider”,这个可以在项目启动的时候调用。
在方法进入后我们获取到上面的“musiccontext”,然后我们进行数据库创建与数据添加工作。
if (context.database.ensurecreated())
这句主要用于判断是否需要进行数据库创建,如果是将进行创建,同时返回true,而后我们判断是否具有数据,如果数据库表为空,那么我们添加一些默认数据。
配置文件 config.json
在项目根目录添加文件:“config.json”在其中配置数据库链接字段如下:
{ "data": { "musicconnection": { "connectionstring": "server=(localdb)\\mssqllocaldb;database=musicbank-database;trusted_connection=true;multipleactiveresultsets=true" } } }
启动配置startup.cs
在项目启动的时候将会调用 startup.cs 中的相关方法进行数据的初始化操作。
在这里我们需要做三件事儿:
获取到配置config.json,在构造函数中完成
设置数据库文件连接,在configureservices方法中完成
初始化数据库相关数据,在configure方法中完成
using microsoft.aspnet.builder; using microsoft.aspnet.hosting; using microsoft.data.entity; using microsoft.dnx.runtime; using microsoft.framework.configuration; using microsoft.framework.dependencyinjection; using musicbank.models; namespace musicbank { public class startup { public startup(ihostingenvironment env, iapplicationenvironment appenv) { var builder = new configurationbuilder(appenv.applicationbasepath) .addjsonfile("config.json") .addjsonfile($"config.{env.environmentname}.json", optional: true); builder.addenvironmentvariables(); configuration = builder.build(); } public iconfigurationroot configuration { get; set; } public void configureservices(iservicecollection services) { services.addmvc(); services.addentityframework() .addsqlserver() .adddbcontext<musiccontext>(options => { options.usesqlserver(configuration["data:musicconnection:connectionstring"]); }); } public void configure(iapplicationbuilder app, ihostingenvironment env) { app.usestaticfiles(); app.usemvc(); sampledata.initialize(app.applicationservices); } } }
到这里我们的初始化操作基本完成了,现在来看看如何访问数据库数据了。
controllers
首先在根目录添加文件夹 controllers,右键-添加-新建项
在这里我就使用一个简单的webapi来进行数据演示了,后面会在文章中详细写写数据的渲染相关。
在文件 audiocontroller.cs 中,我们更改代码为:
using microsoft.aspnet.mvc; using musicbank.models; using system.collections.generic; using system.linq; namespace musicbank.controllers { [route("api/[controller]")] public class audiocontroller : controller { [fromservices] public musiccontext db { get; set; } [httpget] public ienumerable<audio> get() { return db.audio.tolist(); } [httpget("{name}")] public audio get(string name) { audio audio = db.audio.where(a => (a.name == name)).firstordefault(); return audio; } } }
一个属性,两个方法。
在这里我们可以看见 musiccontext 属性并没有初始化,但是下面却能直接调用;这是因为我们添加了一个属性“[fromservices]”,该属性意味着服务器能自动采用注解的方式对 db 进行赋值。
下面两个方法分别返回全部的音乐列表,和根据音乐名称返回音乐相关信息。
当然在两个方法上都有“[httpget]”属性,该属性指定了请求类型为 get 方式,当然也有其他几种,如:“httppost”“httpput”“httpdelete”等。
运行
在这里运行方式有两种,分别是 iis 与 web 命令行的方式。
iis
这种方式直接运行,vs将打开浏览器并设置端口。
web
还记得上面写到命令行的地方么?其中有这样一行:
"web": "microsoft.aspnet.hosting --config hosting.ini",
在这里我们启动时候的参数在“hosting.ini”文件中,我们打开 hosting.ini 文件。
server=microsoft.aspnet.server.weblistener server.urls=http://localhost:5000
可以找到我们访问的url,运行后把url拷贝到浏览器运行就ok。
运行情况下你会看见这样的窗口,可以看出其实是调用的dnx进行运行的程序。而 dnx 是可以跨平台的,这也就意味着可以直接在mac上跑起来。
这里写图片描述
效果
可以看出两个方法的接口调用结果是ok的。
初识asp.net mvc5+ef7的旅程到这里就结束了,希望可以为大家开启asp.net mvc5+ef7的又一个美妙旅程。