NestJS A progressive web framework #kng9 @jiko_21 (a.k.a Daiki Kojima)

Grad Student @ Kyoto univ Frontend / Serverside Engineer Android DeveloperͩͬͨΓ΋͢Δ Love: Vue.js, TypeScript, Kotlin, Golang… @jiko_21 (a.k.a Daiki Kojima) @jiko_21 @jiko21

Agenda • NestJSͬͯԿ? • ͔ΜͨΜͳ֓ཁ • ҰൠతͳApplicationΛॻ͘ͷʹඞཁͳ஌ࣝ • NestJSͷಛ௃ • ·ͱΊ

2018೥ Warsaw @ PorlandͰ
 ͜Μͳηογϣϯ͕͋ͬͨ

JavaScript Conference’18 @Warsaw https://youtu.be/f0qzBkAQ3mk

NestJSͱ͸ • Progressive Node.js framework • TypeScriptͰهड़Մೳ • ༷ʑͳπʔϧ͕ఏڙ͞Ε͍ͯΔ

࣮ࡍʹத਎ΛݟͯΈΔ

NestJSͷجૅ • module • ίʔυΛ·ͱΊͯػೳΛ࿦ཧతͳ୯Ґʹ෼ׂ
 ˠ ࠶ར༻Մೳʹ! • શͯͷNestͷΞϓϦέʔγϣϯʹ͸root module͕ଘࡏ͠
 ΞϓϦέʔγϣϯΛىಈͤ͞Δ
 (Angularͱಉ༷)

NestJSͷجૅ 3PPUNPEVMF 4VC NPEVMF
 جຊతʹ͍ΖΜͳ΋ͷΛ͜Εʹ
 ٧ΊࠐΊ͍ͯ͘

moduleΛߏ੒͢Δ΋ͷ

moduleΛߏ੒͢Δ΋ͷ $POUSPMMFST

moduleΛߏ੒͢Δ΋ͷ 1SPWJEFST $POUSPMMFST

moduleΛߏ੒͢Δ΋ͷ 1SPWJEFST $POUSPMMFST *NQPSUT

moduleΛߏ੒͢Δ΋ͷ 1SPWJEFST $POUSPMMFST *NQPSUT &YQPSUT

moduleΛߏ੒͢Δ΋ͷ @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {}

moduleΛߏ੒͢Δ΋ͷ @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {} !.PEVMF಺ʹ ͦΕͧΕΛهೖ͍ͯ͘͠

Controllers

Controllers • ϧʔςΟϯάΛ୲͏ • pathͱmethod͕
 ରԠ @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} @Get() getTodos(): Promise { return this.todosService.findAll(); } @Get(':id') getTodo(@Param('id', new ParseIntPipe()) id: number): Promise { return this.todosService.findById(id); } @Post('') createTodo(@Body() todoDao: TodoDao): Promise { return this.todosService.create(todoDao) } … }

Controllers • ϧʔςΟϯάΛ୲͏ • pathͱmethod͕
 ରԠ @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} @Get() getTodos(): Promise { return this.todosService.findAll(); } @Get(':id') getTodo(@Param('id', new ParseIntPipe()) id: number): Promise { return this.todosService.findById(id); } @Post('') createTodo(@Body() todoDao: TodoDao): Promise { return this.todosService.create(todoDao) } … } ! Ξϊςʔγϣϯ Ͱ
 NFUIPEͱQBSBNɺQBUIΛઃఆ

• ϧʔςΟϯάΛ୲͏ • pathͱmethod͕
 ରԠ Controllers @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} @Get() getTodos(): Promise { return this.todosService.findAll(); } @Get(':id') getTodo(@Param('id', new ParseIntPipe()) id: number): Promise { return this.todosService.findById(id); } @Post('') createTodo(@Body() todoDao: TodoDao): Promise { return this.todosService.create(todoDao) } … }

