【译】关系对象模型 typeorm 上

typeorm 有什么用？typeorm 以操作对象方法的方式与数据库交互，而不是像传统库(mysql)那样需要写 sql 语句。

本文主要说什么？Typeorm README.md 写的很长，往下拉可以看到 "Step-by-Step Guide" 标题，本文翻译这部分内容(非直译)，帮助新手一步步熟悉并使用 typeorm。（翻译时 typeorm 版本为 0.2.24。）

准备工作

初始化工程

$ mkdir test-typeorm
$ cd test-typeorm
$ npm init -y

安装依赖包

$ npm install typeorm --save
$ npm install reflect-metadata --save
$ npm install mysql --save
$ npm install typescript --save-dev
$ npm install @types/node --save-dev

typeorm、reflect-metadata 是使用 typeorm 必备依赖；
这里使用 mysql 数据库，所以还要安装 mysql 依赖；
要用到装饰器，typescript、@types/node 是使用 typescript 必备依赖。

搭建 ts 环境

创建 tsconfig.json 配置文件

$ npx tsc --init

修改 tsconfig.json 文件中部分属性

"outDir": "./dist",
"rootDir": "./src",
"strictPropertyInitialization": false,
"emitDecoratorMetadata": true,
"experimentalDecorators": true,

创建 src 目录，源码都写在该目录中，之后目录结构如下：

|-- test-typeorm
    |-- src
    |-- package.json
    |-- tsconfig.json

修改 package.json 文件：

"scripts": {
    "dev": "tsc -w"
}

测试

创建文件 src/test.ts，内容如下：

const greet: string = 'hello typeorm'
console.log(greet)

打开终端，执行 $ npm run dev，可以看到根目录下生成了 dist 目录，里面包含编译后的 js 文件。

另打开一个终端，执行 $ node dist/test.js，可以看到控制台打印出问候 "hello typeorm"。

至此，依赖包和环境搭建完成，下面开始进入正题，先来学习如何使用 typeorm 创建数据库表。

Typeorm 生成数据库表

创建 model

与数据库打交道的第一步是需要创建一张数据库表，TypeORM 怎么知道你要创建什么样的表呢？答案是通过 model 类，你的程序代码中的 model 类就是你的数据库表。

创建 src/entity/Photo.ts 文件，内容如下：

export class Photo {
    id: number;
    name: string;
    description: string;
    filename: string;
    views: number;
    isPublished: boolean;
}

你想往数据库里存一些照片，为了做到这个，你首先需要建一张数据库表，typeorm 会根据你的 model 类自动创建表，但并非所有的 models 类都可以创建表，只有那些实现了 entity 的 model 类才有这个特性。

此时您的目录结构如下：

|-- test-typeorm
    |-- src
        |-- entity
            |-- Photo.ts
    |-- package.json
    |-- tsconfig.json

创建 entity

为你的 model 类添加 @Entity 装饰器，只有符合这种规则的 model 类，typeorm 才会帮助你建表。

将我们的 Photo model 改造成 Photo entity。

import { Entity } from "typeorm";

@Entity()
export class Photo {
    id: number;
    name: string;
    description: string;
    filename: string;
    views: number;
    isPublished: boolean;
}

现在，表已经创立了，但是表中还没有字段，让我们为数据库表创建一些字段。

创建表字段

要为表添加字段，您只需要给 entity 类的属性值添加 @Column 装饰器。

import { Entity, Column } from "typeorm";

@Entity()
export class Photo {

    @Column()
    id: number;

    @Column()
    name: string;

    @Column()
    description: string;

    @Column()
    filename: string;

    @Column()
    views: number;

    @Column()
    isPublished: boolean;
}

现在，id、name、description、filename、views 和 isPublished 列已经被添加到 photo 表中了。数据库里的列类型会根据 entity 类中字段类型自动转换，例如：类中的 number 类型会转换为数据库列类型为 integer，string 转换为 varchar，boolean 转换为 bool 等等。您还可以设置 @Column() 装饰器的参数明确设置数据库列类型。

@Column('varchar2')
filename: string;

我们已经为数据库表添加了字段，但还有件事没有做，每张表应该有一个主键字段。

创建主键列

每个 Entity 类至少有一个主键字段，这是 typeorm 规定的，并且是不可避免的。使用 @PrimaryColumn 装饰器创建主键列。

import { Entity, Column, PrimaryColumn } from "typeorm";

@Entity()
export class Photo {

    @PrimaryColumn()
    id: number;

    @Column()
    name: string;

    @Column()
    description: string;

    @Column()
    filename: string;

    @Column()
    views: number;

    @Column()
    isPublished: boolean;
}

主键列只能保证 id 的值不能重复。

创建主键自生成字段

您已经创建了主键列，每次存数据时需要手动添加 id 字段的值，如果每次插值时想要自动生成主键值，使用 @PrimaryGeneratedColumn 装饰器代替 @PrimaryColumn 装饰器。

import { Entity, Column, PrimaryGeneratedColumn } from "typeorm";

