티스토리

kakasoo
검색하기

블로그 홈

kakasoo

kscodebase.tistory.com/m

따이

구독자
27
방명록 방문하기

주요 글 목록

  • Clean Architecture (NestJS) 어떤 기능을 구현하다보면 외부 요소에 대한 의존성을 강하게 가지게 되는 경우가 있다. 가장 간단한 예시로, 우리는 어떤 데이터베이스를 사용하느냐에 따라 내부 로직이 변경될 것이다. Postgres나 MySQL을 쓰는 경우에, 그 둘의 내부 함수 명이 다르기 때문에 영향을 받게 될 것이고, 만약 ORM을 사용한다고 하더라도 MongoDB와 같은 NoSQL을 사용하면 또 영향을 받게 된다. 데이터베이스 말고도 유저가 보내는 요청들이 무엇인지에 따라서도 서비스는 영향을 받게 될 것이다. 요청은 우리가 제어하는 것 아니냐 반문할 수 있겠지만, 모바일인지 웹인지에 따라서 처리 방식이 다르다. 우리의 핵심 비즈니스 로직들을 내부 라고 정의할 때, 이런 영향을 주는 요소들을 전부 외부 라고 불러보자. Clean Ar.. 공감수 5 댓글수 1 2023. 6. 25.
  • NestJS에서의 Redis 적용 내가 적용한 시점에는 일일 다운로드 3만 건이었고, 현재는 5만건인 라이브러리다. 서비스에서도 사용하고 있는데 사용성이 무척 좋아서 공유한다. Installation # with npm npm install @liaoliaots/nestjs-redis ioredis # with yarn yarn add @liaoliaots/nestjs-redis ioredis # with pnpm pnpm add @liaoliaots/nestjs-redis ioredis npm: @liaoliaots/nestjs-redis 라이브러리는 @liaoliaots/nestjs-redis 와 **ioredis 이렇게 두 개를 설치해야 하고, 노드 버전은 12.22 이상, NestJS는 9.0.0 이상, ioredis는 5.0.0.. 공감수 2 댓글수 0 2023. 5. 9.
  • Nestia에서 typeof, namespace를 쓰면 안 됩니다 왜 안 되는데요? Nestia는 NestJS로 작성된 백엔드 코드를 읽고 TypeScript compiler를 이용해서 프론트에서 사용 가능한 SDK를 만든다. 그래서 지금 사용하면 곤란한 TypeScript keyword들이 있는데, 하나는 typeof고 하나는 namespace이다. typeof의 경우 타입의 이름을 추론해낼 수 없게 되는 문제가 있다. namespace는 한 함수가 동일 네임스페이스로부터 두 개 이상의 내부 인터페이스, 타입을 가져올 때 문제가 될 수 있다. 이유는 import 시 두 타입이 하나의 인터페이스로부터 추론된다는 것을 컴파일러가 인지하기 어렵기 때문에 하나만 갖고 오게 되서다. https://kscodebase.tistory.com/663 모든 타입이 추론되는 API 만.. 공감수 0 댓글수 0 2023. 4. 9.
  • 모든 타입이 추론되는 API 만들기 ( feat. Nestia ) 이 글은 다음의 내용을 다룬다. 프론트 개발자들이 눈치채면 곤란한 백엔드 이야기 백엔드 개발자가 프로그래밍 언어가 Node.js 라서 얻을 수 있는 이점 Nestia 라이브러리를 이용한 Swagger 문서 및 SDK 생성 에러를 던지지 않고 값으로 다루는 방식 서버와 프론트가 분리되서 발생하는 문제들 첫째, 서버와 프론트의 중복 개발? 프론트 : 이거 API 호출하면 어떤 결과가 와요? 프론트 개발자가 질문을 한다. 이 질문에 대해서는 응답과, 각 요청 파라미터에 따른 에러 케이스들, 에러일 때 던지는 값들을 말해줘야 한다. 그러면 그 설명을 듣고 프론트 개발자는 그 응답에 맞는 타입 ( JS 라면 값 ) 을 정의해둘 것이다. 이는 Node.js 백엔드 개발자 입장에서는, 백엔드에서 이미 개발한 것들을 .. 공감수 5 댓글수 10 2023. 3. 26.
  • 테스트 코드로 커뮤니케이션하기 잘 만들어진 테스트 코드는 일종의 spec, 즉 명세서의 역할을 수행할 수 있어야 한다. 또한 잘 만들어진 테스트는, 코드 설계에 앞서 개발자 간의 커뮤니케이션을 위한 도구로 사용될 수 있어야 한다. 여기서 말하는 개발자는 백엔드 개발자만이 아니라, API를 다루는 모든 관계자를 말한다. 디자인을 이야기하기 위해서는 기획서가 필요하듯이, 개발자들도 개발을 위한 기반 지식들이 필요하다. 이 지식은 단순히 개발을 위한 도메인 지식이 아니라, 서로 간의 이해가 일치하는지 확인하는 일을 포함한다. 테스트 코드는 여기서 이 일치 확인, 전체 프로그램 작성에 일관성을 확보하는 작업을 위한 것이라 볼 수 있겠다. 테스트 코드 (spec) 작성 /** * 게시글에 대한 좋아요/좋아요 취소 */ describe('PAT.. 공감수 0 댓글수 0 2023. 3. 12.
  • Nestia를 활용한 e2e 테스트 이번에 테스팅할 API는? import { TypedBody, TypedRoute } from '@nestia/core'; import { Controller } from '@nestjs/common'; import { JwtService } from '@nestjs/jwt'; import { createResponseForm, ResponseForm } from '../interceptors/transform.interceptor'; import { CreateUserDto } from '../models/dtos/create-user.dto'; import { DecodedUserToken } from '../models/tables/user.entity'; import { UsersService }.. 공감수 1 댓글수 2 2023. 3. 1.
  • Nestia TypeError 확인하기 Nestia에서는 TypeError가 나와도, 상세한 메시지는 알려주지 않았었다. 그저 간단하게 Request body is not promised type, 또는 Reponse body is not promised type, 정도의 에러만이 나왔다. 이것만 가지고는, Nestia에 익숙하지 않은 사람은 어느 부분으로 인해서 에러가 나오는 건지 알기가 어려웠다. 바로 후술하겠지만, 이건 tsconfig.json에서, nestia에 대한 설정을 바꿔주면 해결되는 문제였다. 일단 Nestia는, 아래 링크에서 주석을 확인하면, 보다시피 stringify, assert, is, validate 4가지 메서드를 설정으로 사용한다. GitHub - samchon/nestia: Superfast validation.. 공감수 0 댓글수 0 2023. 3. 1.
  • Nestia Comment Tags 엔티티에 타입 정의하기 export class UserEntity extends CommonCloumns { /** * 이름 칼럼으로 사용자의 이름을 의미 * @minLength 1 * @maxLength 50 */ @Column({ length: 50, select: false }) public name!: string; /** * 사용자의 별칭, 설정하지 않는 경우도 있다. * @minLength 1 * @maxLength 50 */ @Column({ length: 50 }) public nickname!: string; } 각 프로퍼티에는 이처럼, 주석을 통해서 태그를 달 수 있다. 태그가 아닌 주석은 해당 프로퍼티에 대한 description이 되어, 추후 swagger, sdk 생성에 활용된다... 공감수 0 댓글수 0 2023. 3. 1.
  • You provided an invalid object where a stream was expected. import { Injectable, NestInterceptor, ExecutionContext, CallHandler, RequestTimeoutException } from '@nestjs/common'; import { Observable, throwError, TimeoutError } from 'rxjs'; import { catchError, timeout } from 'rxjs/operators'; @Injectable() export class TimeoutInterceptor implements NestInterceptor { intercept(context: ExecutionContext, next: CallHandler): Observable { return next.handle().. 공감수 0 댓글수 0 2023. 2. 24.
  • Nestia 적용하기 이 글을 찾아본 것은 이미 Nestia를 알고 온 사람들일 거라 생각되기 때문에 간단한 설명만 적자면, Nestia란? Node.js, TypeScript 서버의 장점인 클라이언트와 동일한 언어 사용을 극대화하는 라이브러리라고 할 수 있다. 동일한 언어를 사용한다는 것은 서버 개발자가 미리 정의한 타입의 중복 개발을 막을 수 있다는 의미가 된다. 이로 인해 프론트 개발자는 이미 개발된 타입과 SDK를 사용해 좀 더 UI/UX 측면에 집중할 수 있게 된다. 프로젝트 생성 $ npm i -g @nestjs/cli $ nest new project-name 프로젝트 생성은 동일하게 진행해주면 된다. Nestia를 만드신 Samchon님의 레포지토리 예제 대부분은 본인 색채가 강하지만, 아래는 참고할 만 했다... 공감수 3 댓글수 1 2023. 2. 19.
  • 동일한 400 코드에 대해서 스웨거 에러 스키마 작성하기 import { SchemaObject } from '@nestjs/swagger/dist/interfaces/open-api-spec.interface'; export const ERROR = { ALREADY_CREATED_EMAIL: { code: 4001, message: '이미 생성된 이메일입니다.' }, NO_AUTH_TOKEN: { code: 4002, message: '인증이 필요합니다.' }, IS_SAME_POSITION: { code: 4003, message: '이미지의 정렬 값이 동일한 경우가 존재합니다.' }, CANNOT_FINDONE_ARTICLE: { code: 4004, message: '게시글을 찾지 못했습니다.' }, SELECT_MORE_THAN_ONE_BODY_IM.. 공감수 0 댓글수 0 2023. 2. 5.
  • NestJS에서 S3로 이미지 업로드하기 설치해야 하는 패키지 종류 $ npm i aws-sdk/client-s3 # 3.259.0 $ npm i multer # ^1.4.3" $ npm i multer-s3 # ^3.0.1 $ npm i @types/multer-s3 --save-dev # ^.3.0.0 일단 필요한 package들을 install한다. s3 package들의 경우 업데이트를 하면서 기존의 버전이 호환되지 않는 경우가 줄곧 발생한다. 혹시 몰라 버전도 주석으로 달아놓았으니 호환이 되지 않으면 버전을 맞추던가, 아니면 명시된 버전으로 진행하면 된다. NestJS에서 클라이언트로부터 이미지 받기 @Post() async upload(@UploadedFiles() files: Express.MulterS3.File[]) { if (.. 공감수 2 댓글수 0 2023. 1. 31.
  • NestJS 스웨거에서 에러 스키마 작성하기 import { SchemaObject } from '@nestjs/swagger/dist/interfaces/open-api-spec.interface'; export const ERROR = { ALREADY_CREATED_EMAIL: { code: 4001, message: '이미 생성된 이메일입니다.' }, NO_AUTH_TOKEN: { code: 4002, message: '인증이 필요합니다.' }, IS_SAME_POSITION: { code: 4003, message: '이미지의 정렬 값이 동일한 경우가 존재합니다.' }, } as const; type KeyOfError = keyof typeof ERROR; type ValueOfError = (typeof ERROR)[KeyOfError.. 공감수 0 댓글수 0 2023. 1. 31.
  • Strategy, AuthGuard에서 에러 커스텀하기 import { BadRequestException, ExecutionContext, Injectable } from '@nestjs/common'; import { AuthGuard } from '@nestjs/passport'; import { ERROR } from '@root/config/constant/error'; import { DecodedUserToken } from '@root/types'; @Injectable() export class JwtGuard extends AuthGuard('jwt') { handleRequest( err: any, user: any, info: any, context: ExecutionContext, status?: any, ): TUser { if (i.. 공감수 0 댓글수 2 2023. 1. 29.
  • NestJS 모듈 배포를 위한 코드 작성 // package.json의 일부 { "dependencies": { "@nestjs/common": "^9.2.1", "@nestjs/testing": "^9.2.1", "typescript": "^4.9.4" }, "devDependencies": { "@types/jest": "^29.2.5", "@types/node": "^18.11.18", "jest": "^29.3.1", "ts-jest": "^29.0.3" }, } 최소한의 라이브러리로 위와 같이 install을 진행했다. NestJS 라이브러리를 만들 것이기 때문에 @nestjs/common과 @nestjs/testing을 install 하였고, typescript를 쓰기 위해 typescript library와 각종 타입, 테스트를 위.. 공감수 0 댓글수 0 2023. 1. 11.
  • NestJS에 SpreadSheet API 사용하기 구글에는 googleapis 라는 라이브러리 (* 아래 링크) 도 있지만 사용하지 않는 것이 좋다. googleapis 이 라이브러리의 경우 구글에서 제공하는 모든 API가 다 들어 있기 때문에 어플리케이션에서 쓰기엔 버겁다. 용량 자체가 120MB 정도가 되는데 서버 성능이 부족하면, 예를 들어 EC2가 t3.micro, small 급이라면, 그런 경우에는 서버를 빌드할 때 JavaScript의 Heap memory가 부족하다는 오류를 내뱉으며 멈추게 된다. 그렇기 때문에 만약, 스프레드시트를 생성한다. 데이터를 넣는다. 그 시트를 구글 드라이브를 이용해 다른 사람에게 공유한다. 와 같이, 스프레드시트 이후에 연계될 다음 동작들이 있지 않다면 npm에서 적절한 라이브러리를 찾는 게 낫다. 여기서 말하는.. 공감수 0 댓글수 0 2023. 1. 1.
  • class-validator로 특정 날짜 검증하기 @IsDate() specificDate: Date; 날짜를 검증하기 위해서는 IsDate 데코레이터를 이용할 수 있다. 이렇게 작성할 경우 단순 String으로 된 Date는 무시당할 수 있기 때문에 Type 데코레이터도 필요하다. 날짜가 필수적인지 아닌지에 따라 아래와 같이 작성할 수 있다. import { applyDecorators } from '@nestjs/common'; import { Type } from 'class-transformer'; import { IsDate, IsNotEmpty } from 'class-validator'; export function IsNotEmptyDate() { return applyDecorators( IsNotEmpty(), IsDate(), Typ.. 공감수 1 댓글수 0 2023. 1. 1.
  • TypeORM에서 오늘 날짜의 데이터만 뽑기 [Postgresql] TO_CHAR로 날짜 다루기 this.repository .createQueryBuilder('qb') .where(`TO_CHAR(qb.createAt, 'yyyy-mm') = TO_CHAR(CURRENT_DATE, 'yyyy-mm')`) .getMany(); 특정 날짜의 데이터를 뽑기 위해서는 일반적으로 검색 기간의 시작 날짜와 끝 날짜를 이용해 조회한다. 그래서 where문에 MoreThan, MoreThanEqual, LessThan, LessThanEqual, Between 을 사용한다. 다만 이 방식으로는 DB에서 사용 중인 시간 대에 맞게, 클라이언트, 서버, DB 간 시간 대를 맞춰주어야 한다. 서버에서 DB 시간을 맞추든, 아니면 값을 일일히 변환해주든, 변환 과정.. 공감수 0 댓글수 0 2022. 12. 25.
  • Response DTO를 이용한 응답 직렬화 (Serialization) Response DTO를 이용한 응답 직렬화 (Serialization) 초기 기능 개발에는 서비스 로직으로 Response의 형태를 가공해서 제공해주곤 했다. 하지만 기능이 추가됨에 따라, 서비스는 유저 서비스와 판매자 서비스 등, 역할에 따라 모듈이 분리되기 시작했고, 모듈마다 동일한 형태의 데이터를 다루게 될 때마다, 서로 다른 모듈의 서비스를, 데이터 형태 가공 용으로 호출해도 되는지 의문이 됐다. 따라서, 서비스 로직 외에 응답 형태만을 가공하기 위한 레이어가 필요하다는 생각에 다다랐는데, 이 결론이 직렬화였다. 1. class-transformer와 글로벌 인터셉터 npm install reflect-metadata class-transformer reflect-metadata는 코드에 메타 .. 공감수 0 댓글수 0 2022. 11. 27.
  • [TypeORM] Null이 있는 상황에서의 orderBy const users = this.userRepository.createQueryBuilder('u') .addOrderBy('u.height', 'DESC', 'NULLS LAST') .getMany(); orderBy의 세번째 파라미터로 NULLS LAST, NULLS FIRST를 지정해서 처리할 수 있다. 공감수 0 댓글수 0 2022. 11. 27.
  • 쿼리빌더를 "조금" 더 완벽하게 해줄 setFindOptions TypeORM에는 setFindOptions 라는 메서드가 있고, 이걸 활용하면 할 수 있는 일이 참 많습니다. 하지만 공식문서에는 이 메서드에 대한 소개가 전혀 없는데요, 이건 TypeORM이 반성해야 할 부분 같습니다. 이 메서드는, QueryBuilder가 가진 문제점을 부분적이나마 해소해줍니다. 코드를 통해 보겠습니다. QueryBuilder 사용법 const posts = await connection .createQueryBuilder(Post, "post") .where('post.author IS NULL') .orderBy("post.id", "ASC") .getMany() post를 조회할 때 우리는 where문과 order를 where, orderBy라는 메서드를 통해 해결할 수 있습.. 공감수 0 댓글수 0 2022. 9. 12.
  • Repository 패턴에서 조인 대상이 Null인 경우에 대한 체크 원래 Repository에서 조인 대상에 대해 IsNull로 체크하는 것은 자잘한 버그들이 있었습니다. IsNull로 할 경우, 사용자가 기대하던 방식대로 동작하지 않았는데, 이게 버그인지 의도인지는 알 수 없었습니다. 그래서 이런 경우는, 차라리 쿼리빌더에서 InnerJoin을 하는 것이 낫다는 판단이었습니다. 어떤 식으로 동작할지 명확한 것이 차라리 낫다는 판단이었습니다. 그러고 나서 몇 달의 시간이 지나니 새로운 업데이트가 나왔습니다. 새 업데이트 내용을 보니, 기존의 코드가 의도된 게 아니라 버그였음을 확인할 수 있겠네요. 이 내용은 issue number #8890에 있는 코드를 그대로 옮겨, 해석을 달은 것입니다. 일단 기존에 코드가 어떤 문제가 있었는지, 예제 코드를 통해 이해해보겠습니다. .. 공감수 0 댓글수 0 2022. 9. 12.
  • TypeORM에서의 명시적인 제약조건 이름 선언 issue number #8524에서 JoinColumn에서의 제약 조건 이름을 추가하는 법이 추가되었습니다. 이 내용은, 기존의 방식처럼 Entity 위에 @index() 데코레이터를 통해 제약조건을 거는 것보다 명시적입니다. 인덱스 데코레이터의 경우에는 하나의 데코레이터를 이용해 Primary와 복합키, 외래키 등을 모두 표현했습니다. 따라서 그 의미가 무엇을 뜻하는지는 인덱스 데코레이터와 엔티티 칼럼과의 관계를 보고 이해해야 했습니다. issue number #8900에서는 위의 변화와 더불어 Column 데코레이터에서도 제약조건 명시를 허용했습니다. 새로이 명시된 방법은 아래와 같습니다. @Entity() export class Post { @ManyToOne((type) => Category) .. 공감수 0 댓글수 0 2022. 9. 12.
  • Module, Controller, Service, Repository 차근차근 Nest에 대해서 설명하고자 한다. 이 글에서는 Controller와 Service, Repository를 어떻게 구분하면 좋을지를 설명한다. 당연히 각 역할대로 구분하면 된다는, 간단한 소개가 되겠지만, 그 각 역할이 뭔지 이야기 해보자. Module @Module({ imports: [OtherModule], controllers: [SomeController], providers: [SomeService], exports : [SomeService], }) export class SomeModule {} Express 유저라면 처음 Nest를 접하고 나서 이해되지 않는 내부 동작에 놀랄 것이다. 너무 친절한 나머지 개발자가 이해해야 할 부분까지 다 알아서 해버리니 말이다. 그래서 아무렇게나.. 공감수 0 댓글수 0 2022. 7. 17.
  • TypeORM Repository와 ManyToMany Entity 정의 상품의 Entity 정의 /** * 상품의 Entity */ @Entity('product', { schema: 'db_name' }) export class Product { @PrimaryGeneratedColumn({ type: 'int', name: 'idx' }) idx: number; @Column('varchar', { name: 'title', length: 255 }) title: string; } 해시태그의 Entity 정의 /** * 해시태그의 Entity */ @Entity('hashtag', { schema: 'db_name' }) export class Hashtag { @PrimaryGeneratedColumn({ type: 'int', name: 'idx' .. 공감수 0 댓글수 0 2022. 7. 17.
  • Nest.js에 ConfigModule 설정 정적 모듈에서는 환경 변수 사용 불가 이번 글은 짧은 내용을 다룬다. 아마 dotenv를 사용하다가 Nestjs와 ConfigModule을 사용하려던 사람들은 시행착오를 많이 겪을 것이다. 사실 TypeORM을 써서 발생하는 문제는 아닌데, 이런 상황을 주로 만나는 게 아무래도 ORM일 것 같아서 제목에도 넣었다. Nestjs에는 ConfigModule이 있다. ConfigModule을 사용해서 미리 .env를 삽입해두면 그 하위 모듈에서는 모두 process.env를 통해서 값에 접근할 수 있게 된다. 하지만 아래 같은 경우를 보자. // nestjs recipe의 typeORM 문서를 보면 아래의 예제 코드가 있다. import { Module } from '@nestjs/common'; import.. 공감수 0 댓글수 0 2022. 7. 17.
  • Express만 하다가 Nest를 하고 느낀 점 서론 const router = express.router(); // express CRUD router.post('/', controller.postMethod); router.get('/', controller.getMethod); router.put('/', controller.putMethod); router.delete('/', controller.deleteMethod); Express에서는 다음과 같이 CRUD를 만든다. 사실 간편하고 빠르게 서버 어플리케이션을 확장할 수 있다는 게 장점이다. 하지만 Express는 구조적으로 짜임새가 있지는 않다. 그래서 결국에는 차세대 프레임워크에게 자리를 물려줄 것으로 보인다. 이제부터 직접 두 프레임워크를 다루면서 느꼈던 차이점, 그리고 Express.. 공감수 1 댓글수 0 2022. 7. 17.
  • 한 NestJS 서버에서 여러 Strategy 구현하기 서비스를 구현하다보면 당연히 여러 사용자가 존재하게 된다. 이 사용자라는 표현은, 그냥 내 임의로 부르는 호칭인데, 말하자면 유저의 성격이다. 예컨대 커머스라고 한다면 구매자와 판매자, 관리자가 있을 수 있고, 예약 서비스를 만든다면 식당 주인과 손님이라는 관계가 생길 것이다. 대개 서비스라고 함은 하나의 사용자만 존재할 리 없고, 하다 못해 관리자를 포함해 둘 이상의 사용자가 반드시 존재할 수 밖에 없다. 문제는 여기서 발생한다. "서로 다른 사용자를 어떻게 한 서버 내에서 인증하는가?" PassportStrategy에 이름 설정하기 우리가 사용하는 Gaurd들에 대해서 다시 고찰해볼 필요가 있다. Guard들은 어떻게 자신에게 할당된 전략을, 알아서 찾아가는 걸까? import { Injectable.. 공감수 0 댓글수 0 2022. 7. 17.
  • 비동기로 동작하는 Guard 인증 만들기 import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common'; import { Reflector } from '@nestjs/core'; import { InjectRepository } from '@nestjs/typeorm'; import { User} from 'src/entities/user.entity'; import { Role } from 'src/common/common.enum'; import { Repository } from 'typeorm'; import { ROLES_KEY } from '../roles/back-office-roles.decorator'; @Injectable() export class Ad.. 공감수 0 댓글수 0 2022. 7. 17.
  • 한 가지 인스턴스로만 이루어진 순수한 배열로 타입을 확정하기 여러 가지 엔티티의 칼럼이나 프로퍼티를 통일시켜, 하나의 함수를 여러 엔티티가 공유할 수 있게 작성하고 싶다. 그렇지만, 파라미터로 오는 타입들이 다른 경우, 이렇게 만드는 게 쉽지 않다. 이런 경우에는 직접 커스텀한 함수로 타입을 보호해줄 수 있는 방법이 필요하다. public format(value: Foo[] | Bar[]) { const isFooArray = isArrayOf(isInstanceOf(Foo)); if (isFooArray(value)) { // true block for (const foo of value) { const f: Foo = foo; // okay } } else { // false block for (const bar of value) { const b: Bar =.. 공감수 0 댓글수 0 2022. 7. 5.
    문의안내
    • 티스토리
    • 로그인
    • 고객센터

    티스토리는 카카오에서 사랑을 담아 만듭니다.

    © Kakao Corp.