建立初始文件的相关思考

在完成了对数据entity的设计后,向后端以entity->controller->service这样的顺序(后两者顺序无所谓),意即先建立数据表,然后增加对数据表的操作。
首先建立一个模块,这个模块是数据表所存在的一个大类型,如User表,其大的模块可能是auth.moudule,这样的划分对于数据库可能并无模块区分,但是对于系统确可以更方便的管理。这种模块划分与angular的模块划分设计类似,不同的是后端体现在了数据管理上,而前端则体现在页面展示上。另外,在模块中,我们可以看到三中类型的ts文件,分别为entityservicecontroller,如果按照前端思维,应当把同一数据表的文件放在同一文件夹下,如:
image.png
这样带来的好处是对于同一个表的操作可以更加集中地放在同一个文件夹下,即表的数据,表的crud,表的可能用到的服务。从简单的表生成来说,这种操作并无大碍,但是如果采用这种方式:
image.png
即分出几个文件夹,一者保留数据,一者保留crud,一者保留服务,这样其实更符合后端思维。首先,要了解service是为了方便后端程序员为了保证同样的操作复用减少代码编写的一种方式,它把对某个表的操作进行抽象,可供其他服务或控制器调用。而一个复杂的服务方法往往会调用一个模块中的多个方法,如果按照上面的写法,按照表进行分离,即把数据和服务放在一起,很不符合认知。将服务和服务放在一起,数据和数据放在一起,更符合认知并且可扩展性更强。另外,如果对于某些服务它没有对应的数据,我们可以直接写在服务文件夹中。当然这里配合index.ts使用更加方便。
这里我们提供一个额外的篇幅说明index.ts。它的作用很简单,就是目录。它的作用就是把复杂的引用变简单,把多行代码进行缩减,如果没有index.ts这里引入可能是这样的:
image.png
有了后是这样的:
image.png
其实就是让索引变得更体系化,想想一个多叉树的结构,不过在写代码时要多写一点。

CONNECTION