@Entity()
export class Photo {

    @PrimaryGeneratedColumn('increment')    // 主键自增长
    // @PrimaryGeneratedColumn('uuid')      // 自动生成 uuid 作为主键：'0ae5e5c8-36f3-4b7b-84e4-c0b79cdfb1d1'
    id: number;

    @Column()
    name: string;

    @Column()
    description: string;

    @Column()
    filename: string;

    @Column()
    views: number;

    @Column()
    isPublished: boolean;
}

完善类类型

接下来，让我们完善数据库类类型。默认情况，string 被转换为 varchar 类型，长度自动设置为 255，number 被转换为 integer，我们不想要所有的列类型都被限制的太死板，让我们按实际情况来设置正确的列类型。

import { Entity, Column, PrimaryGeneratedColumn } from "typeorm";

@Entity()
export class Photo {

    @PrimaryGeneratedColumn()
    id: number;

    @Column({
        length: 100
    })
    name: string;

    @Column("text")
    description: string;

    @Column()
    filename: string;

    @Column("double")
    views: number;

    @Column()
    isPublished: boolean;
}

创建数据库连接

准备就绪，让我们尝试连接数据库。

创建 src/testConnect.ts 文件，内容：

import "reflect-metadata";
import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection({
    type: "mysql",
    host: "localhost",
    port: 3306,
    username: "root",
    password: "admin",
    database: "test",
    entities: [
        Photo    // <==== 将需要操作的 Entity 导入进来
    ],
    synchronize: true,
    logging: false
}).then(connection => {
    // here you can start to work with your entities
    console.log('数据库连接成功，做点什么吧~')
}).catch(error => console.log(error));

将数据库连接信息改成您自己数据库的相关值：host、port、username、password、database

在这个例子中我们使用 MySQL 数据库，您也可以自由选择使用其它数据库。要用其它数据库，只需要简单的修改 type 属性，值可以是：mysql、mariadb、sqlite、mssql、oracle 或 mongodb。

我们将 Photo Entity 类添加到此次连接中，您需要将使用的所有 Entity 都列出来。

设置 synchronize 属性为 true，确保每次运行应用时，您的 Entity 实体类将与数据库同步。
（译者注：Entity 中新增了一个字段或修改了字段的数据类型，每次启动应用，数据库表也会同步这些修改）

加载所有的 Entities

当我们创建更多 Entity 实体类时，需要我们每次都手动将 Entity 文件添加到配置中的 entities 属性，这很不方便，您可以直接导入整个 entity 目录。

import { createConnection } from "typeorm";

createConnection({
    type: "mysql",
    host: "localhost",
    port: 3306,
    username: "root",
    password: "admin",
    database: "test",
    entities: [
        __dirname + "/entity/*.js"   // <=== 将 entity 目录下所有文件全导进来
    ],
    synchronize: true,
}).then(connection => {
    // here you can start to work with your entities
    console.log('数据库连接成功，做点什么吧~')
}).catch(error => console.log(error));

（译者注：如果 Vscode 报错 __dirname 未定义，安装 @types/node 包即可解决。）

运行应用

执行 $ node dist/testConnect.js，数据库连接会被初始化，去查看您的数据库，photo 表格已经被创建了。

+-------------+--------------+----------------------------+
|                         photo                           |
+-------------+--------------+----------------------------+
| id          | int(11)      | PRIMARY KEY AUTO_INCREMENT |
| name        | varchar(100) |                            |
| description | text         |                            |
| filename    | varchar(255) |                            |
| views       | int(11)      |                            |
| isPublished | boolean      |                            |
+-------------+--------------+----------------------------+

Typeorm 增删改查

新增数据

让我们创建一张图片并保存到数据库中，创建 src/testPhotoCurd.ts 文件，内容如下：
（createConnection() 方法的连接数据库的参数和上面是一样样的，这里用 /.../ 替代）**

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(connection => {

    let photo = new Photo();
    photo.name = "Me and Bears";
    photo.description = "I am near polar bears";
    photo.filename = "photo-with-bears.jpg";
    photo.views = 1;
    photo.isPublished = true;

    return connection.manager
        .save(photo)
        .then(photo => {
            console.log("Photo has been saved. Photo id is", photo.id);
        });

}).catch(error => console.log(error));

执行 $ node dist/testPhotoCurd.js，查看数据库，已经生成一张照片数据了。

新增操作会自动生成 id，save() 方法返回的对象和你传给它的对象是同一个对象，唯一的区别是为 photo 对象设置了 id 字段值并返回。

使用 async/await 语法

使用 es8（es2017）的新语法 async/await 可以让代码更易读。

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    let photo = new Photo();
    photo.name = "Me and Bears";
    photo.description = "I am near polar bears";
    photo.filename = "photo-with-bears.jpg";
    photo.views = 1;
    photo.isPublished = true;

    await connection.manager.save(photo);
    console.log("Photo has been saved");

}).catch(error => console.log(error));

