ORM 实例教程

时间  2019-11-12
标签 orm 实例 教程 栏目 Java 繁體版
原文   原文链接

1、概述

面向对象编程和关系型数据库，都是目前最流行的技术，可是它们的模型是不同的。javascript

面向对象编程把全部实体当作对象（object），关系型数据库则是采用实体之间的关系（relation）链接数据。很早就有人提出，关系也能够用对象表达，这样的话，就能使用面向对象编程，来操做关系型数据库。html

简单说，ORM 就是经过实例对象的语法，完成关系型数据库的操做的技术，是"对象-关系映射"（Object/Relational Mapping） 的缩写。java

ORM 把数据库映射成对象。git

  • 数据库的表（table） --> 类（class）
  • 记录（record，行数据）--> 对象（object）
  • 字段（field）--> 对象的属性（attribute）

举例来讲，下面是一行 SQL 语句。github

SELECT id, first_name, last_name, phone, birth_date, sex
 FROM persons 
 WHERE id = 10

程序直接运行 SQL，操做数据库的写法以下。sql

res = db.execSql(sql);
name = res[0]["FIRST_NAME"];

改为 ORM 的写法以下。数据库

p = Person.get(10);
name = p.first_name;

一比较就能够发现，ORM 使用对象，封装了数据库操做，所以能够不碰 SQL 语言。开发者只使用面向对象编程，与数据对象直接交互，不用关心底层数据库。npm

总结起来，ORM 有下面这些优势。编程

  • 数据模型都在一个地方定义，更容易更新和维护，也利于重用代码。
  • ORM 有现成的工具，不少功能均可以自动完成，好比数据消毒、预处理、事务等等。
  • 它迫使你使用 MVC 架构，ORM 就是自然的 Model，最终使代码更清晰。
  • 基于 ORM 的业务代码比较简单，代码量少，语义性好，容易理解。
  • 你没必要编写性能不佳的 SQL。

可是，ORM 也有很突出的缺点。数组

  • ORM 库不是轻量级工具，须要花不少精力学习和设置。
  • 对于复杂的查询，ORM 要么是没法表达，要么是性能不如原生的 SQL。
  • ORM 抽象掉了数据库层，开发者没法了解底层的数据库操做，也没法定制一些特殊的 SQL。

2、命名规定

许多语言都有本身的 ORM 库，最典型、最规范的实现公认是 Ruby 语言的 Active Record。Active Record 对于对象和数据库表的映射，有一些命名限制。

（1）一个类对应一张表。类名是单数，且首字母大写；表名是复数，且所有是小写。好比，表books对应类Book。

（2）若是名字是不规则复数，则类名依照英语习惯命名，好比，表mice对应类Mouse，表people对应类Person。

（3）若是名字包含多个单词，那么类名使用首字母所有大写的骆驼拼写法，而表名使用下划线分隔的小写单词。好比，表book_clubs对应类BookClub，表line_items对应类LineItem。

（4）每一个表都必须有一个主键字段，一般是叫作id的整数字段。外键字段名约定为单数的表名 + 下划线 + id，好比item_id表示该字段对应items表的id字段。

3、示例库

下面使用 OpenRecord 这个库，演示如何使用 ORM。

OpenRecord 是仿 Active Record 的，将其移植到了 JavaScript，并且实现得很轻量级，学习成本较低。我写了一个示例库，请将它克隆到本地。

$ git clone https://github.com/ruanyf/openrecord-demos.git

而后，安装依赖。

$ cd openrecord-demos
$ npm install

示例库里面的数据库，是从网上拷贝的 Sqlite 数据库。它的 Schema 图以下（PDF 大图下载）。

4、链接数据库

使用 ORM 的第一步，就是你必须告诉它，怎么链接数据库（完整代码看这里）。

// demo01.js
const Store = require('openrecord/store/sqlite3');

const store = new Store({
  type: 'sqlite3',
  file: './db/sample.db',
  autoLoad: true,
});

await store.connect();

链接成功之后，就能够操做数据库了。

5、Model

5.1 建立 Model

