ExpressJS

공식 문서를 살펴보면 라이브러리를 개발한 사람들이 전체 애플리케이션을 어떻게 바라보고 있는지 알 수 있는 문장들이 곳곳에 숨어있다. Express의 경우 "Express 애플리케이션은 기본적으로 일련의 미들웨어 함수 호출"이라는 표현이 개발자들의 시각을 잘 표현해주고 있다고 생각한다. Express는 일련의 미들웨어 함수가 순차적으로 호출되면서 동작하는 만큼, 미들웨어를 이해하는 것은 Express의 동작을 더 깊게 이해하는 데 큰 도움이 된다. 나는 Express의 미들웨어를 호출 되는 위치에 따라 크게 세 가지로 분류한다. 하나는 '라우터가 호출되기 전에 동작하는 미들웨어'인데, 이는 결국 모든 요청에 대해 동작해야하는 미들웨어를 의미한다. 클라이언트의 요청을 json parse 해주는 express..

Swagger는 주로 RESTful 웹 서비스의 개발 및 관리를 지원하는 오픈 소스 프레임워크이다. API와 상호 작용하는 방법을 직관적으로 제공하며, 클라이언트가 API를 테스트하고 이해하기 쉽게 만드는 데 도움을 준다. 프론트엔드 입장에서는 일일이 fetch 해보지 않아도 되기 때문에 굉장히 편리하다고 생각하고 있었다.나는 프로젝트에서 swagger-jsdoc과 swagger-ui-express를 사용하여 swagger 문서를 제공하고 있다. 기본 설정먼저 swagger 문서의 설정을 options 객체에 담아주고, 이를 swaggerJsdocs에 넣어 swaggerSpec을 뽑아내야 한다. securitySchemes 객체를 통해 인가 과정에서 JWT를 사용하겠다는 것을 옵션에 넣어줄 수 있다. 나..

우리는 앞선 포스트를 통해 S3에 이미지를 저장하는 두 가지 방법에 대해 알아보았다. 이렇게 저장된 자원들은 REST API를 통해 접근할 수 있다. 따라서 아래와 같은 방식으로 요청하면 특정 버킷으로부터 이미지 파일을 가져올 수 있다.https://[버킷 이름].[리전 이름].amazonaws.com/[파일 이름] 그런데 이러한 주소를 직접 사용하는 것은 문제가 없을까? 이러한 주소를 직접 클라이언트에 건네준다는 것은 곧 내가 사용하고 있는 S3가 어느 리전에 위치해있는지, 버킷 이름은 무엇인지와 같은 정보가 무방비하게 노출되어버리고 만다는 의미가 된다. 따라서 이번에도 백엔드 서버가 S3와 클라이언트 사이를 중개해주어야 하는데, 나는 여기서 presigned URL을 사용하고 있다. pURL은 그저 ..

클라이언트에서 보내온 이미지를 저장하는 데는 백 중 백은 AWS S3를 사용한다. 여러 이유가 있겠지만 저장소의 크기가 이론상 무한하고, 사용한 만큼 요금을 내며, REST API를 통해 자원에 접근할 수 있기 때문에 무척이나 편하다. 이 게시글에서는 이미지를 저장할 AWS S3가 이미 존재한다는 가정 하에 진행된다.S3에 이미지를 보내는 방법에는 크게 두 가지가 있다. 하나는 multer와 multer-s3 라이브러리를 사용해 Express가 직접 요청을 처리하는 방식이다. 다른 하나는 AWS S3가 제공하는 presigned URL 기능을 사용해 S3가 직접 요청을 처리하는 방식이다. 두 방식 모두 장단점은 있겠으나, 전자의 경우 백엔드 자원이 더 많이 사용되고 후자는 프론트 자원이 더 많이 사용된다..

인증과 인가의 차이나 jwt가 무엇인지는 여기서 다루지 않는다. 이 포스트에서는 그저 내가 어떤 방식으로 인증/인가를 구현하는지 그 워크플로우를 따라가볼 뿐이다. 시작하기 전에jwt 비밀키는 노출되면 곤란해지기 때문에 환경 변수를 통해 그 값들을 가져오게 된다. 나는 dotenv 라이브러리를 사용해 환경 변수의 값에 접근하기로 했다. 또한, jwt 토큰을 만들고 검증하는 데에는 jsonwebtoken 라이브러리를 사용했다. 토큰 생성 함수 구현jsonwebtoken가 제공하는 sign 함수를 사용해 토큰을 만들어줄 수 있다. 액세스 토큰과 리프레시 토큰만 생성할 예정이라 아래와 같이 하나의 함수로 통일하여 구현하였다.export function generateToken( nickname: string,..

superstruct는 NestJs의 class-validator처럼 요청의 유효성을 검사해주는 라이브러리이다. 이 라이브러리는 타입스크립트와 비슷하게 string, number, object 이외에도 다양한 기본 타입을 지원하며, 추가 검증에 필요한 Refinements나 Utility 타입을 제공하고 있다. 더 자세한 내용은 공식 문서에서 확인할 수 있다. 사실 나도 쓰는 것만 쓰는 탓에 superstruct의 방대한 기능을 다 사용하고 있지는 못하다. 기본 구조기본적인 코드 형태는 아래와 같다. object 메소드 안에 객체를 넣어두었는데, 이 객체에는 유효성을 검증하고 싶은 필드와 그 필드에 적용할 검증 방식을 정의해두고 있다. 여기에서 알 수 있는 사실은 superstruct의 object 메소..

NestJs와 달리 ExpressJs(이하 EJ)는 모듈 구성이 강제되지 않는다. 따라서 어떤 식으로 코드를 분리할 것인지는 전적으로 개발자의 몫이라고 생각된다(이러한 점이 NestJs를 더 선호하게 만드는 이유이지 않을까). EJ에서는 Router라는 메소드를 제공하는데, 이를 사용하면 각각의 코드를 라우트에 따라 분리해줄 수 있다. 그리고 이렇게 분리된 라우트는 use 메소드를 사용해 한 곳에서 호출한다.// app.tsconst app = express();app.use(express.json());app.use(cookieParser());app.use("/products", productRoutes);app.use("/articles", articleRoutes);app.listen(proces..

기본 뼈대import express from 'express';const app = express();app.use(express.json());// 라우트 정의app.method(path, handler)app.listen(3000, () => console.log('Server Started')); req, res 객체req.query : 쿼리스트링 파라미터를 프로퍼티로 담고 있는 객체. 항상 문자열req.params : URL 파라미터를 프로퍼티로 담고 있는 객체. 항상 문자열req.body : 리퀘스트 바디 내용을 담고 있는 객체res.send() : 아규먼트로 전달되는 값에 따라 Content-Type 헤더를 설정하고 적절한 바디 내용으로 변환.res.status() : 리스폰스의 상태 코드를 ..