【ASP.NET Web API教程】2.3.2 创建域模型-阿里云开发者社区

开发者社区> 杰克.陈> 正文

【ASP.NET Web API教程】2.3.2 创建域模型

简介: 原文:【ASP.NET Web API教程】2.3.2 创建域模型 Part 2: Creating the Domain Models 第2部分:创建域模型 本文引自:http://www.asp.
+关注继续查看
原文:【ASP.NET Web API教程】2.3.2 创建域模型

Part 2: Creating the Domain Models
第2部分:创建域模型

本文引自:http://www.asp.net/web-api/overview/creating-web-apis/using-web-api-with-entity-fram
ework/using-web-api-with-entity-framework,-part-2

Add Models
添加模型

There are three ways to approach Entity Framework:
有三种方式使用实体框架:

  • Database-first: You start with a database, and Entity Framework generates the code.
    Database-first(数据库先行):从一个数据库开始,然后实体框架生成相应代码。
  • Model-first: You start with a visual model, and Entity Framework generates both the database and code.
    Model-first(模型先行):先从一个可视化模型开始,然后实体框架生成数据库和代码。
  • Code-first: You start with code, and Entity Framework generates the database.
    Code-first(代码先行):先从代码开始,然后实体框架生成数据库。

We are using the code-first approach, so we start by defining our domain objects as POCOs (plain-old CLR objects). With the code-first approach, domain objects don't need any extra code to support the database layer, such as transactions or persistence. (Specifically, they do not need to inherit from the EntityObject class.) You can still use data annotations to control how Entity Framework creates the database schema.
我们打算使用code-first方法,因此,首先把域对象定义成POCO(plain-old CLR objects — 旧式无格式公共语言运行时(CLR)对象。很多人不太理解POCO对象,其实这种对象就像文本文件一样,是一种最简单、最原始、不带任何格式的对象。因此,在各种环境中最容易对这类对象进行处理,包括用各类语言进行处理 — 译者注)。利用code-first方法,域对象不需要任何附加代码去支持数据库层,如事务处理、持久化等。(特别是它们不需要继承于EntityObject类。)你仍可以使用数据注解(data annotation)对实体框架如何创建数据库方案进行控制。

Because POCOs do not carry any extra properties that describe database state, they can easily be serialized to JSON or XML. However, that does not mean you should always expose your Entity Framework models directly to clients, as we'll see later in the tutorial.
由于POCO不带描述数据库状态的任何附加属性,它们可以很容易地被序列化成JSON或XML。然而,这并不意味着你应当总是把实体框架模型直接暴露给客户端,就像我们稍后在本教程所看到的那样。

We will create the following POCOs:
我们将创建以下POCO:

  • Product
  • Order
  • OrderDetail

To create each class, right-click the Models folder in Solution Explorer. From the context menu, select Add and then select Class.
要创建每个类,在“解决方案资源管理器”中右击Models文件夹。从上下文菜单选择“添加”,然后选择“类”(如图2-14所示)。

WebAPI2-14

图2-14. 创建POCO类

Add a Product class with the following implementation:
用以下实现添加一个Product类(产品类):

namespace ProductStore.Models
{ using System.ComponentModel.DataAnnotations;
public class Product { [ScaffoldColumn(false)] public int Id { get; set; } [Required] public string Name { get; set; } public decimal Price { get; set; } public decimal ActualCost { get; set; } } }

By convention, Entity Framework uses the Id property as the primary key and maps it to an identity column in the database table. When you create a new Product instance, you won’t set a value for Id, because the database generates the value.
根据约定,实体框架用Id属性作为主键,并把它映射成数据库表中的标识列。当创建一个新的Product实例时,不必为Id设置值,因为数据库会生成它。

The ScaffoldColumn attribute tells ASP.NET MVC to skip the Id property when generating an editor form. The Required attribute is used to validate the model. It specifies that the Name property must be a non-empty string.
ScaffoldColumn(支架列)注解属性是告诉ASP.NET MVC,在生成编辑表单时,跳过这个Id属性。Required注解属性用于对模型进行验证。它指定Name属性必须是一个非空字符串。

注:本文把ScaffoldConlumn、Required等这一类英文中叫做Annotation Attribute的属性(Attribute)译为注解属性(Annotation Attribute),以便与类中的那些属性加以区别 — 译者注

Add the Order class:
添加Order类(订单类):