链接数据库之后，下一步就要把数据库的表，转成一个类，叫作数据模型（Model）。下面就是一个最简单的 Model（完整代码看这里）。

// demo02.js
class Customer extends Store.BaseModel {
}

store.Model(Customer);

上面代码新建了一个Customer类，ORM（OpenRecord）会自动将它映射到customers表。使用这个类就很简单。

// demo02.js
const customer = await Customer.find(1);
console.log(customer.FirstName, customer.LastName);

上面代码中，查询数据使用的是 ORM 提供的find()方法，而不是直接操做 SQL。Customer.find(1)表示返回id为1的记录，该记录会自动转成对象，customer.FirstName属性就对应FirstName字段。

5.2 Model 的描述

Model 里面能够详细描述数据库表的定义，而且定义本身的方法（完整代码看这里）。

// demo03.js
class Customer extends Store.BaseModel {
  static definition(){
    this.attribute('CustomerId', 'integer', { primary: true });
    this.attribute('FirstName', 'string');
    this.attribute('LastName', 'string');
    this.validatesPresenceOf('FirstName', 'LastName');
  }

  getFullName(){
    return this.FirstName + ' ' + this.LastName;
  }
}

上面代码告诉 Model，CustomerId是主键，FirstName和LastName是字符串，而且不得为null，还定义了一个getFullName()方法。

实例对象能够直接调用getFullName()方法。

// demo03.js
const customer = await Customer.find(1);
console.log(customer.getFullName());

6、CRUD 操做

数据库的基本操做有四种：create（新建）、read（读取）、update（更新）和delete（删除），简称 CRUD。

ORM 将这四类操做，都变成了对象的方法。

6.1 查询

前面已经说过，find()方法用于根据主键，获取单条记录（完整代码看这里）或多条记录（完整代码看这里）。

// 返回单条记录
// demo02.js
Customer.find(1)

// 返回多条记录
// demo05.js
Customer.find([1, 2, 3])

where()方法用于指定查询条件（完整代码看这里）。

// demo04.js
Customer.where({Company: 'Apple Inc.'}).first()

若是直接读取类，将返回全部记录。

// 返回全部记录
const customers = await Customer;

可是，一般不须要返回全部记录，而是使用limit(limit[, offset])方法指定返回记录的位置和数量（完整代码看这里）。

// demo06.js
const customers = await Customer.limit(5, 10);)

上面的代码制定从第10条记录开始，返回5条记录。

6.2 新建记录

create()方法用于新建记录（完整代码看这里）。

// demo12.js
Customer.create({
  Email: 'president@whitehouse.gov',
  FirstName: 'Donald',
  LastName: 'Trump',
  Address: 'Whitehouse, Washington'
})

6.3 更新记录

update()方法用于更新记录（完整代码看这里）。

// demo13.js
const customer = await Customer.find(60);
await customer.update({
  Address: 'Whitehouse'
});

6.4 删除记录

destroy()方法用于删除记录（完整代码看这里）。

// demo14.js
const customer = await Customer.find(60);
await customer.destroy();

7、关系

7.1 关系类型

表与表之间的关系（relation），分红三种。

  • 一对一（one-to-one）：一种对象与另外一种对象是一一对应关系，好比一个学生只能在一个班级。
  • 一对多（one-to-many）： 一种对象能够属于另外一种对象的多个实例，好比一张唱片包含多首歌。
  • 多对多（many-to-many）：两种对象彼此都是"一对多"关系，好比一张唱片包含多首歌，同时一首歌能够属于多张唱片。

7.2 一对一关系

设置"一对一关系"，须要设置两个 Model。举例来讲，假定顾客（Customer）和发票（Invoice）是一对一关系，一个顾客对应一张发票，那么须要设置Customer和Invoice这两个 Model。

Customer内部使用this.hasOne()方法，指定每一个实例对应另外一个 Model 的一个实例。

class Customer extends Store.BaseModel {
  static definition(){
    this.hasOne('invoices', {model: 'Invoice', from: 'CustomerId', to: 'CustomerId'});
  }
}

