http 모듈

정의

Node.js의 http 모듈은 HTTP 프로토콜을 사용하여 서버 및 클라이언트를 생성하는 데 사용되는 핵심 모듈입니다. HTTP 서버를 만들고 요청을 처리하며, 클라이언트로부터 요청을 만들어 서버로 전송하는 데 사용됩니다.

문법

const http = require('http');
JavaScript
복사

주요 속성 및 메소드

속성/메소드	설명
http.createServer()	HTTP 서버 인스턴스를 생성합니다.
server.listen()	서버를 지정된 포트와 호스트로 바인딩하고 연결을 수신하기 시작합니다.
server.close()	서버가 새로운 연결을 수락하는 것을 중단합니다.
server.on(event, callback)	서버 이벤트에 대한 리스너를 등록합니다.
request 객체	서버로 들어오는 HTTP 요청을 나타냅니다.
response 객체	서버에서 나가는 HTTP 응답을 나타냅니다.

속성/메소드	설명
req.url	요청의 URL을 포함합니다.
req.method	요청의 HTTP 메소드를 포함합니다(GET, POST 등).
req.headers	요청의 헤더를 포함합니다.

속성/메소드	설명
res.writeHead(statusCode, [headers])	응답 헤더를 지정된 상태 코드와 헤더로 작성합니다.
res.write(data)	데이터를 응답 본문에 작성합니다.
res.end([data])	응답 프로세스를 종료하고 클라이언트에 데이터를 전송합니다.
res.statusCode	응답의 HTTP 상태 코드를 가져오거나 설정합니다.
res.setHeader(name, value)	응답의 단일 헤더를 설정합니다.
res.getHeader(name)	응답에서 지정된 헤더의 값을 가져옵니다.

예시 코드

const http = require('http');

// HTTP 서버 생성
const server = http.createServer((req, res) => {
  // 요청에 대한 처리 로직
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello, World!\n');
});

// 서버가 3000번 포트에서 동작하도록 리스닝
server.listen(3000, '127.0.0.1', () => {
  console.log('Server is listening on port 3000');
});
JavaScript
복사

사용 목적

•

웹 서버 개발: HTTP 모듈을 사용하여 Node.js에서 간단하게 웹 서버를 만들고 요청을 처리할 수 있습니다.

•

API 서버 구축: HTTP 모듈을 활용하여 RESTful API를 제공하는 서버를 구현할 수 있습니다.

•

클라이언트 요청 처리: HTTP 클라이언트를 통해 다른 서버로 요청을 보내고 응답을 처리할 수 있습니다.

localhost

•

정의: "localhost"는 현재 사용 중인 컴퓨터를 나타내는 특별한 호스트 이름입니다. 일반적으로 이것은 루프백 주소(Loopback address)인 IPv4 주소인 "127.0.0.1"과 IPv6 주소인 "::1"을 가리킵니다. 이는 컴퓨터 자체를 가리키며, 네트워크를 통하지 않고 자기 자신에게 데이터를 보낼 수 있습니다.

•

용도: 주로 개발 및 테스트 목적으로 로컬 컴퓨터에서 실행 중인 서버에 접근할 때 사용됩니다.

port

•

정의: 포트는 컴퓨터 내의 네트워크 서비스를 식별하기 위한 숫자입니다. 포트는 IP 주소 뒤에 콜론(:)을 붙여 나타냅니다. 예를 들어, "http://localhost:3000"에서 "3000"은 포트 번호입니다.

•

용도: 여러 서비스가 한 컴퓨터에서 동시에 실행될 수 있도록 하며, 한 서버에서 여러 서비스를 제공하거나 여러 개의 서버를 운영할 때 포트는 서비스를 식별하는 데 사용됩니다.

예시 코드

Hello Node (8080)

const http = require('http');

http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.write('<h1>Hello Node!</h1>');
  res.end('<p>Hello Server!</p>');
})
  .listen(8080, () => { // 서버 연결
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

이벤트 리스너

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.write('<h1>Hello Node!</h1>');
  res.end('<p>Hello Server!</p>');
});
server.listen(8080);

server.on('listening', () => {
  console.log('8080번 포트에서 서버 대기 중입니다!');
});
server.on('error', (error) => {
  console.error(error);
});
JavaScript
복사

여러 서버 실행

const http = require('http');

http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.write('<h1>Hello Node!</h1>');
  res.end('<p>Hello Server!</p>');
})
  .listen(8080, () => { // 서버 연결
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });

