<div id="readability-page-1" class="page"><div><h2 id="fastify-장점">Fastify 장점</h2>
Fastify 는 이름에서 알 수 있듯이, 빠른 속도를 내세우는 node.js 웹서버 프레임워크이다. 속도는 <a href="https://www.fastify.io/benchmarks/">본인들의 벤치마크</a>에 따르면, <code>express</code> 대비 약 4배, <code>koa</code> 대비 약 1.6배 빠르다.
빠른 속도 외에도, 여러 장점이 있는데, 내가 눈여겨본 장점은 다음과 같다:
<ul>
<li>좋은 공식 문서</li>
<li>뛰어난 TypeScript 지원</li>
<li><a href="https://json-schema.org/">JSON Schema</a> 문법을 이용한 Request validation</li>
<li>아주 편리한 <a href="https://swagger.io/">Swagger</a> 통합</li>
<li>기본 Logger 제공</li>
<li>손쉬운 jwt, cors 미들웨어 통합</li>
</ul>
<h2 id="fastify-서버-생성">Fastify 서버 생성</h2>
Fastify 의 서버 객체는 <code>express</code> 와 유사하게 생성하고 실행한다.
<pre><code>import fastify, { FastifyInstance } from 'fastify'

const server: FastifyInstance = fastify()</code></pre>
<code>fastify</code> 생성자에 파라미터로 이것저것 넘겨줄 수 있다. 난 기본 Logger 사용 설정과, Request Body 사이즈 제한값만 추가하였다. 이 외에 <a href="https://www.fastify.io/docs/latest/Server/">다양한 옵션들</a>이 가능하니 참고하도록 하자.
<pre><code>import fastify, { FastifyInstance } from 'fastify'

const server: FastifyInstance = fastify({
 bodyLimit: 10485760,
 logger: true
})</code></pre>
<h2 id="fastify-기본-logger">Fastify 기본 Logger</h2>
참고로 기본 Logger 는 기본적으로 JSON 형태의 구조화된 로그를 콘솔창에 출력한다.
<pre><code>{"level":30,"time":1629171047623,"pid":62407,"hostname":"morphism0ui-MacBookPro.local","msg":"Server listening at http://0.0.0.0:8090"}</code></pre>
기본적으로 Request, Response 를 기록하며, 코드 중간에 로그를 기록하고 싶다면, <code>request</code> 객체에서 <code>log</code> 속성값을 꺼내 사용할 수 있다.
<pre><code>request.log.error(err)
request.log.info('Hello, world!')</code></pre>
<h2 id="fastify-cors">Fastify CORS</h2>
CORS 설정을 위해서는 Fastify 팀에서 개발하는 <a href="https://github.com/fastify/fastify-cors"><code>fastify-cors</code></a> 패키지를 설치해야 한다. <code>express</code>와 비슷하게, Fastify 에서도 CORS, JWT 등은 모두 미들웨어로 구현된다. 그리고 이러한 미들웨어는 (당연히) 개인이 직접 개발해서 추가할 수도 있다. 미들웨어를 등록하기 위해서는 <code>express.use</code> 와 비슷한 <code>register</code> 라는 함수가 있다.
<pre><code>import cors from 'fastify-cors'

const server: FastifyInstance = fastify()

server.register(cors, { origin: '*' })</code></pre>
필요한 CORS 설정은 왠만한건 다 할 수 있으니, <code>fastify-cors</code> 패키지 저장소의 문서를 참고하자.
<h2 id="fastify-서버-실행">Fastify 서버 실행</h2>
대충 적당히 설정이 끝나면, 아래 코드를 이용하여 서버를 실행할 수 있다.
<pre><code>server.listen(8080, '0.0.0.0')</code></pre>
기본 Logger 가 설정되어 있다면, 자동으로 아래와 같이 서버 실행 로그를 찍는다.
<pre><code>{"level":30,"time":1629171047623,"pid":62407,"hostname":"morphism0ui-MacBookPro.local","msg":"Server listening at http://0.0.0.0:8090"}</code></pre>
또한, <code>listen</code> 함수는 <code>Promise&lt;string&gt;</code> 을 반환하는데, 이때 <code>string</code> 은 서버가 실행되는 주소값으로, <code>http://0.0.0.0:8080</code>과 같은 값을 갖는다.</div></div>

byron1st.log

안휘

Fastify 장점
Fastify 는 이름에서 알 수 있듯이, 빠른 속도를 내세우는 node.js 웹서버 프레임워크이다. 속도는 본인들의 벤치마크에 따르면, express 대비 약 4배, koa 대비 약 1.6배 빠르다.
빠른 속도 외에도, 여러 장점이 있는데, 내가 눈여겨본 장점은 다음과 같다:
좋은 공식 문서
뛰어난 TypeScript 지원
JSON Schema 문법을 이용한 Request validation
아주 편리한 Swagger 통합
기본 Logger 제공
손쉬운 jwt, cors 미들웨어 통합
Fastify 서버 생성
Fastify 의 서버 객체는 express 와 유사하게 생성하고 실행한다.
import fastify, { FastifyInstance } from 'fastify'
const server: FastifyInstance = fastify()
fastify 생성자에 파라미터로 이것저것 넘겨줄 수 있다. 난 기본 Logger 사용 설정과, Request Body 사이즈 제한값만 추가하였다. 이 외에 다양한 옵션들이 가능하니 참고하도록 하자.
import fastify, { FastifyInstance } from 'fastify'
const server: FastifyInstance = fastify({
 bodyLimit: 10485760,
 logger: true
})
Fastify 기본 Logger
참고로 기본 Logger 는 기본적으로 JSON 형태의 구조화된 로그를 콘솔창에 출력한다.
{"level":30,"time":1629171047623,"pid":62407,"hostname":"morphism0ui-MacBookPro.local","msg":"Server listening at http://0.0.0.0:8090"}
기본적으로 Request, Response 를 기록하며, 코드 중간에 로그를 기록하고 싶다면, request 객체에서 log 속성값을 꺼내 사용할 수 있다.
request.log.error(err)
request.log.info('Hello, world!')
Fastify CORS
CORS 설정을 위해서는 Fastify 팀에서 개발하는 fastify-cors 패키지를 설치해야 한다. express와 비슷하게, Fastify 에서도 CORS, JWT 등은 모두 미들웨어로 구현된다. 그리고 이러한 미들웨어는 (당연히) 개인이 직접 개발해서 추가할 수도 있다. 미들웨어를 등록하기 위해서는 express.use 와 비슷한 register 라는 함수가 있다.
import cors from 'fastify-cors'
const server: FastifyInstance = fastify()
server.register(cors, { origin: '*' })
필요한 CORS 설정은 왠만한건 다 할 수 있으니, fastify-cors 패키지 저장소의 문서를 참고하자.
Fastify 서버 실행
대충 적당히 설정이 끝나면, 아래 코드를 이용하여 서버를 실행할 수 있다.
server.listen(8080, '0.0.0.0')
기본 Logger 가 설정되어 있다면, 자동으로 아래와 같이 서버 실행 로그를 찍는다.
{"level":30,"time":1629171047623,"pid":62407,"hostname":"morphism0ui-MacBookPro.local","msg":"Server listening at http://0.0.0.0:8090"}
또한, listen 함수는 Promise<string> 을 반환하는데, 이때 string 은 서버가 실행되는 주소값으로, http://0.0.0.0:8080과 같은 값을 갖는다.

Fastify 서버 생성

댓글