上面代码中，this.hasOne(name, option)的第一个参数是该关系的名称，能够随便起，只要引用的时候保持一致就能够了。第二个参数是关系的配置，这里只用了三个属性。

  • model：对方的 Model 名
  • from：当前 Model 对外链接的字段，通常是当前表的主键。
  • to：对方 Model 对应的字段，通常是那个表的外键。上面代码是Customer的CustomerId字段，对应Invoice的CustomerId字段。

而后，Invoice内部使用this.belongsTo()方法，回应Customer.hasOne()方法。

class Invoice extends Store.BaseModel {
  static definition(){
    this.belongsTo('customer', {model: 'Customer', from: 'CustomerId', to: 'CustomerId'});
  }
}

接下来，查询的时候，要用include(name)方法，将对应的 Model 包括进来。

const invoice = await Invoice.find(1).include('customer');
const customer = await invoice.customer;
console.log(customer.getFullName());

上面代码中，Invoice.find(1).include('customer')表示Invoice的第一条记录要用customer关系，将Customer这个 Model 包括进来。也就是说，能够从invoice.customer属性上，读到对应的那一条 Customer 的记录。

7.3 一对多关系

上一小节假定 Customer 和 Invoice 是一对一关系，可是实际上，它们是一对多关系，由于一个顾客能够有多张发票。

一对多关系的处理，跟一对一关系很像，惟一的区别就是把this.hasOne()换成this.hasMany()方法。从名字上就能看出，这个方法指定了 Customer 的一条记录，对应多个 Invoice（完整代码看这里）。

// demo08.js
class Customer extends Store.BaseModel {
  static definition(){
    this.hasMany('invoices', {model: 'Invoice', from: 'CustomerId', to: 'CustomerId'});
  }
}

class Invoice extends Store.BaseModel {
  static definition(){
    this.belongsTo('customer', {model: 'Customer', from: 'CustomerId', to: 'CustomerId'});
  }
}

上面代码中，除了this.hasMany()那一行，其余都跟上一小节彻底同样。

7.4 多对多关系

一般来讲，"多对多关系"须要有一张中间表，记录另外两张表之间的对应关系。好比，单曲Track和歌单Playlist之间，就是多对多关系：一首单曲能够包括在多个歌单，一个歌单能够包括多首单曲。数据库实现的时候，就须要一张playlist_track表来记录单曲和歌单的对应关系。

所以，定义 Model 就须要定义三个 Model（完整代码看这里）。

// demo10.js
class Track extends Store.BaseModel{
  static definition() {
    this.hasMany('track_playlists', { model: 'PlaylistTrack', from: 'TrackId', to: 'TrackId'});
    this.hasMany('playlists', { model: 'Playlist', through: 'track_playlists' });
  }
}

class Playlist extends Store.BaseModel{
  static definition(){
    this.hasMany('playlist_tracks', { model: 'PlaylistTrack', from: 'PlaylistId', to: 'PlaylistId' });
    this.hasMany('tracks', { model : 'Track', through: 'playlist_tracks' });
  }
}

class PlaylistTrack extends Store.BaseModel{
  static definition(){
    this.tableName = 'playlist_track';
    this.belongsTo('playlists', { model: 'Playlist', from: 'PlaylistId', to: 'PlaylistId'});
    this.belongsTo('tracks', { model: 'Track', from: 'TrackId', to: 'TrackId'});
  }
}

上面代码中，Track这个 Model 里面，经过this.hasMany('playlists')指定对应多个歌单。但不是直接关联，而是经过through属性，指定中间关系track_playlists进行关联。因此，Track 也要经过this.hasMany('track_playlists')，指定跟中间表的一对多关系。相应地，PlaylistTrack这个 Model 里面，要用两个this.belongsTo()方法，分别跟另外两个 Model 进行链接。

查询的时候，不用考虑中间关系，就好像中间表不存在同样。

// demo10.js
const track = await Track.find(1).include('playlists');
const playlists = await track.playlists;
playlists.forEach(l => console.log(l.PlaylistId));

上面代码中，一首单曲对应多张歌单，因此track.playlists返回的是一个数组。

（完）

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程