链接里讲的很清楚了,这里再对一个特殊点进行说明,即entity的增删查改的进行。
首先,在操作数据库前,需要建立程序->数据库的链接,在文档中可以看到,
image.png
而建立了链接后,后面可以直接通过getConnection接口,获取到这一链接从而对数据库进行操作。在代码中,我们是通过提前配置config.service.ts然后在app.module.ts中注入来完成这一获取链接操作,所以代码中没有看到createConnection这一操作。

  1. imports: [
  2. TypeOrmModule.forRootAsync({
  3. imports: [ConfigModule],
  4. useFactory: async (configService: ConfigService) => {
  5. return {
  6. ...configService.envConfig.POSTGRES,
  7. entities: [__dirname + '/**/*.entity{.ts,.js}'],
  8. };
  9. },
  10. inject: [ConfigService],
  11. name: process.env.DOUYIN_DATABASE_NAME,
  12. }),
  13. TypeOrmModule.forRootAsync({
  14. imports: [ConfigModule],
  15. useFactory: async (configService: ConfigService) => {
  16. return {
  17. ...configService.envConfig.ORDER_CENTER_POSTGRES,
  18. entities: [TaobaoOrder, OrderCenterDouyinBuyinOrder],
  19. };
  20. },
  21. inject: [ConfigService],
  22. name: 'dwjrobot-order-center',
  23. }),

而文档中也提到:

But generally, you don’t use Connection much. Most of the time you only create a connection and use getRepository() and getManager() to access your connection’s manager and repositories without directly using connection object:

  1. import {getManager, getRepository} from "typeorm";
  2. import {User} from "../entity/User";
  3. export class UserController {
  4. @Get("/users")
  5. getAll() {
  6. return getManager().find(User);
  7. }
  8. @Get("/users/:id")
  9. getAll(@Param("id") userId: number) {
  10. return getRepository(User).findOne(userId);
  11. }
  12. }

因此我们对数据库的操作一般是用getRepository()getManager() 完成,这种链接获取的方式可以看到有这么几类:

  1. service继承,然后利用service操作 ```typescript // user.service.ts export class UserService extends TypeOrmCrudService{ private logger = new MLogger(this.constructor.name); constructor( @InjectRepository(User, process.env.DOUYIN_DATABASE_NAME) public userRepository: Repository, ) { super(userRepository); } }

// user.controller.ts const user = await this.service.findOne({ where: { id, }, });

  1. 该操作利用基类_TypeOrmCrudServic_e中对于增删改查的方法进行操作,但是不推荐这样子,因为对于数据库的操作这种方式并不明显(符合人们的基本认知,以及对基本架构的映射支持)
  2. 2. 使用_Repository_操作
  3. ```typescript
  4. // user.service.ts
  5. export class UserService extends TypeOrmCrudService<User>{
  6. private logger = new MLogger(this.constructor.name);
  7. constructor(
  8. @InjectRepository(User, process.env.DOUYIN_DATABASE_NAME)
  9. public userRepository: Repository<User>,
  10. ) {
  11. super(userRepository);
  12. }
  13. }
  14. // user.controller.ts
  15. @Post('/change-password')
  16. @UseGuards(AuthGuard())
  17. async changePassword(
  18. @Request() req: any,
  19. @Body() { password }: { string; password: string },
  20. ) {
  21. const user = await this.userService.userRepository.findOne({
  22. where: {
  23. id: req.user.id,
  24. },
  25. });
  26. user.updatePassword(password);
  27. await this.userService.userRepository.save(user);
  28. return {
  29. code: 'success',
  30. };
  31. }

这一操作,本质上和getRepository(User).findOne(userId)等价,只是这样写可以更好的进行统一管理。同时,这样写是全同步的操作方式,先查找,再更新,最后保存,很简单,逻辑很清晰。

  1. 使用getManger操作 ```typescript // example1 return await getManager(process.env.DOUYIN_DATABASE_NAME).transaction( async transactionalEntityManager => {

    1. let userInfo: UserInfo;
    2. if (user.userInfo) {
    3. userInfo = user.userInfo;
    4. } else {
    5. userInfo = new UserInfo();
    6. userInfo.user = user;
    7. }
    8. userInfo.content = userInfoContent;
    9. await transactionalEntityManager.save(userInfo);
    10. return {
    11. userInfo,
    12. };

    }, );

// example2 return await getManager(process.env.DOUYIN_DATABASE_NAME).transaction( ‘REPEATABLE READ’, async transactionalEntityManager => {…

  1. 这一操作适用于复杂的或者可能出现脏读之类破坏数据一致性的操作的情况,详见[这里](https://typeorm.io/#/transactions/)。可以把这种操作视为原子操作,设置隔离级别,[类型](https://blog.csdn.net/adorablewolf/article/details/88393989?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_title-1&spm=1001.2101.3001.4242)为:
  2. ```typescript
  3. export declare type IsolationLevel = "READ UNCOMMITTED" | "READ COMMITTED" | "REPEATABLE READ" | "SERIALIZABLE";

实际使用中可以视情况使用。

ENTITY

我们使用的是typeorm定义,参考这里
基础的类型,可以查询文档,这里主要说明外键关系中,一对一,一对多,多对多的关系。

One-to-One

一对一,举例用户和用户档案。具体参考文档,需要有表列添加修饰符@JoinColumn(),表示绑定外键的表列。

Many-to-One and One-to-Many

一对多,说明有一个表是一,一个表是多,举例用户和用户照片。可以省略@JoinColumn(),但是@OneToMany@ManyToOne必须有。

Many-to-Many

多对多,关系通过一张表来保存,如图:
image.png

@JoinTable()is required for@ManyToManyrelations. You must put@JoinTableon one (owning) side of relation.

Eager relations

image.png
加入后不用relation,可以自动join数据,只能用在一边,

Eager relations only work when you usefind*methods. If you useQueryBuildereager relations are disabled and have to useleftJoinAndSelectto load the relation. Eager relations can only be used on one side of the relationship, usingeager: trueon both sides of relationship is disallowed.

Entity Manger and Repository

UsingEntityManageryou can manage (insert, update, delete, load, etc.) any entity. EntityManager is just like a collection of all entity repositories in a single place.

  1. import {getManager} from "typeorm";
  2. import {User} from "./entity/User";
  3. const entityManager = getManager(); // you can also get it via getConnection().manager
  4. const user = await entityManager.findOne(User, 1);
  5. user.name = "Umed";
  6. await entityManager.save(user);

Repositoryis just likeEntityManagerbut its operations are limited to a concrete entity. You can access repository viagetRepository(Entity),Connection#getRepository, orEntityManager#getRepository. Example:

  1. import {getRepository} from "typeorm";
  2. import {User} from "./entity/User";
  3. const userRepository = getRepository(User); // you can also get it via getConnection().getRepository() or getManager().getRepository()
  4. const user = await userRepository.findOne(1);
  5. user.name = "Umed";
  6. await userRepository.save(user);
  1. userRepository.find({
  2. select: ["firstName", "lastName"],
  3. relations: ["profile", "photos", "videos"],
  4. where: {
  5. firstName: "Timber",
  6. lastName: "Saw"
  7. },
  8. order: {
  9. name: "ASC",
  10. id: "DESC"
  11. },
  12. skip: 5,
  13. take: 10,
  14. cache: true
  15. });

操作符:

  1. const loadedPosts = await this.userService.userRepository.find({
  2. // Not
  3. username: Not('About #1'),
  4. // LessThan
  5. loginTimes: LessThan(10),
  6. // LessThanOrEqual
  7. loginTime: LessThanOrEqual(10),
  8. // MoreThan
  9. loginTimes: MoreThan(10),
  10. // MoreThanOrEqual
  11. loginTimes: MoreThanOrEqual(10),
  12. // Equal
  13. username: Equal('About #2'),
  14. // Like
  15. password: Like('%out #%'),
  16. // ILike
  17. password: ILike('%out #%'),
  18. // Between
  19. loginTimes: Between(1, 10),
  20. // In
  21. username: In(['张三', '李四']),
  22. // IsNull
  23. username: IsNull(),
  24. // Any 满足任意条件
  25. // 如age > any (select age from student where 班级=’02’)等价于age > (select min(age) from student where 班级=’02’)
  26. username: Any(['张三', '李四']),
  27. // Raw 直接转化为SQL
  28. // SELECT * FROM "user" WHERE "created" > NOW()
  29. created: Raw(alias => `${alias} > NOW()`),
  30. // SELECT * FROM "user" WHERE "updated" > '2020-10-06'
  31. updated: Raw(alias => `${alias} > ':date'`, { date: '2020-10-06' }),
  32. username: Raw(alias => `${alias} IN (:...titles)`, {
  33. titles: ['张三', '李四'],
  34. }),
  35. // 结合
  36. username: Not(Equal("About #2")),
  37. });