执行 $ node dist/testPhotoCurd.js，查看数据库又生成一条数据。
（下面如没有特别说明，代码都是写在 src/testPhotoCurd.ts 文件中）

使用 Entity Manager

前面使用 EntityManager 我们已经创建了两张图片并保存到数据库中。
使用 EntityManager，您可以操作应用中的任何 Entity 实体类，如下示例：

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    /*...*/
    let savedPhotos = await connection.manager.find(Photo);
    console.log("All photos from the db: ", savedPhotos);

}).catch(error => console.log(error));

savedPhotos 是从数据库取出来的 photo 对象组成的数组。

使用 Repositories

Repository 也可以做到 EntityManager 做的事，让我们使用 Repository 重构上面的代码。
当你要对同一个 Entity 做多次处理时，Repositories 会更加方便些。

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    let photo = new Photo();
    photo.name = "Me and Bears";
    photo.description = "I am near polar bears";
    photo.filename = "photo-with-bears.jpg";
    photo.views = 1;
    photo.isPublished = true;

    let photoRepository = connection.getRepository(Photo);

    await photoRepository.save(photo);     // <=== 操作1：保存数据
    console.log("Photo has been saved");

    let savedPhotos = await photoRepository.find();   // <=== 操作2：查询数据
    console.log("All photos from the db: ", savedPhotos);  

}).catch(error => console.log(error));

更新数据

首先从数据库把数据查出来，然后修改它的值。

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    /*...*/
    let photoRepository = connection.getRepository(Photo); 

    let photoToUpdate = await photoRepository.findOne(1);   // <=== 操作1：查询数据
    if (photoToUpdate !== undefined) {
        photoToUpdate.name = "Me, my friends and polar bears";
        await photoRepository.save(photoToUpdate);      // <=== 操作2：修改数据
    }

}).catch(error => console.log(error));

现在，id = 1 的数据被修改了。

删除数据

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    /*...*/
    let photoRepository = connection.getRepository(Photo);

    let photoToRemove = await photoRepository.findOne(1);   // <=== 操作1：查询数据
    if (photoToRemove !== undefined) {
        await photoRepository.remove(photoToRemove);        // <=== 操作2：修改数据
    }

}).catch(error => console.log(error));

现在，id = 1 的数据被删除了。

查询数据

import { createConnection } from "typeorm";
import { Photo } from "./entity/Photo";

createConnection(/*...*/).then(async connection => {

    /* 查询所有照片 */
    let allPhotos = await photoRepository.find();
    console.log("All photos from the db: ", allPhotos);

    /* 查询 id = 1 的第一条数据 */
    let firstPhoto = await photoRepository.findOne(1);
    console.log("First photo from the db: ", firstPhoto);

    /* 查询 name = 'Me and Bears' 的第一条数据 */
    let meAndBearsPhoto = await photoRepository.findOne({ name: "Me and Bears" });
    console.log("Me and Bears photo from the db: ", meAndBearsPhoto);

    /* 查询 views = 1 的所有数据 */
    let allViewedPhotos = await photoRepository.find({ views: 1 });
    console.log("All viewed photos: ", allViewedPhotos);

    /* 查询 isPublished = true 的所有数据 */
    let allPublishedPhotos = await photoRepository.find({ isPublished: true });
    console.log("All published photos: ", allPublishedPhotos);

    /* 查询数据和数目 */
    let [allPhotos, photosCount] = await photoRepository.findAndCount();
    console.log("All photos: ", allPhotos);
    console.log("Photos count: ", photosCount);

}).catch(error => console.log(error));

更复杂的查询数据

您可以使用 QueryBuilder 构建复杂的 sql 查询：

let photos = await connection
    .getRepository(Photo)
    .createQueryBuilder("photo") // first argument is an alias. Alias is what you are selecting - photos. You must specify it.
    .innerJoinAndSelect("photo.metadata", "metadata")
    .leftJoinAndSelect("photo.albums", "album")
    .where("photo.isPublished = true")
    .andWhere("(photo.name = :photoName OR photo.name = :bearName)")
    .orderBy("photo.id", "DESC")
    .skip(5)
    .take(10)
    .setParameters({ photoName: "My", bearName: "Mishka" })
    .getMany();

这条查询语句会检索已经发布的，照片名字是 "My" 或 "Mishka" 的照片。从数据库中下标为 5 的数据开始取（pagination offset），只取 10 条数据（pagination limit），检索到的数据按照 photo.id 倒序排列，photo 表左连接 albums 表，内连接 metadata 表查询。

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 203,271评论 5赞 476
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 85,275评论 2赞 380
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 150,151评论 0赞 336
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,550评论 1赞 273
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,553评论 5赞 365
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,559评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,924评论 3赞 395
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,580评论 0赞 257
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,826评论 1赞 297
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,578评论 2赞 320
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,661评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,363评论 4赞 318
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,940评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,926评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,156评论 1赞 259
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,872评论 2赞 349
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,391评论 2赞 342