http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.write('<h1>Hello Node!</h1>');
  res.end('<p>Hello Server!</p>');
})
  .listen(8081, () => { // 서버 연결
    console.log('8081번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

예외 처리

•

js

const http = require('http');
const fs = require('fs').promises;

http.createServer(async (req, res) => {
  try {
    const data = await fs.readFile('./index.html');
    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
    res.end(data);
  } catch (err) {
    console.error(err);
    res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end(err.message);
  }
})
  .listen(8080, () => {
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

•

html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>Hello Node.js</title>
</head>
<body>
    <h1>Hello Node.js</h1>
    <p>Main</p>
</body>
</html>
JavaScript
복사

REST (Representational State Transfer)

: 상태 표현 전송 아키텍처

present [prɪˈzent]

: 보여주다

represent [ˌreprɪˈzent]

: 다시 보여주다, 대신 표현하다

re-(다시) + present(보여주다) 다시 보여주다, 대표하다, 대변하다

representational [ ˌreprɪzenˈteɪʃnl ]

: 표현하는, 보여주는

REST

URI + HTTP메소드 로 자원을 표현하는 아키텍처

상태 표현 전송 아키텍처

자원의 상태를 표현하여 전달하는 아키텍처

URI 로 자원을 대신하여 표현하고, 서버가 해야 할 행위(서버의 상태)를 HTTP 메소드로 표현하는 것을 원칙으로 하는 아키텍처

•

네트워크 아키텍처 중의 하나입니다.

•

프론트엔드 및 백엔드의 독립성과 확장성 향상시킵니다.

URI (Uniform Resource Identifier)

요청할 자원의 위치를 나타내는 문자열

: 인터넷 상에서 특정 리소스를 식별하고 위치를 지정하는 문자열

구성 요소

scheme:[//authority]path[?query][#fragment]
JavaScript
복사

구성 요소	설명	예시
Scheme	리소스에 접근하는 방법을 나타냄	http, https, ftp
Authority	리소스의 위치나 소유자를 나타냄	www.example.com
Path	리소스의 경로를 나타냄	/path/to/resource
Query	리소스에 전달되는 매개변수를 나타냄	?key1=value1&key2=value2
Fragment	리소스 내에서 특정 부분을 가리키는 부분	#section1

https://www.example.com/path/to/resource?key1=value1&key2=value2#section1
JavaScript
복사

•

Scheme은 "https"

•

Authority는 "www.example.com"

•

Path는 "/path/to/resource"

•

Query는 "?key1=value1&key2=value2"

•

Fragment는 "#section1"입니다.

HTTP 메소드

- 클라이언트가 서버가 해야할 행위를 알려주는 명령어 - 요청 목적을 알려주는 명령어

메소드	설명
GET	리소스를 요청하기 위해 사용되는 메소드. 주로 정보를 요청하며, 데이터는 URL에 포함되거나 쿼리 매개변수로 전달됨.
POST	서버에 새로운 데이터를 제출할 때 사용되는 메소드. 주로 HTML 양식을 통해 데이터를 서버로 제출할 때 사용됨.
PUT	목적 리소스의 특정 위치에 새로운 데이터를 저장하도록 요청하는 메소드. 기존 데이터를 대체하거나 없으면 새로운 데이터를 생성함.
DELETE	특정 리소스를 삭제하기 위해 사용되는 메소드.
PATCH	리소스의 일부를 업데이트하기 위해 사용되는 메소드. PUT과 유사하지만, 리소스 전체를 업데이트하는 대신 일부를 수정함.
HEAD	GET 메소드와 유사하지만, 서버는 응답 본문을 제공하지 않고 헤더만을 반환함. 주로 리소스의 메타데이터를 확인하기 위해 사용됨.
OPTIONS	서버에서 지원하는 메소드들을 확인하기 위해 사용됨. 클라이언트는 서버에게 지원되는 메소드들을 물어보고, 서버는 그에 대한 응답을 제공함.
TRACE	클라이언트가 보낸 요청 메시지를 서버까지 추적하기 위해 사용됨. 주로 디버깅 목적으로 사용되며, 일반적으로 보안상의 이유로 비활성화됨.

REST 기반 서버 주소 예시

HTTP 메서드	주소	역할
GET	/	index.html 파일 제공
GET	/users	사용자 목록
GET	/users/id	해당 id의 사용자 정보 제공
POST	/users	사용자 등록
PUT	/users/id	해당 id의 사용자 수정
DELETE	/users/id	해당 id의 사용자 삭제
GET	/about	about.html 파일 제공

Overview

•

REST 자세히 알아보기

•

RESTful

•

RESTful API

•

CRUD

•

RESTful CRUD

•

REST 아키텍처를 사용하는 이유

•

Server Side Rendering (SSR)

•

Client Side Rendering (CSR)

•

Non-RESTful VS RESTful 

•

REST 아키텍처의 6가지 원칙

REST 자세히 알아보기

2000 년 로이 필딩 (Roy Fielding) 의 박사 논문에서 소개된 개념이다.

REST 아키텍처를 제시한 핵심 인물 중 한 명으로, HTTP 프로토콜과 월드 와이드 웹 (WWW)의 핵심 표준화에 기여했습니다. 필딩은 그의 박사학위 논문에서 REST(Representational State Transfer) 아키텍처를 소개하여, 분산 하이퍼미디어 시스템을 위한 설계 원칙을 제안했습니다. 이후 많은 웹 서비스와 API가 REST 아키텍처 스타일을 적용하여 구축되었습니다.

REST는 Representational State Transfer의 약자로, 웹 개발에서 네트워크 애플리케이션을 설계하는 데 자주 사용되는 아키텍처 스타일입니다. REST의 원칙을 준수하는 RESTful API는 다른 시스템 간에 HTTP를 통해 통신하고 데이터를 교환할 수 있게 해줍니다.

REST는 간단하고 유연한 아키텍처로, 자원을 URI(Uniform Resource Identifier)로 표현하고, HTTP 메소드(GET, POST, PUT, DELETE 등)를 사용하여 해당 자원에 대한 액션을 수행합니다. 또한, RESTful API는 상태를 관리하지 않고, 요청에 필요한 모든 정보를 요청 자체에 포함시킵니다.

이러한 RESTful API의 장점은 다음과 같습니다:

•

간결성: 직관적이고 간결한 인터페이스를 제공합니다.

•

확장성: 시스템을 느슨하게 결합하여 확장이 용이합니다.

•

가시성: 자원에 대한 표준화된 인터페이스를 제공하므로, 개발자들이 API를 이해하고 사용하기 쉽습니다.

따라서, RESTful API는 현대적인 웹 개발에서 매우 중요한 역할을 담당하고 있으며, 많은 웹 애플리케이션과 서비스가 REST를 기반으로 구축되고 있습니다.

RESTful

: REST 아키텍처를 따르는 시스템 또는 서비스를 가리키는 용어입니다

RESTful API

REST 아키텍처 원칙을 따르는 API로, RESTful 서비스를 위한 인터페이스입니다. 이 API는 웹 서비스를 구축하거나 통합하는 데 사용됩니다.

주로 HTTP를 기반으로 하며, 자원을 URL로 표현하고 HTTP 메소드(GET, POST, PUT, DELETE 등)를 사용하여 자원을 관리하며, JSON 또는 XML과 같은 데이터 형식을 통해 데이터를 교환합니다.

RESTful API는 간단하고 직관적이며, 서버와 클라이언트 사이의 통신을 효율적으로 수행하는 데 도움이 됩니다.

CRUD

CRUD는 데이터의 기본적인 작업을 나타내는 약어로, Create(생성), Read(읽기), Update(수정), Delete(삭제)의 네 가지 기본 작업을 말합니다. 이 네 가지 작업은 주로 데이터베이스와 관련된 작업에서 사용됩니다:

RESTful CRUD

CRUD 작업	요청 메소드	설명
Create	POST	새로운 데이터 레코드를 생성
Read	GET	데이터를 읽거나 조회
Update	PUT/PATCH	데이터 레코드를 수정 또는 갱신
Delete	DELETE	데이터를 삭제

RESTful API는 이러한 HTTP 메소드를 사용하여 서버의 자원을 관리하는 데 활용됩니다. 예를 들어, POST 요청을 통해 새로운 데이터를 생성하고, GET 요청을 통해 데이터를 읽거나 조회하며, PUT 또는 PATCH 요청을 통해 데이터를 수정하고, DELETE 요청을 통해 데이터를 삭제할 수 있습니다. 이러한 HTTP 메소드를 이용하여 각각의 CRUD 작업을 수행하는 것이 RESTful API의 주요 특징 중 하나입니다.

REST 아키텍처를 사용하는 이유

RESTful API는 일반적으로 HTTP 프로토콜을 따르고, 요청과 응답을 표준화된 방식으로 처리함으로써, 다양한 언어나 플랫폼 간에 상호운용성을 보장합니다. 이는 프론트엔드와 백엔드를 분리하고, 각 영역을 독립적으로 개발할 때 매우 유용합니다. 따라서 프론트엔드와 백엔드를 독립적으로 개발하는 경우 RESTful API를 사용하는 것이 일반적으로 권장됩니다.

REST 는 네트워크 아키텍처의 일종입니다.

주요 네트워크 아키텍처 종류

계층화된 아키텍처(Layered Architecture)
: 네트워크 시스템이 여러 계층으로 구성되어 있으며, 각 계층은 특정한 역할과 책임을 갖습니다. OSI 7계층 모델이 이러한 계층화 아키텍처의 한 예입니다.

RESTful 아키텍처(Representational State Transfer)
: REST는 클라이언트와 서버 간의 통신을 위한 웹 아키텍처의 한 형태로, 리소스를 URL을 통해 식별하고 HTTP 메소드를 사용하여 리소스에 접근하는 아키텍처 원칙입니다.

마이크로서비스 아키텍처(Microservices Architecture)
: 이 아키텍처는 애플리케이션을 여러 작은 서비스로 분할하여 각 서비스가 독립적으로 구성되고 실행되도록 하는 구조를 말합니다.

Server Side Rendering (SSR)

서버 측 렌더링(Server-Side Rendering, SSR)은 사용자가 웹페이지에 접속했을 때, 서버에서 해당 페이지를 완전히 렌더링하고 완성된 HTML 문서로 클라이언트에게 제공하는 기술입니다. 클라이언트에서는 서버로부터 전달된 완성된 HTML을 받아 화면에 표시하는 방식입니다.

Client Side Rendering (CSR)

클라이언트 측 렌더링 (Client-Side Rendering 또는 CSR)은 웹 애플리케이션을 사용자의 브라우저에서 JavaScript를 사용하여 완전히 렌더링하는 프로세스를 의미합니다. 이 방식은 웹 애플리케이션의 정적 파일을 로드하고 사용자 상호 작용에 따라 API에서 데이터를 가져와 DOM을 조작하여 내용을 동적으로 표시합니다.

CSR(Client-Side Rendering)에서는 주로 JSON 또는 XML과 같은 데이터를 받아 자바스크립트로 렌더링하고, React, Vue, Angular 등의 프레임워크 또는 라이브러리를 사용하여 클라이언트 측에서 웹 애플리케이션의 렌더링을 담당합니다. 페이지 로딩 후, 프론트엔드 라이브러리가 서버에서 받은 데이터를 동적으로 렌더링하여 사용자에게 보여줍니다. 이 과정은 클라이언트 측에서 이루어지므로 브라우저에서 빠르게 화면을 표시할 수 있습니다.

Non-RESTful 시스템

Non-RESTful 시스템은 REST 아키텍처의 원칙을 따르지 않는 시스템을 의미합니다. 이러한 시스템은 REST의 기본 원칙 중 일부 또는 전혀 적용되지 않을 수 있습니다.

비RESTful 시스템에서는 자원을 URI로 표현하는 것이 불명확하거나 일관성이 없을 수 있습니다. 또한, HTTP 메서드를 올바르게 사용하지 않거나, Hypermedia를 활용하지 않는 등 REST 아키텍처에서 규정한 원칙을 따르지 않는 특성을 보일 수 있습니다.

RESTful 시스템

RESTful 시스템은 REST의 기본 원칙인 자원 식별, 자기서술형 메시지, HATEOAS(하이퍼미디어 제어 상태) 등을 적용하는 시스템을 가리킵니다. 이러한 시스템은 일관된 URI, HTTP 메소드의 사용, Hypermedia의 적극적인 활용과 같은 REST 아키텍처의 원칙을 따르며, 이를 통해 확장성과 유지보수성이 향상됩니다.

Non-RESTful VS RESTful

REST 아키텍처의 6가지 원칙

인터페이스 일관성 (Uniform Interface)

무상태 (Stateless)

캐싱 가능 (Cacheable)

계층화 (Layered System)

Code on Demand

클라이언트/서버 구조 (Client/Server Architecture)

인터페이스 일관성 (Uniform Interface)

일관적인 인터페이스로 분리되어야 한다.

REST 인터페이스는 일관성을 가져야 합니다. 이는 리소스에 접근하는 방법이 일관되어야 함을 의미합니다. 리소스에 대한 정보는 리소스 식별자와 함께 요청되며, 서버는 리소스 상태를 클라이언트에게 전달합니다.

무상태 (Stateless)

각 요청 간 클라이언트의 콘텍스트가 서버에 저장되어서는 안 된다

요청 간 상태 정보를 유지하지 않는 원칙입니다. 각 요청은 그 요청 자체에 필요한 모든 정보를 포함해야 하며, 서버는 각 요청을 별개의 요청으로 취급해야 합니다.

캐싱 가능 (Cacheable)

WWW에서와 같이 클라이언트는 응답을 캐싱할 수 있어야 한다.

클라이언트는 응답을 캐싱할 수 있어야 합니다. 서버는 응답에 캐시 제어 헤더를 추가하여 캐싱 동작을 조절할 수 있습니다.

캐싱

캐싱은 자주 사용되는 데이터를 미리 저장해두고 필요할 때마다 빠르게 사용하도록 하는 기술입니다.

계층화 (Layered System)

클라이언트는 대상 서버에 직접 연결되었는지, 연결되었는지를 알 수 없다.

REST는 계층화된 구조를 가집니다. 서버는 다양한 계층으로 나뉘어 있으며, 클라이언트는 서버와 직접 통신하지만, 실제 서버가 처리되는 위치를 알 필요가 없습니다.

Code on Demand

서버가 클라이언트가 실행시킬 수 있는 로직을 전송하여 기능을 확장시킬 수 있다.

"Code on Demand"는 리소스가 서버에서 클라이언트로 보내지는 동안에 클라이언트에게 실행 가능한 코드를 전송하여, 클라이언트가 실행할 수 있는 기능을 확장하는 원칙을 가리킵니다. 클라이언트는 이 코드를 실행할 수 있어야 하며, 일반적으로 JavaScript가 가장 일반적인 사용 사례입니다.

클라이언트/서버 구조 (Client/Server Architecture)

클라이언트-서버의 각 파트가 독립적으로 개선될 수 있도록 해준다.

REST는 클라이언트와 서버가 분리되어야 한다는 원칙입니다. 서버는 데이터 저장, 관리, 백엔드 로직을 처리하고, 클라이언트는 사용자 인터페이스를 제공하고 사용자 요청을 서버로 전송합니다.

REST 아키텍처의 URL 명명 규칙

명사 사용

: URL은 리소스를 나타내며, 리소스에 대한 동작은 HTTP 메서드를 통해 수행되므로, 명사를 사용하여 리소스를 나타내는 것이 좋습니다.

복수형 사용

: 리소스를 나타낼 때 복수형을 사용하는 것이 좋습니다. 예를 들어, /users, /posts와 같이 리소스 복수형을 사용합니다.

하위 리소스를 위한 중첩 URL 사용

: 관계가 있는 리소스의 경우, 중첩 URL 구조 (/super/sub) 를 사용하여 관계를 명확히 합니다.

하이픈(-) 대신 언더스코어(_) 사용

: 가독성을 높이고 식별을 쉽게 하기 위해 언더 스코어(_)를 사용하는 것이 좋습니다. (단, 리소스 이름의 띄어쓰기는 하이픈(-) 사용)

단순하고 직관적인 URL

: URL은 리소스를 식별하는 데 사용되며, 이것은 직관적이고 명확해야 합니다. 하나의 리소스에 하나의 URL 을 대응하는 것이 좋으며 파일 확장자 (.html, .jsp 등)를 사용하지 않습니다.

라우팅 (Routing)

클라이언트에 요청을 처리할 처리기(Handler, method) 를 결정하는 것

•

웹 개발에서 라우팅은 특정 URL 경로에 대한 요청이 어떤 처리기(Handler)로 전달되어야 하는지를 결정하는 것을 의미합니다.

•

클라이언트가 특정 URL에 요청을 보내면, 서버는 해당 요청을 처리할 적절한 핸들러나 컨트롤러로 라우팅하여 적절한 응답을 생성합니다.

•

이는 주로 웹 어플리케이션 프레임워크에서 구현되며, 각 URL 경로에 대응되는 컨트롤러나 핸들러를 등록하고 관리합니다.

라우팅 예시

HTTP 메서드	주소	역할
GET	/	index.html 파일 제공
GET	/users	사용자 목록
GET	/users/id	해당 id의 사용자 정보 제공
POST	/users	사용자 등록
PUT	/users/id	해당 id의 사용자 수정
DELETE	/users/id	해당 id의 사용자 삭제
GET	/about	about.html 파일 제공

예시 코드

const http = require('http');
const fs = require('fs');

// 서버 생성
const server = http.createServer((req, res) => {
  // 요청 메서드와 URL 파싱
  const method = req.method;
  const url = req.url;

  // 주소 및 메서드에 따른 응답 처리
  if (method === 'GET' && url === '/') {
    // GET / - index.html 파일 제공
    fs.readFile('index.html', (err, data) => {
      if (err) {
        res.writeHead(500, { 'Content-Type': 'text/plain' });
        res.end('Internal Server Error');
      } else {
        res.writeHead(200, { 'Content-Type': 'text/html' });
        res.end(data);
      }
    });
  } else if (method === 'GET' && url === '/users') {
    // GET /users - 사용자 목록
    res.writeHead(200, { 'Content-Type': 'application/json' });
    const users = [{ id: 1, name: 'User 1' }, { id: 2, name: 'User 2' }];
    res.end(JSON.stringify(users));
  } else if (method === 'GET' && url.startsWith('/users/')) {
    // GET /users/id - 해당 id의 사용자 정보 제공
    const userId = url.split('/')[2];
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end(`User information for ID ${userId}`);
  } else if (method === 'POST' && url === '/users') {
    // POST /users - 사용자 등록
    res.writeHead(201, { 'Content-Type': 'text/plain' });
    res.end('User created successfully');
  } else if (method === 'PUT' && url.startsWith('/users/')) {
    // PUT /users/id - 해당 id의 사용자 수정
    const userId = url.split('/')[2];
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end(`User information updated for ID ${userId}`);
  } else if (method === 'DELETE' && url.startsWith('/users/')) {
    // DELETE /users/id - 해당 id의 사용자 삭제
    const userId = url.split('/')[2];
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.end(`User ${userId} deleted`);
  } else if (method === 'GET' && url === '/about') {
    // GET /about - about.html 파일 제공
    fs.readFile('about.html', (err, data) => {
      if (err) {
        res.writeHead(500, { 'Content-Type': 'text/plain' });
        res.end('Internal Server Error');
      } else {
        res.writeHead(200, { 'Content-Type': 'text/html' });
        res.end(data);
      }
    });
  } else {
    // 그 외의 경우 404 Not Found
    res.writeHead(404, { 'Content-Type': 'text/plain' });
    res.end('Not Found');
  }
});

// 서버를 3000 포트에서 실행
const PORT = 3000;
server.listen(PORT, () => {
  console.log(`Server is listening on port ${PORT}`);
});
JavaScript
복사

쿠키란? (cookie)

: 웹 서버와 클라이언트 간의 상태 정보를 저장하고 주고받을 수 있는 작은 데이터 조각

쿠키는 클라이언트의 로컬 브라우저에 저장되는 작은 데이터 조각으로, 서버에서 클라이언트로 전송되어 웹 사이트에서 상태 정보를 유지하거나 사용자를 식별하는 데 사용됩니다. 주로 세션 유지, 사용자 추적, 사용자 설정 등의 목적으로 활용됩니다.

주요 특징:

•

클라이언트 측에 저장되므로 보안상 취약할 수 있음.

•

주로 텍스트 형식으로 저장되며, 이름과 값의 쌍으로 구성됨.

•

만료 날짜 및 경로 설정을 통해 지속적이거나 일시적인 성격의 쿠키를 생성할 수 있음.

쿠키 생성 및 저장

쿠키 생성 단계

쿠키는 처음에 서버 측에서 생성되어 응답에 담겨서 전송됨

쿠키 저장 단계

클라이언트는 응답받은 쿠키를 쿠키 저장소에 저장함

쿠키 전송 단계

클라이언트가 같은 경로(URL) 요청 시, 쿠키를 포함하여 요청 전송함

쿠키 생성 및 저장

•

쿠키는 서버 측에서 생성

•

쿠키는 클라이언트 측에 저장

쿠키를 사용하는 주요 기능

•

사용자 인증 및 로그인 관리

•

장바구니 및 주문 처리

•

아이디 저장

•

언어 및 지역 설정

•

다크 모드

예시 코드

•

쿠키 등록

- Cookie 이름 : mycookie - Cookie 값 : test

const http = require('http');

http.createServer((req, res) => {
  console.log(req.url, req.headers.cookie);
  res.writeHead(200, { 'Set-Cookie': 'mycookie=test' });
  res.end('Hello Cookie');
})
  .listen(8080, () => {
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

•

쿠키 사용 - js

const http = require('http');
const fs = require('fs').promises;
const path = require('path');

const parseCookies = (cookie = '') =>
  cookie
    .split(';')
    .map(v => v.split('='))
    .reduce((acc, [k, v]) => {
      acc[k.trim()] = decodeURIComponent(v);
      return acc;
    }, {});

http.createServer(async (req, res) => {
  const cookies = parseCookies(req.headers.cookie); // { mycookie: 'test' }
  // 주소가 /login으로 시작하는 경우
  if (req.url.startsWith('/login')) {
    const url = new URL(req.url, 'http://localhost:8080');
    const name = url.searchParams.get('name');
    const expires = new Date();
    // 쿠키 유효 시간을 현재시간 + 5분으로 설정
    expires.setMinutes(expires.getMinutes() + 5);
    res.writeHead(302, {
      Location: '/',
      'Set-Cookie': `name=${encodeURIComponent(name)}; Expires=${expires.toGMTString()}; HttpOnly; Path=/`,
    });
    res.end();
  // name이라는 쿠키가 있는 경우
  } else if (cookies.name) {
    res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end(`${cookies.name}님 안녕하세요`);
  } else {
    try {
      const data = await fs.readFile(path.join(__dirname, 'cookie2.html'));
      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
      res.end(data);
    } catch (err) {
      res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
      res.end(err.message);
    }
  }
})
  .listen(8080, () => {
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

•

쿠키 사용 - html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>쿠키&세션 이해하기</title>
</head>
<body>
<form action="/login">
    <input id="name" name="name" placeholder="이름을 입력하세요" />
    <button id="login">로그인</button>
</form>
</body>
</html>
JavaScript
복사

세션이란? (session)

: 클라이언트와 웹 서버 간의 상태를 지속적으로 유지하는 방법

세션은 서버 측에서 사용자의 상태를 추적하는 기술로, 클라이언트와 서버 간에 정보를 저장하는 방식입니다. 주로 로그인 상태 유지, 사용자 인증 등에 활용됩니다.

주요 특징

•

서버에 저장되므로 상대적으로 안전함.

•

세션 ID를 사용하여 클라이언트를 식별하고, 서버에 해당 세션과 관련된 정보를 저장함.

•

일반적으로 쿠키를 기반으로 하지만, 쿠키보다는 보안적인 측면에서 강력함.

세션을 사용하는 주요 기능

•

사용자 인증 및 로그인 관리

•

장바구니 및 주문 처리

세션 생명 주기

세션은 클라이언트가 사이트에 접속한 순간부터 브라우저를 종료하는 시점까지 유지됩니다.

•

로그인 정보는 세션에 등록되기 때문에 로그인 후 브라우저의 모든 탭을 종료하고 다시 사이트에 접속하면 로그아웃이 되어 있는 것을 볼 수 있습니다.

•

크롬 브라우저의 경우, 새 시크릿 창을 열면 별도의 새로운 세션으로 테스트 해볼 수 있습니다.
(… > 새 시크릿 창 (Ctrl + Shift + N)

생성 (Creation)
: 클라이언트가 웹 애플리케이션에 최초로 접속하면, 서버는 해당 클라이언트를 위한 새로운 세션을 생성합니다. 이때 고유한 세션 식별자(ID)가 생성되고, 이 ID를 사용하여 세션을 식별합니다.

활성화 (Activation)
: 세션이 생성되면 활성 상태가 되며, 클라이언트와 서버 간의 데이터 교환을 허용합니다. 클라이언트가 웹 애플리케이션에 요청을 보낼 때마다 세션은 활성화 상태를 유지합니다.

비활성화 (Inactivation)
: 세션은 일정 시간 동안 활성화 상태를 유지한 후, 클라이언트의 요청이 없을 경우 비활성화 상태로 전환됩니다. 이때, 세션은 메모리에서 해제되지 않고, 재활성화될 때까지 대기합니다.

종료 (Expiration)
: 세션이 만료되면 종료됩니다. 만료는 두 가지 방법으로 발생할 수 있습니다. 첫 번째 방법은 세션을 만든 웹 애플리케이션의 설정에 지정된 시간(세션 타임아웃)이 경과한 경우입니다. 두 번째 방법은 세션을 프로그래밍적으로 무효화(invalidate)하는 경우입니다.

강제 종료 (Forced Termination)
: 웹 애플리케이션 개발자나 관리자가 필요한 경우 세션을 직접 무효화할 수 있습니다. 이로 인해 세션은 즉시 종료되며, 클라이언트는 다시 세션을 생성해야 합니다.

예시코드

•

세션 사용 - js

const http = require('http');
const fs = require('fs').promises;
const path = require('path');

const parseCookies = (cookie = '') =>
  cookie
    .split(';')
    .map(v => v.split('='))
    .reduce((acc, [k, v]) => {
      acc[k.trim()] = decodeURIComponent(v);
      return acc;
    }, {});

const session = {};

http.createServer(async (req, res) => {
  const cookies = parseCookies(req.headers.cookie);
  if (req.url.startsWith('/login')) {
    const url = new URL(req.url, 'http://localhost:8080');
    const name = url.searchParams.get('name');
    const expires = new Date();
    expires.setMinutes(expires.getMinutes() + 5);
    const uniqueInt = Date.now();
    session[uniqueInt] = {
      name,
      expires,
    };
    res.writeHead(302, {
      Location: '/',
      'Set-Cookie': `session=${uniqueInt}; Expires=${expires.toGMTString()}; HttpOnly; Path=/`,
    });
    res.end();
  // 세션쿠키가 존재하고, 만료 기간이 지나지 않았다면
  } else if (cookies.session && session[cookies.session].expires > new Date()) {
    res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end(`${session[cookies.session].name}님 안녕하세요`);
  } else {
    try {
      const data = await fs.readFile(path.join(__dirname, 'cookie2.html'));
      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
      res.end(data);
    } catch (err) {
      res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
      res.end(err.message);
    }
  }
})
  .listen(8080, () => {
    console.log('8080번 포트에서 서버 대기 중입니다!');
  });
JavaScript
복사

•

세션 사용 - html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>쿠키&세션 이해하기</title>
</head>
<body>
<form action="/login">
    <input id="name" name="name" placeholder="이름을 입력하세요" />
    <button id="login">로그인</button>
</form>
</body>
</html>
JavaScript
복사

HTTP(HTTP/1.1)

웹에서 데이터를 요청하고 응답하기 위한 약속

•

HTTP는 "Hypertext Transfer Protocol"의 약자로, 웹에서 데이터를 주고받기 위한 프로토콜입니다.

•

클라이언트와 서버 간의 요청(Request)과 응답(Response)을 규정하고 있습니다.

•

기본적으로 텍스트 기반의 프로토콜이며, TCP를 사용하여 데이터를 전송합니다.

•

각 요청마다 새로운 TCP 연결을 생성하여 통신합니다.

예시 코드

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello, World!\n');
});

const PORT = 3000;
server.listen(PORT, () => {
  console.log(`Server is listening on port ${PORT}`);
});
JavaScript
복사

HTTP/2

웹 성능을 향상시키기 위한 다중화, 헤더 압축, 서버 푸시 등의 기능을 갖춘 HTTP의 최신 버전

•

HTTP/2는 HTTP/1.1의 후속 버전으로, 성능을 향상시키기 위해 설계되었습니다.

•

다중화(Multiplexing): 하나의 TCP 연결을 통해 여러 요청과 응답을 동시에 처리할 수 있어 더 효율적인 통신이 가능합니다.

•

헤더 압축(Header Compression): 헤더 정보의 압축을 통해 대역폭을 절약합니다.

•

서버 푸시(Server Push): 클라이언트의 요청 없이 서버가 필요한 리소스를 미리 보내줄 수 있습니다.

HTTP/2를 사용하기 위해서는 HTTPS를 사용해야 하므로, 키(server-key.pem)와 인증서(server-cert.pem) 파일이 필요합니다.

예시코드

const http2 = require('http2');
const fs = require('fs');

const server = http2.createSecureServer({
  key: fs.readFileSync('server-key.pem'),
  cert: fs.readFileSync('server-cert.pem')
}, (req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello, HTTP/2!\n');
});

const PORT = 3000;
server.listen(PORT, () => {
  console.log(`Server is listening on port ${PORT}`);
});
JavaScript
복사

키와 인증서 파일 만드는 방법

•

키(server-key.pem)

•

인증서(server-cert.pem)

OpenSSL 설치

키 및 인증서 생성

키와 인증서 확인

OpenSSL 설치

•

Windows

Win32/Win64 OpenSSL Installer for Windows - Shining Light Productions

Businesses Secure Cloud Load Balancing

https://slproweb.com/products/Win32OpenSSL.html

환경변수 설정

C:\Program Files\OpenSSL-Win64\bin
JSON
복사

•

Linux, Ubuntu

sudo apt-get update
sudo apt-get install openssl
JavaScript
복사

•

CentOS

sudo yum install openssl
JavaScript
복사

•

macOS (homebrew)

brew install openssl
JavaScript
복사

키 및 인증서 생성

openssl req -x509 -newkey rsa:2048 -nodes -keyout server-key.pem -out server-cert.pem -days 365
JavaScript
복사

키 및 인증서 생성 입력

•

KR

•

Seoul

•

Gangnam-gu

•

aloha

•

test

•

127.0.0.1

•

wwwaloha@kakao.com

Country Name (2 letter code) [AU]:KR
State or Province Name (full name) [Some-State]:Seoul
Locality Name (eg, city) []:Gangnam-gu
Organization Name (eg, company) [Internet Widgits Pty Ltd]:aloha
Organizational Unit Name (eg, section) []:test
Common Name (e.g. server FQDN or YOUR name) []:127.0.0.1
Email Address []:wwwaloha@kakao.com
JSON
복사

상위 인증서 생성

사용자 지정 루트 CA를 사용하여 자체 서명된 인증서 생성 - Azure Application Gateway

사용자 지정 루트 CA를 사용하여 Azure 애플리케이션 게이트웨이 자체 서명 인증서를 생성하는 방법을 알아봅니다.

https://learn.microsoft.com/ko-kr/azure/application-gateway/self-signed-certificates

루트 인증서 생성

contoso.crt

루트 키 만들기

루트 인증서 만들기 및 자체 서명

인증서를 생성

루트 키 만들기

openssl ecparam -out contoso.key -name prime256v1 -genkey
Shell
복사

루트 인증서 만들기 및 자체 서명

openssl req -new -sha256 -key contoso.key -out contoso.csr
Shell
복사

인증서를 생성

openssl x509 -req -sha256 -days 365 -in contoso.csr -signkey contoso.key -out contoso.crt
Shell
복사

서버 인증서 샌성

fabrikam.crt

인증서의 키 만들기

CSR 만들기(인증서 서명 요청)

인증서 생성

인증서의 키 만들기

openssl req -new -sha256 -key fabrikam.key -out fabrikam.csr
Shell
복사

CSR 만들기(인증서 서명 요청)

openssl x509 -req -in fabrikam.csr -CA  contoso.crt -CAkey contoso.key -CAcreateserial -out fabrikam.crt -days 365 -sha256
Shell
복사

인증서 생성

openssl x509 -in fabrikam.crt -text -noout
Shell
복사

예시코드

const http2 = require('http2');
const fs = require('fs');

http2.createSecureServer({
  cert: fs.readFileSync('server-cert.pem'),   // 인증 파일
  key: fs.readFileSync('server-key.pem'),     // 키 파일
  ca: [
    fs.readFileSync('contoso.crt'),           // 루트 인증서
    fs.readFileSync('fabrikam.crt'),          // 서버 인증서
  ],
}, (req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.write('<h1>Hello Node!</h1>');
  res.end('<p>Hello Server!</p>');
})

.listen(443, () => {
  console.log('443번 포트에서 서버 대기 중입니다!');
});
JavaScript
복사

클러스터 (Cluster)

싱글 프로세스로 동작하는 노드를 여러 CPU 코어를 사용할 수 있게 해주는 모듈

Node.js의 cluster 모듈은 멀티 프로세싱을 지원하여, 다중 CPU 코어를 활용하여 높은 성능의 서버를 만들 수 있도록 도와주는 모듈입니다. 이 모듈은 단일 스레드에서 동작하는 Node.js 애플리케이션을 여러 프로세스로 나누고, 각 프로세스가 다른 CPU 코어에서 병렬로 실행되도록 합니다.

주요 속성

속성	설명
cluster.isMaster	현재 프로세스가 마스터 프로세스인지 여부를 나타내는 부울 값입니다.
cluster.isWorker	현재 프로세스가 워커 프로세스인지 여부를 나타내는 부울 값입니다.
cluster.settings	클러스터 설정을 포함하는 객체입니다.

주요 메소드

메소드	설명
cluster.fork([env])	새로운 워커 프로세스를 생성합니다.
cluster.setupMaster([settings])	마스터 프로세스의 설정을 변경합니다.
cluster.on('fork', (worker) => { })	새로운 워커 프로세스가 생성될 때 발생하는 이벤트 핸들러입니다.
cluster.on('online', (worker) => { })	워커 프로세스가 온라인 상태로 전환될 때 발생하는 이벤트 핸들러입니다.
cluster.on('exit', (worker, code, signal) => { })	워커 프로세스가 종료될 때 발생하는 이벤트 핸들러입니다.

예시 코드

// Node.js 모듈을 가져옵니다.
const cluster = require('cluster');
const http = require('http');
const numCPUs = require('os').cpus().length;

// 현재 프로세스가 마스터 프로세스인지 확인합니다.
if (cluster.isMaster) {
  // 마스터 프로세스의 PID를 출력합니다.
  console.log(`Master ${process.pid} is running`);

  // CPU 코어 수만큼 워커 프로세스를 생성합니다.
  for (let i = 0; i < numCPUs; i++) {
    cluster.fork();
  }

  // 워커 프로세스가 종료될 때의 이벤트 핸들러를 등록합니다.
  cluster.on('exit', (worker, code, signal) => {
    console.log(`Worker ${worker.process.pid} died`);
  });
} else {
  // 각 워커 프로세스는 TCP 연결을 공유할 수 있습니다.
  // 이 예제에서는 HTTP 서버로 사용됩니다.
  http.createServer((req, res) => {
    // HTTP 응답 헤더를 설정합니다.
    res.writeHead(200);

    // 클라이언트에게 'Hello World'를 응답으로 전송합니다.
    res.end('Hello World\n');
  }).listen(8000); // 8000번 포트에서 서버를 시작합니다.

  // 현재 워커 프로세스의 PID를 출력합니다.
  console.log(`Worker ${process.pid} started`);
}
JavaScript
복사