• ϧʔςΟϯάΛ୲͏ • pathͱmethod͕
 ରԠ Controllers @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} @Get() getTodos(): Promise { return this.todosService.findAll(); } @Get(':id') getTodo(@Param('id', new ParseIntPipe()) id: number): Promise { return this.todosService.findById(id); } @Post('') createTodo(@Body() todoDao: TodoDao): Promise { return this.todosService.create(todoDao) } … } DPOTUSVDUPSʹґଘ͢Δ0CKFDUΛ ॻ͍͓ͯ͘ͱ.PEVMF͕ґଘΛղܾ %*ɺޙड़ 


Providers • providers಺ͷίʔυ͸
 NestJSʹΑͬͯΠϯελϯεԽ
 ͞ΕͯModule಺Ͱڞ༗ (DI) @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {}

Providers @Injectable() export class TodosService { constructor(@InjectRepository(Todo) todoRepo: Repository) {} } @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} } @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {}

Providers @Injectable() export class TodosService { constructor(@InjectRepository(Todo) todoRepo: Repository) {} } @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} } @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {} *OKFDUBCMFΛ
 ࢦఆ

Providers @Injectable() export class TodosService { constructor(@InjectRepository(Todo) todoRepo: Repository) {} } @Controller('todos') export class TodosController { constructor(private readonly todosService: TodosService) {} } @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {} *OKFDUBCMFΛ
 ࢦఆ DPOUSPMMFSʹ
 ྲྀ͠ࠐΈ *OKFDU

Imports • ͜ͷModule಺Ͱproviderͱ͔͕ඞཁͱ͍ͯ͠ΔModuleΛ
 ͜͜Ͱॻ͍ͯ͋͛Δ • TypeORMΈ͍ͨͳthird party module • ࣗ෼Ͱॻ͍ͨΧελϜmodule

Imports @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {} @Module({ imports: [ TodosModule ], controllers: [AppController], providers: [AppService], }) export class AppModule {}

Imports @Module({ imports: [TypeOrmModule.forFeature([Todo]),], providers: [TodosService], controllers: [TodosController], exports: [], }) export class TodosModule {} @Module({ imports: [ TodosModule ], controllers: [AppController], providers: [AppService], }) export class AppModule {} JNQPSU͍ͯ͘͜͠ͱͰ
 .PEVMF͕࢖͑Δ

෼ׂ͞ΕͨModuleΛ࢖͓͏!

ͱ͸͍͑…

Service૚ͱ͔ͬͯɺ
 ผͷModuleͰݺͼͨ͘ͳΔΑͶ…

exports • providerͷαϒηοτ • ͜͜ʹॻ͔Ε͍ͯΔ΋ͷ͸ɺ͜ͷmoduleΛimport͍ͯ͠Δ
 ଞͷmodule͔Β௚઀ར༻͕Ͱ͖Δ!

JestͰςετ͕ॻ͚Δ

Jestͱ͸ • Facebook੡ͷJavaScript༻Testing Framework • ଞͷTesting Libraryͱҧ͍ɺAll in one • ϑϩϯτΤϯυͩͱ… • React, Vue.js౳ͰΑ͘࢖ΘΕΔ…

ॻ͖ํͷҰྫ describe('TodosService', () => { let service: TodosService; let repository: Repository; beforeEach(async () => { ... }); afterEach(async () => { ... }); it('findAll success', async () => { expect(await service.findAll()).toEqual(TODOS_ARAY); }); });

ॻ͖ํͷҰྫ describe('TodosService', () => { let service: TodosService; let repository: Repository; beforeEach(async () => { ... }); afterEach(async () => { ... }); it('findAll success', async () => { expect(await service.findAll()).toEqual(TODOS_ARAY); }); }); ֤ςετέʔε௚લʹ࣮ߦ

ॻ͖ํͷҰྫ describe('TodosService', () => { let service: TodosService; let repository: Repository; beforeEach(async () => { ... }); afterEach(async () => { ... }); it('findAll success', async () => { expect(await service.findAll()).toEqual(TODOS_ARAY); }); }); ֤ςετέʔε௚લʹ࣮ߦ ֤ςετέʔε௚ޙʹ࣮ߦ

