TypeORM github: https://github.com/typeorm/typeorm
这篇译文是从TypeORM github上的使用说明上翻译过来的,已经提交PR并merge到库中了。
TypeORM是一个采用TypeScript编写的用于Node.js的优秀ORM框架,支持使用TypeScript或Javascript(ES5, ES6, ES7)开发。
目标是保持支持最新的Javascript特性来帮助开发各种用到数据库的应用 - 不管是轻应用还是企业级的。
TypeORM可以做到:
- 根据Models自动创建数据库Table
- 可以透明的insert/update/delete数据库对象
- 映射数据库table到javascript对象,映射table column到javascript对象属性
- 提供表的一对一,多对一,一对多,多对多关系处理
- 还有更多 ...
不同于其他的JavaScript ORM,TypeORM使用的是数据映射模式,可以很轻松的创建出松耦合、可伸缩、可维护的应用。
TypeORM可以帮助开发者专注于业务逻辑,而不用过于担心数据存储的问题。
TypeORM参考了很多其他优秀ORM的实现, 比如 Hibernate, Doctrine 和 Entity Framework.
安装
安装TypeORM:
npm install typeorm --save
需要安装依赖模块
reflect-metadata
:npm install reflect-metadata --save
在应用里全局引用一下:
- 比如在app.ts的入口处
require("reflect-metadata")
- 比如在app.ts的入口处
安装数据库驱动:
MySQL 或 MariaDB
npm install mysql --save
Postgres
npm install pg --save
SQLite
npm install sqlite3 --save
Microsoft SQL Server
npm install mssql --save
Oracle (experimental)
npm install oracledb --save
可以根据你的数据库选择安装上面的任意一个.
使用oracle驱动需要参考安装说明:地址.
TypeScript配置
确保你的TypeScript编译器的版本大于2.1,并且在tsconfig.json
开启下面设置:
- "emitDecoratorMetadata": true,
- "experimentalDecorators": true,
同时需要开启编译选项里的lib
下的es6
或者从@typings
安装es6-shim
Node.js 版本
TypeORM在Node.JS 4.0或以上版本上测试通过。
如果在应用启动过程中出错可以尝试升级node.js到最新版本。
在浏览器中使用WebSQL (试用)
TypeORM可以在浏览器环境中工作,并且试验性的支持WebSQL
如果在浏览器环境中使用TypeORM需要使用 npm i typeorm-browser
来替代 typeorm
.
更多相关可以参考这里和这个例子.
快速开始
在TypeORM中,数据库table都是从实体中创建。
所谓实体其实就是用装饰器@Table
装饰的一个model。
可以直接从数据库中得到包含数据的实体对象,并且可以通过实体进行数据库表的insert/update/remove。
来看看这个model entity/Photo.ts
:
- export class Photo {
- id: number;
- name: string;
- description: string;
- fileName: string;
- views: number;
- }
创建实体
现在把Model变成实体:
- import {Table} from "typeorm";
-
- @Table()
- export class Photo {
- id: number;
- name: string;
- description: string;
- fileName: string;
- views: number;
- isPublished: boolean;
- }
添加table列
已经有了一个table,每个table都有column.
现在来添加列.
可以使用装饰器@Column
来把model的属性变成列:
- import {Table, Column} from "typeorm";
-
- @Table()
- export class Photo {
-
- @Column()
- id: number;
-
- @Column()
- name: string;
-
- @Column()
- description: string;
-
- @Column()
- fileName: string;
-
- @Column()
- views: number;
-
- @Column()
- isPublished: boolean;
- }
创建一个主键列
很好, 现在ORM马上就可以在数据库中生成这个photo表,不过还漏了一个,每个table都必须要有主键列,所以要加上它。
可以用@PrimaryColumn
装饰器来标记一个主键列。
- import {Table, Column, PrimaryColumn} from "typeorm";
-
- @Table()
- export class Photo {
-
- @PrimaryColumn()
- id: number;
-
- @Column()
- name: string;
-
- @Column()
- description: string;
-
- @Column()
- fileName: string;
-
- @Column()
- views: number;
-
- @Column()
- isPublished: boolean;
- }
创建自增长/自生成/顺序化的列
如果你想创建自增长/自生成/顺序化的列,需要把column的type改成integer并且给主键列加上一个属性{ generated: true }
- import {Table, Column, PrimaryColumn} from "typeorm";
-
- @Table()
- export class Photo {
-
- @PrimaryColumn("int", { generated: true })
- id: number;
-
- @Column()
- name: string;
-
- @Column()
- description: string;
-
- @Column()
- fileName: string;
-
- @Column()
- views: number;
-
- @Column()
- isPublished: boolean;
- }
使用 @PrimaryGeneratedColumn
装饰器
现在photo表的id可能自动生成自动增长,不过还是有点麻烦,这个一个很常见的功能,所以有一个专门的装饰器@PrimaryGeneratedColumn
来实现相同的功能。
- import {Table, Column, PrimaryGeneratedColumn} from "typeorm";
-
- @Table()
- export class Photo {
-
- @PrimaryGeneratedColumn()
- id: number;
-
- @Column()
- name: string;
-
- @Column()
- description: string;
-
- @Column()
- fileName: string;
-
- @Column()
- views: number;
-
- @Column()
- isPublished: boolean;
- }
自定义列的数据类型
接下来让我们改一下列的数据类型。默认情况下,string类型的属性会映射到数据库里varchar(255)的数据类型,number则会映射到类似于float/double这样的数据类型(取决到是什么数据库)。
但是我们不想所有的列被限制在varchar或float之类,下面来改进:
- import {Table, Column, PrimaryGeneratedColumn} from "typeorm";
-
- @Table()
- export class Photo {
-
- @PrimaryGeneratedColumn()
- id: number;
-
- @Column({
- length: 500
- })
- name: string;
-
- @Column("text")
- description: string;
-
- @Column()
- fileName: string;
-
- @Column("int")
- views: number;
-
- @Column()
- isPublished: boolean;
- }
创建数据库连接
现在实体已经有了,接下来创建app.ts
并配置数据库连接:
- import "reflect-metadata";
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
-
- createConnection({
- driver: {
- type: "mysql",
- host: "localhost",
- port: 3306,
- username: "root",
- password: "admin",
- database: "test"
- },
- entities: [
- Photo
- ],
- autoSchemaSync: true,
- }).then(connection => {
- // 这里可以写实体操作相关的代码
- }).catch(error => console.log(error));
在例子里使用的是mysql,你也可以选择其他数据库,只需要简单修改driver选项里的数据库的类型就可以了,比如:
mysql, mariadb, postgres, sqlite, mssql or oracle.
同样可以修改host, port, username, password 以及database等设置.
把Photo实体加到数据连接的实体列表中,所有需要在这个连接下使用的实体都必须加到这个列表中。
autoSchemaSync
选项可以在应用启动时确保你的实体和数据库保持同步。
引用目录下的所有实体
接下来我们可能会创建更多的实体并把它们一一加到配置当中。
不过这样会比较麻烦,好在可以直接写上实体的目录,这样这个目录下的所有实体都可以在当前连接中被使用:
- import {createConnection} from "typeorm";
-
- createConnection({
- driver: {
- type: "mysql",
- host: "localhost",
- port: 3306,
- username: "root",
- password: "admin",
- database: "test"
- },
- entities: [
- __dirname + "/entity/*.js"
- ],
- autoSchemaSync: true,
- }).then(connection => {
- // here you can start to work with your entities
- }).catch(error => console.log(error));
启动应用
现在可以启动app.ts
,启动后可以发现数据库自动被初始化,并且Photo这个表也会创建出来。
- +-------------+--------------+----------------------------+
- | photo |
- +-------------+--------------+----------------------------+
- | id | int(11) | PRIMARY KEY AUTO_INCREMENT |
- | name | varchar(500) | |
- | description | text | |
- | filename | varchar(255) | |
- | views | int(11) | |
- | isPublished | boolean | |
- +-------------+--------------+----------------------------+
添加和插入photo
现在创建一个新的photo然后存到数据库:
- import {createConnection} from "typeorm";
-
- 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;
-
- connection.entityManager
- .persist(photo)
- .then(photo => {
- console.log("Photo has been saved");
- });
-
- }).catch(error => console.log(error));
使用async/await语法
现在利用TypeScript的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.entityManager.persist(photo);
- console.log("Photo has been saved");
-
- }).catch(error => console.log(error));
使用EntityManager
刚刚我们创建了一个新的photo并且存进数据库。使用EntityManager可以操作实体,现在用EntityManager
来把photo从数据库中取出来。
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
-
- createConnection(/*...*/).then(async connection => {
-
- /*...*/
- let savedPhotos = await connection.entityManager.find(Photo);
- console.log("All photos from the db: ", savedPhotos);
-
- }).catch(error => console.log(error));
savedPhotos 会从数据库中取到的是一个Photo对象的数组
使用Repositories
现在重构下代码,使用Repository
来代替EntityManage。每个实体都有自己的repository,可以对这个实体进行任何操作。
如果要对实体做很多操作,Repositories会比EntityManager更加方便。
- 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.persist(photo);
- console.log("Photo has been saved");
-
- let savedPhotos = await photoRepository.find();
- console.log("All photos from the db: ", savedPhotos);
-
- }).catch(error => console.log(error));
从数据库中取photos
现在来尝试用Repository做一些取数据方面的操作:
- 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);
-
- let firstPhoto = await photoRepository.findOneById(1);
- console.log("First photo from the db: ", firstPhoto);
-
- let meAndBearsPhoto = await photoRepository.findOne({ name: "Me and Bears" });
- console.log("Me and Bears photo from the db: ", meAndBearsPhoto);
-
- let allViewedPhotos = await photoRepository.find({ views: 1 });
- console.log("All viewed photos: ", allViewedPhotos);
-
- let allPublishedPhotos = await photoRepository.find({ isPublished: true });
- console.log("All published photos: ", allPublishedPhotos);
-
- let [allPhotos, photosCount] = await photoRepository.findAndCount();
- console.log("All photos: ", allPublishedPhotos);
- console.log("Photos count: ", allPublishedPhotos);
-
- }).catch(error => console.log(error));
更新photo
现在来从数据库中取出一个photo,修改并更新到数据库。
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
-
- createConnection(/*...*/).then(async connection => {
-
- /*...*/
- let photoToUpdate = await photoRepository.findOneById(1);
- photoToUpdate.name = "Me, my friends and polar bears";
- await photoRepository.persist(photoToUpdate);
-
- }).catch(error => console.log(error));
这个id = 1
的photo在数据库中就成功更新了.
删除photo
再来,从数据库中删除我们的photo:
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
-
- createConnection(/*...*/).then(async connection => {
-
- /*...*/
- let photoToRemove = await photoRepository.findOneById(1);
- await photoRepository.remove(photoToRemove);
-
- }).catch(error => console.log(error));
这个id = 1
的photo就在数据库中被移除了。
一对一关系
来创建与另一个类的一对一关系。
新建PhotoMetadata.ts用来存photo的元信息。
- import {Table, Column, PrimaryGeneratedColumn, OneToOne, JoinColumn} from "typeorm";
- import {Photo} from "./Photo";
-
- @Table()
- export class PhotoMetadata {
-
- @PrimaryGeneratedColumn()
- id: number;
-
- @Column("int")
- height: number;
-
- @Column("int")
- width: number;
-
- @Column()
- orientation: string;
-
- @Column()
- compressed: boolean;
-
- @Column()
- comment: string;
-
- @OneToOne(type => Photo)
- @JoinColumn()
- photo: Photo;
- }
这里我们用到了一个新的装饰器@OneToOne
,它可以用来在两个实体之间创建一对一关系。type => Photo
指示了我们想要连接的实体类名,这里因为TypeScript语言的支持原因不能直接用类名。
当然也可以使用() => Photo
,但是type => Photo
显得更有可读性。
Type变量本身并不包含任何东西。
我们同样使用了@JoinColumn
装饰器,这个装饰器可以指定一对一关系的拥有者。
关系可以是单向的或双向的,但是只有一方是拥有者,加个这个装饰器就表示关系是给这个表服务的。
现在运行app,会新创建一个table,这个table有一个连接photo的外键:
- +-------------+--------------+----------------------------+
- | photo `译者注:应该是PhotoMetadata` |
- +-------------+--------------+----------------------------+
- | id | int(11) | PRIMARY KEY AUTO_INCREMENT |
- | height | int(11) | |
- | width | int(11) | |
- | comment | varchar(255) | |
- | compressed | boolean | |
- | orientation | varchar(255) | |
- | photo | int(11) | FOREIGN KEY |
- +-------------+--------------+----------------------------+
存一个有一对一关系的对象
现在来创建一个photo,一个photo的元信息,并把它们已经连接起来。
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
- import {PhotoMetadata} from "./entity/PhotoMetadata";
-
- createConnection(/*...*/).then(async connection => {
-
- // 创建一个photo
- let photo = new Photo();
- photo.name = "Me and Bears";
- photo.description = "I am near polar bears";
- photo.filename = "photo-with-bears.jpg"
- photo.isPublished = true;
-
- // 创建一个photo的元信息
- let metadata = new PhotoMetadata();
- metadata.height = 640;
- metadata.width = 480;
- metadata.compressed = true;
- metadata.comment = "cybershoot";
- metadata.orientation = "portait";
- metadata.photo = photo; // 这里把两者连起来
-
- // 获取实体repositories
- let photoRepository = connection.getRepository(Photo);
- let metadataRepository = connection.getRepository(PhotoMetadata);
-
- // 先来把photo存到数据库
- await photoRepository.persist(photo);
-
- // photo存完了,再存下photo的元信息
- await metadataRepository.persist(metadata);
-
- // 搞定
- console.log("metadata is saved, and relation between metadata and photo is created in the database too");
-
- }).catch(error => console.log(error));
双向关系
关系可以是单向的或是双向的.
现在PhotoMetadata和Photo的关系是单向的,关系拥有者是PhotoMetadata,Photo并不知道PhotoMetadata,这样如果要想从Photo里得到PhotoMetadata的数据会比较麻烦。
现在来改变一下,把单向改成双向:
- import {Table, Column, PrimaryGeneratedColumn, OneToOne, JoinColumn} from "typeorm";
- import {Photo} from "./Photo";
-
- @Table()
- export class PhotoMetadata {
-
- /* ... 其他列 */
-
- @OneToOne(type => Photo, photo => photo.metadata)
- @JoinColumn()
- photo: Photo;
- }
- import {Table, Column, PrimaryGeneratedColumn, OneToOne} from "typeorm";
- import {PhotoMetadata} from "./PhotoMetadata";
-
- @Table()
- export class Photo {
-
- /* ... 其他列 */
-
- @OneToOne(type => PhotoMetadata, photoMetadata => photoMetadata.photo)
- metadata: PhotoMetadata;
- }
photo => photo.metadata
是用来指定反向关系的字段名字,photo.metadata就指出了Photo里的metadata字段名字。
当然也可以使用@OneToOne('metadata')
来达到同样的目的,不过这种对于以后的代码重构不友好。
按上面说的,@JoinColumn
只能在关系的一边使用来使这边做为关系的拥有者,关系拥有者在数据库里的表现就是拥有一个外键列。
取出关系对象的数据
现在来用一个查询来取出photo以及它的元信息。
有两种方式,一是用FindOptions
,另一个是使用QueryBuilder
。
先试下FindOptions
,通过指定FindOptions
接口作为参数来使用Repository.find
方法可以完成非常复杂的查询。
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
- import {PhotoMetadata} from "./entity/PhotoMetadata";
-
- createConnection(/*...*/).then(async connection => {
-
- /*...*/
- let photoRepository = connection.getRepository(Photo);
- let photos = await photoRepository.find({
- alias: "photo",
- innerJoinAndSelect: {
- "metadata": "photo.metadata"
- }
- });
-
-
- }).catch(error => console.log(error));
返回的photos是从数据库里取回的photo的数组,每个photo都包含它的元信息。
alias
是FindOptions的一个必需选项,这是你自己在select里定义的别名,然后需要用在接下来的 where, order by, group by, join 以及其他表达式.
这里还用到了innerJoinAndSelect
,表示内联查询photo.metadata的数据。"photo.metadata"
里"photo"是一个别名,"metadata"则是你想查询的那个对象的属性名。"metadata"
: 是内联返回数据的新的别名.
下面来尝试第二种方式:QueryBuilder
来达到同样的目的. 使用QueryBuilder
可以优雅完成复杂的查询:
- import {createConnection} from "typeorm";
- import {Photo} from "./entity/Photo";
- import {PhotoMetadata} from "./entity/PhotoMetadata";
-
- createConnection(/*...*/).then(async connection => {
-
- /*...*/
- let photoRepository = connection.getRepository(Photo);
- let photos = await photoRepository.createQueryBuilder("photo")
- .innerJoinAndSelect("photo.metadata", "metadata")
- .getMany();
-
-
- }).catch(error => console.log(error));
使用 cascade 选项来自动保存关系着的对象
上面要保存关系对象需要一个一个来保存,略显麻烦。
如果我们需要当关系对象中的一个被保存后,另一个也同样被保存,则可以使用cascade
选项来做到。
稍微改下@OneToOne
装饰:
- export class Photo {
- /// ... 其他列
-
- @OneToOne(type => PhotoMetadata, metadata => metadata.photo, {
- cascadeInsert: true,
- cascadeUpdate: true,
- cascadeRemove: true
- })
- metadata: PhotoMetadata;
- }
- cascadeInsert - 如果表中没有关系中的metadata,则自动insert,即我们不需要再手动insert一个新的photoMetadata对象。
- cascadeUpdate - 如果metadata有变化,则自动update。
- cascadeRemove - 如果把photo里的metadata移除了,也就是为空,则会自动remove表中的这条metadata数据。
使用cascadeInsert就可以不需要像上面那边先存photo再存metadata了。
现在我们来单单存photo对象,由于cascade的作用,metadata也会自动存上。
- createConnection(options).then(async connection => {
-
- // 创建photo对象
- let photo = new Photo();
- photo.name = "Me and Bears";
- photo.description = "I am near polar bears";
- photo.filename = "photo-with-bears.jpg"
- photo.isPublished = true;
-
- // 创建photo metadata 对象
- let metadata = new PhotoMetadata();
- metadata.height = 640;
- metadata.width = 480;
- metadata.compressed = true;
- metadata.comment = "cybershoot";
- metadata.orientation = "portait";
-
- photo.metadata = metadata; // 连接起来
-
- // 得到repository
- let photoRepository = connection.getRepository(Photo);
-
- // 存photo
- await photoRepository.persist(photo);
- // photo metadata也自动存上了
- console.log("Photo is saved, photo metadata is saved too.")
-
- }).catch(error => console.log(error));
多对一/一对多关系
接下来显示多对一/一对多关系。
假设一个photo会有一个author,并且每个author可以有很多photo。
先创建Author实体:
- import {Table, Column, PrimaryGeneratedColumn, OneToMany, JoinColumn} from "typeorm";
- import {Photo} from "./Photo";
-
- @Table()
- export class Author {
-
- @PrimaryGeneratedColumn()
- id: number;
-
- @Column()
- name: string;
-
- @OneToMany(type => Photo, photo => photo.author) // 备注:下面会为Photo创建author属性
- photos: Photo[];
- }
Author包含一个反向的关系,OneToMany
总是反向的,并且总是与ManyToOne
成对出现。
现在来为Photo加上关系拥有者。
- import {Table, Column, PrimaryGeneratedColumn, ManyToOne} from "typeorm";
- import {PhotoMetadata} from "./PhotoMetadata";
- import {Author} from "./Author";
-
- @Table()
- export class Photo {
-
- /* ... 其他列 */
-
- @ManyToOne(type => Author, author => author.photos)
- author: Author;
- }
在ManyToOne/OneToMany
关系中,拥有者一边总是ManyToOne
。译者注:拥有外键者即关系拥有者
也就是ManyToOne
的那个字段存的是另一个对象的id。译者注:也就是上面的author虽然属性是Author,但在数据库中类型是Author id的类型,存的也是id
执行上面的代码将会自动创建author表,如下:
- +-------------+--------------+----------------------------+
- | author |
- +-------------+--------------+----------------------------+
- | id | int(11) | PRIMARY KEY AUTO_INCREMENT |
- | name | varchar(255) | |
- +-------------+--------------+----------------------------+
因为photo表已经存在,所以不是增加而是修改photo表 - 添加一个新外键列author:
- +-------------+--------------+----------------------------+
- | photo |
- +-------------+--------------+----------------------------+
- | id | int(11) | PRIMARY KEY AUTO_INCREMENT |
- | name | varchar(255) | |
- | description | varchar(255) | |
- | filename | varchar(255) | |
- | isPublished | boolean | |
- | author | int(11) | FOREIGN KEY |
- +-------------+--------------+----------------------------+
多对多关系
假设photo可以存在多个相册中,并且相册里可以包含多个photo。
先创建一个Album
类
- import {Table, PrimaryGeneratedColumn, Column, ManyToMany, JoinTable} from "typeorm";
-
- @Table()
- export class Album {
-
- @PrimaryGeneratedColumn()
- id: number;
-
- @Column()
- name: string;
-
- @ManyToMany(type => Photo, photo => photo.albums, { // 备注: 会在下面的Photo类里添加"albums"属性
- cascadeInsert: true, // 在添加Album时,会自动添加相册里的Photo
- cascadeUpdate: true, // 在更新Album时,会自动更新相册里的Photo
- cascadeRemove: true // 在移除Album时,会自动移除相册里的Photo
- })
- @JoinTable()
- photos: Photo[] = []; // 初始化个Photo数组
- }
@JoinTable
多对多关系拥有者必须指定的。
接着给Photo
实体加个反向关系:
- export class Photo {
- /// ... 其他列
-
- @ManyToMany(type => Album, album => album.photos, {
- cascadeInsert: true, // 在添加Album时,会自动添加相册里的Photo
- cascadeUpdate: true, // 在更新Album时,会自动更新相册里的Photo
- cascadeRemove: true // 在移除Album时,会自动移除相册里的Photo
- })
- albums: Album[] = []; // 初始化个Album数组
- }
执行上面的代码后会自动创建一个叫 album_photos_photo_albums的联接表:
- +-------------+--------------+----------------------------+
- | album_photos_photo_albums |
- +-------------+--------------+----------------------------+
- | album_id_1 | int(11) | PRIMARY KEY FOREIGN KEY |
- | photo_id_2 | int(11) | PRIMARY KEY FOREIGN KEY |
- +-------------+--------------+----------------------------+
记得把Album
实体加到ConnectionOptions中:
- const options: CreateConnectionOptions = {
- // ... 其他配置
- entities: [Photo, PhotoMetadata, Author, Album]
- };
现在来往数据库里插入albums和photos
- let connection = await createConnection(options);
-
- // 创建两个albums
- let album1 = new Album();
- album1.name = "Bears";
-
- let album2 = new Album();
- album2.name = "Me";
-
- // 创建两个photos
- let photo1 = new Photo();
- photo1.name = "Me and Bears";
- photo1.description = "I am near polar bears";
- photo1.filename = "photo-with-bears.jpg";
- photo1.albums.push(album1);
-
- let photo2 = new Photo();
- photo2.name = "Me and Bears";
- photo2.description = "I am near polar bears";
- photo2.filename = "photo-with-bears.jpg";
- photo2.albums.push(album2);
-
- // 获取Photo的repository
- let photoRepository = connection.getRepository(Photo);
-
- // 依次存储photos,由于cascade,albums也同样会自动存起来
- await photoRepository.persist(photo1);
- await photoRepository.persist(photo2);
-
- console.log("Both photos have been saved");
使用QueryBuilder
可以利用QueryBuilder来构建一个非常复杂的查询,例如:
- let photoRepository = connection.getRepository(Photo);
- let photos = await photoRepository
- .createQueryBuilder("photo") // 别名,必填项,用来指定本次查询
- .innerJoinAndSelect("photo.metadata", "metadata")
- .leftJoinAndSelect("photo.albums", "albums")
- .where("photo.isPublished=true")
- .andWhere("(photo.name=:photoName OR photo.name=:bearName)")
- .orderBy("photo.id", "DESC")
- .setFirstResult(5)
- .setMaxResults(10)
- .setParameters({ photoName: "My", bearName: "Mishka" })
- .getMany();
这个查询会查找已经published的,并且name是"My"或"Mishka",
得到的结果会从第5个开始(分页偏移决定的),
并且只会得到10个结果(分页每页个数决定的),
所得结果是以id的倒序排序的,
Photo的albums是左联接,photo的metadata是内联接。
更多关于QueryBuilder可以查看这里.