namespace ProductStore.Models 
{ 
    using System.Collections.Generic; 
    using System.ComponentModel.DataAnnotations;
public class Order { public int Id { get; set; } [Required] public string Customer { get; set; }
// Navigation property // 导航属性 public ICollection<OrderDetail> OrderDetails { get; set; } } }

Add the OrderDetail class:
添加OrderDetail类(订单细节类,或订单详情类):

namespace ProductStore.Models 
{ 
    public class OrderDetail 
    { 
        public int Id { get; set; } 
        public int Quantity { get; set; } 
        public int OrderId { get; set; } 
        public int ProductId { get; set; }
// Navigation properties // 导航属性 public Product Product { get; set; } public Order Order { get; set; } } }

Foreign Key Relations
外键关系

An order contains many order details, and each order detail refers to a single product. To represent these relations, the OrderDetail class defines properties named OrderId and ProductId. Entity Framework will infer that these properties represent foreign keys, and will add foreign-key constraints to the database.
一份订单包含很多订单细节,而每个订单细节指向一个单一的产品。为了表示这些关系,OrderDetail类定义了名称为OrderId和ProductId的属性。实体框架将会推断出这些属性表示的是外键,并会把外键约束添加到数据库(见图2-15)。

WebAPI2-15

图2-15. 外键关系

The Order and OrderDetail classes also include “navigation” properties, which contain references to the related objects. Given an order, you can navigate to the products in the order by following the navigation properties.
Order和OrderDetail类也包含了“导航(navigation)”属性,导航属性包含了对相关对象的引用。对于一份给定的订单,可以根据导航属性导航到这份订单的产品。

Compile the project now. Entity Framework uses reflection to discover the properties of the models, so it requires a compiled assembly to create the database schema.
现在,编译这个项目。实体框架会使用反射来发现这些模型的属性,因此它需要编译后的程序集来创建相应的数据库方案(这里的数据库方案意指数据库、表结构以及关系等数据库方面的定义 — 译者注)。

Configure the Media-Type Formatters
配置Media-Type格式化器

A media-type formatter is an object that serializes your data when Web API writes the HTTP response body. The built-in formatters support JSON and XML output. By default, both of these formatters serialize all objects by value.
media-type(媒体类型)格式化器是Web API书写HTTP响应体时对数据进行序列化的一个对象。内建的格式化器支持JSON和XML输出。默认地,这两种格式化都会按值序列化所有对象。

Serialization by value creates a problem if an object graph contains circular references. That's exactly the case with the Order and OrderDetail classes, because each holds a reference to the other. The formatter will follow the references, writing each object by value, and go in circles. Therefore, we need to change the default behavior.
如果对象图含有循环引用,按值序列化会出现问题。这恰好是Order类和OrderDetail类的情况,因为每一个都含有对另一个的引用。格式化器会遵循这些引用,按值写出每一个对象,于是会引起循环。因此,我们需要修改这种默认行为。

In Solution Explorer, expand the App_Start folder and open the file named WebApiConfig.cs. Add the following code to the WebApiConfig class:
在“解决方案资源管理器”中,展开App_Start文件夹,并打开名为WebApiConfig.cs的文件。将以下代码添加到这个WebApiConfig.cs类中(以下代码中的“新代码” — 译者注):

public static class WebApiConfig 
{ 
    public static void Register(HttpConfiguration config) 
    { 
        config.Routes.MapHttpRoute( 
            name: "DefaultApi", 
            routeTemplate: "api/{controller}/{id}", 
            defaults: new { id = RouteParameter.Optional } 
        );
// New code: // 新代码: var json = config.Formatters.JsonFormatter; json.SerializerSettings.PreserveReferencesHandling = Newtonsoft.Json.PreserveReferencesHandling.Objects;
config.Formatters.Remove(config.Formatters.XmlFormatter); } }

This code sets the JSON formatter to preserve object references, and removes the XML formatter from the pipeline entirely. (You can configure the XML formatter to preserve object references, but it's a little more work, and we only need JSON for this application. For more information, see Handling Circular Object References.)
这段代码把JSON格式化器设置为防止对象引用(“新代码”第二行的作用 — 译者注),并把XML格式化器从管线(指HTTP的请求处理管线 — 译者注)中完全删除(“新代码”最后一行的作用 — 译者注)。(你也可以把XML格式化器配置成防止对象引用,但这还要做一点工作,而对于这个应用程序,我们只需要JSON。更多信息参阅“处理循环对象引用”(本教程的第6部分 — 译者注)。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
windows批量创建用户
一、建立用户的命令行语法:   建立用户:net  user  用户名  密码  /add           (如:net user test 123 /add)  提升权限:net  localgroup 用户权限组 用户名 /add      (如:net localgroup admini...
673 0
[ASP.NET]二维码的创建
又好一段时间没有写写东西了,继续回归原来的模式,多做记录,最近要实现个unity的二维码方面的功能,首先就要解决生成二维码的问题,这个倒是有这方面的组件,然后我通过强大的反编译工具Reflector(想必.NET程序都知道的神器),来插件内部实现的原理。
886 0
IntelliJ IDEA 12 创建Web项目 教程 超详细版
原文:IntelliJ IDEA 12 创建Web项目 教程 超详细版 IntelliJ IDEA 12 新版本发布 第一时间去官网看了下  黑色的主题 很给力 大体使用了下  对于一开始就是用eclipse的童鞋们 估计很难从eclipse中走出来 当然 我也很艰难的走在路上 ... 首先要说一点,在IntelliJ IDEA里面“new Project” 就相当于我们eclipse的“workspace”,而“new Module”才是创建一个工程。
1030 0
Json.Net系列教程 3.Json.Net序列化和反序列化设置
原文 Json.Net系列教程 3.Json.Net序列化和反序列化设置 上节补充 首先补充一点,Json.Net是支持序列化和反序列化DataTable,DataSet,Entity Framework和NHibernate的.
759 0
Java 并发/多线程教程(七)-创建和启动java线程
      本系列译自jakob jenkov的Java并发多线程教程,个人觉得很有收获。由于个人水平有限,不对之处还望矫正! 创建和启动线程 在java中创建一个线程如下: Thread thread = new Thread(); 调用方法start()来启动一个线程: thread.start();         这个例子没有指定线程执行任何代码,线程将会在启动之后停止。
919 0
Json.Net系列教程 2.Net类型与JSON的映射关系
原文 Json.Net系列教程 2.Net类型与JSON的映射关系 首先谢谢大家的支持和关注.本章主要介绍.Net类型与JSON是如何映射的.我们知道JSON中类型基本上有三种:值类型,数组和对象.而.
808 0
+关注
杰克.陈
一个安静的程序猿~
9798
文章
2
问答
文章排行榜
最热
最新
相关电子书
更多
文娱运维技术
立即下载
《SaaS模式云原生数据仓库应用场景实践》
立即下载
《看见新力量:二》电子书
立即下载