JestͰ͸Α͋͘Γ͕ͪͳ͜ͱ… • ୯ମςετͰɺ֎෦ϞδϡʔϧͷڍಈΛϞοΫ͍ͨ͠ • jest.spyOnͰϞοΫ it('getProducts', async () => { jest.spyOn(service, ‘findAll') .mockResolvedValue(PRODUCTS_ARRAY); expect(await controller.getProducts()) .toBe(PRODUCTS_ARRAY); }); @Get() getProducts(): Promise { return this.productsService.findAll(); } ςετର৅ ςετίʔυ

JestͰ͸Α͋͘Γ͕ͪͳ͜ͱ… • ୯ମςετͰɺ֎෦ϞδϡʔϧͷڍಈΛϞοΫ͍ͨ͠ • jest.spyOnͰϞοΫ it('getProducts', async () => { jest.spyOn(service, ‘findAll') .mockResolvedValue(PRODUCTS_ARRAY); expect(await controller.getProducts()) .toBe(PRODUCTS_ARRAY); }); @Get() getProducts(): Promise { return this.productsService.findAll(); } ςετର৅ ςετίʔυ ͍ͭ͜ͷڍಈΛNPDL͍ͨ͠

JestͰ͸Α͋͘Γ͕ͪͳ͜ͱ… • ୯ମςετͰɺ֎෦ϞδϡʔϧͷڍಈΛϞοΫ͍ͨ͠ • jest.spyOnͰϞοΫ it('getProducts', async () => { jest.spyOn(service, ‘findAll') .mockResolvedValue(PRODUCTS_ARRAY); expect(await controller.getProducts()) .toBe(PRODUCTS_ARRAY); }); @Get() getProducts(): Promise { return this.productsService.findAll(); } ςετର৅ ςετίʔυ ͍ͭ͜ͷڍಈΛNPDL͍ͨ͠ ͍ͭ͜ͷڍಈΛNPDL͢Δ

NestJSͩͱ • moduleʹΑͬͯґଘղܾΛߦ͏ͷͰɺͦ͜ͰmockΛ
 ྲྀ͠ࠐΜͰ͠·͑͹OK describe('Todos Controller', () => { let controller: TodosController; let service: TodosService; beforeEach(async () => { const module: TestingModule = await Test.createTestingModule({ providers: [{ provide: TodosService, useValue: todoServiceMock, }], controllers: [TodosController], }).compile(); controller = module.get(TodosController); service = module.get(TodosService); }); }); export const todoServiceMock = { findAll: () => TODOS_ARAY, findById: (id: number) => TODOS_ARAY[0], create: (todoDao: TodoDao) => todoDao, }; mockؔ਺ ςετίʔυ

Ұ୴ɺجૅతͳͱ͜Ζ͸ݟͨ!

NestJSͰ։ൃ͢Δ
 ͏·Έ੒෼ͬͯԿ?

ओͳಛ௃ 1. TypeScriptͰͷهड़͕default 2. πʔϧ܈͕๛෋ 3. όοΫΤϯυ (http provider) Λબ୒Մೳ

TypeScriptͰͷهड़͕default • cliʹΑͬͯੜ੒͞Εͨίʔυ͸શͯTypeScriptͰॻ͔Ε͍ͯΔ • ଞͷFrameworkͩͱ(Express…) • ࣗલͰTypeScriptԽ͕ඞཁ • ͱ͸͍͑JavaScriptͰ΋ॻ͚Δ

πʔϧ܈͕๛෋ • ৭ʑͳ΋ͷ͕ఏڙ͞Ε͍ͯΔ • DI, test util, microservice support, WebSockets, RxJS • ʮNestJS͸ϓϥοτϑΥʔϜͰ͋Δʯɺͱ͍͏ࢥ૝͔Β
 ͜ͷΑ͏ʹͳ͍ͬͯΔ

όοΫΤϯυ (http provider) Λબ୒Մೳ • package.jsonͱpackage-lock.jsonΛݟͯΈΔ { "name": "todo-app", "dependencies": { "express": { "version": "4.17.1", "resolved": “...”, "integrity": “...“, "requires": { ... }, "dependencies": { ... } }, } } { "name": "todo-app", "version": "0.0.1", "scripts": {}, "dependencies": { "@nestjs/common": "^6.7.2", "@nestjs/core": "^6.7.2", "@nestjs/platform-express": "^6.7.2", ... }, "devDependencies": { "@nestjs/cli": "^6.9.0", "@nestjs/schematics": "^6.7.0", "@nestjs/testing": "^6.7.1", "@types/express": "^4.17.1", ... }, }

όοΫΤϯυ (http provider) Λબ୒Մೳ • package.jsonͱpackage-lock.jsonΛݟͯΈΔ { "name": "todo-app", "dependencies": { "express": { "version": "4.17.1", "resolved": “...”, "integrity": “...“, "requires": { ... }, "dependencies": { ... } }, } } { "name": "todo-app", "version": "0.0.1", "scripts": {}, "dependencies": { "@nestjs/common": "^6.7.2", "@nestjs/core": "^6.7.2", "@nestjs/platform-express": "^6.7.2", ... }, "devDependencies": { "@nestjs/cli": "^6.9.0", "@nestjs/schematics": "^6.7.0", "@nestjs/testing": "^6.7.1", "@types/express": "^4.17.1", ... }, }

όοΫΤϯυ (http provider) Λબ୒Մೳ • ࣮͸NestJSͷhttp provider͸ࣗલͷ΋ͷͰ͸ͳ͍ • σϑΥϧτ͸Express • ଞͷhttp provider΋ར༻͢Δ͜ͱ͕Մೳ • Fastifyͱ͔
 → expressͷ2ഒ΄ͲϕϯνϚʔΫͰྑ͍ੑೳ • ͜ΕʹΑΓ༷ʑͳthird-party plugin͕ར༻Մೳʹ

fastifyʹมߋ • ҎԼͷίϚϯυͰಋೖ
 • main.tsΛҎԼͷΑ͏ʹ͢Δ $ npm i @nestjs/platform-fastify import { NestFactory } from '@nestjs/core'; import { AppModule } from './app.module'; import { FastifyAdapter } from '@nestjs/platform-fastify'; async function bootstrap() { const app = await NestFactory.create(AppModule, new FastifyAdapter()); await app.listen(3000); } bootstrap();

͡Ό͋ͳΜͰ

σϑΥϧτ͕expressͳͷ͔…

৭ʑཧ༝͋Γ • express͕޿͘࢖ΘΕ͍ͯͯmiddleware͕ଟ͍ • Nested routerʹରԠ͍ͯ͠ͳ͍ͨΊɺSub-Domain routing
 ʹରԠ͍ͯ͠ͳ͍ • sub-domain routingΛ༗ޮʹ͢Δͱexpressʹ੾ΓସΘΔ

·ͱΊ • NestJS͸module୯ҐͰͷϩδοΫ෼ׂΛجຊͱ͓ͯ͠Γɺ
 ࠶ར༻ੑͷߴ͍ίʔυ͕ॻ͚Δ • TypeScriptͷσϑΥϧταϙʔτɺDIͷඪ४ఏڙͳͲɺ
 αϙʔτ͕ڧ͍
 (TypeScript൛Spring Bootͱݴͬͯ΋աݴͰ͸ͳ͍)

Reference • Building a platform: NestJS from the ground up | Kamil Myśliwiec | jsPoland 2018
 https://youtu.be/f0qzBkAQ3mk • Document of NestJS: https://docs.nestjs.com/

ऴ ੍࡞ɾஶ࡞ ᴸᴸᴸᴸᴸ @jiko_21