API 란
API는 Application Programming Interface의 약어로, 소프트웨어 애플리케이션 간에 데이터를 주고받기 위한 규칙과 메커니즘을 제공하는 인터페이스입니다. API는 다른 애플리케이션 또는 서비스와 상호작용하고 데이터를 요청하거나 전송하며, 필요한 기능을 제공하도록 설계됩니다.
http
Node.js를 사용하여 간단한 HTTP 서버를 만들 수 있습니다. HTTP 모듈을 사용하여 서버를 생성하고 요청 및 응답을 처리할 수 있습니다.
const http = require('http');
const server = http.createServer((req, res) => {
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
res.end('Hello, World!');
});
server.listen(3000, 'localhost', () => {
console.log('Server is running on port 3000');
});
-
위의 코드는 http 모듈을 사용하여 HTTP 서버를 생성합니다. createServer() 메서드는 요청(req)과 응답(res)을 처리하는 콜백 함수를 전달받습니다. 콜백 함수는 클라이언트로부터 요청이 들어올 때마다 실행됩니다.
-
콜백 함수에서는 res 객체를 사용하여 응답을 설정하고, res.end() 메서드를 호출하여 응답을 보냅니다. 위의 예시에서는 응답 코드를 200으로 설정하고, Content-Type 헤더를 text/plain으로 설정하며, 응답 본문에는 "Hello, World!"를 전송합니다.
-
server.listen() 메서드를 사용하여 서버를 지정된 포트(예: 3000)와 호스트(예: 'localhost')에서 실행합니다. 서버가 시작되면 콘솔에 "Server is running on port 3000"이라는 메시지가 출력됩니다.
-
이제 브라우저에서 http://localhost:3000을 열면 "Hello, World!"라는 메시지가 표시됩니다. 이 코드를 수정하여 다양한 요청을 처리하고 원하는 응답을 생성할 수 있습니다.
express
Express는 Node.js를 위한 웹 애플리케이션 프레임워크로, 간편한 API를 제공하여 웹 서버 및 라우팅을 쉽게 구축할 수 있도록 도와줍니다. Express는 미들웨어(Middleware) 기반으로 동작하며, HTTP 요청 및 응답의 처리를 단순화하고 유연성을 제공합니다.
const express = require('express');
const app = express();
// 미들웨어 설정
app.use(express.json()); // JSON 파싱을 위한 미들웨어
// 라우팅
app.get('/', (req, res) => {
res.send('Hello, World!');
});
// 서버 시작
app.listen(3000, () => {
console.log('Server is running on port 3000');
});
-
위의 코드에서 express 모듈을 가져오고, express() 함수를 호출하여 app 객체를 생성합니다. 이 app 객체는 Express 애플리케이션의 주요 구성 요소입니다.
-
app.use() 메서드를 사용하여 미들웨어를 설정합니다. 위의 예시에서는 express.json() 미들웨어를 사용하여 요청 본문의 JSON 데이터를 파싱합니다.
-
app.get() 메서드를 사용하여 GET 요청에 대한 라우팅을 정의합니다. 위의 예시에서는 루트 경로("/")에 대한 GET 요청에 대해 "Hello, World!"를 응답으로 보냅니다.
-
app.listen() 메서드를 사용하여 서버를 지정된 포트(예: 3000)에서 실행합니다. 서버가 시작되면 콘솔에 "Server is running on port 3000"이라는 메시지가 출력됩니다.
-
Express는 이 외에도 다양한 기능을 제공합니다. 예를 들어, app.post() 메서드를 사용하여 POST 요청을 처리하거나, 라우터를 사용하여 라우팅 로직을 모듈화할 수 있습니다. 또한, 미들웨어를 사용하여 로깅, 인증, 세션 관리 등 다양한 작업을 처리할 수 있습니다.
Express는 많은 개발자들에게 사랑받고 있는 인기 있는 웹 프레임워크이며, Node.js 기반의 웹 애플리케이션을 쉽게 구축하고 관리할 수 있도록 도와줍니다.
Node.js 초기 세팅
-
Node.js 설치: 먼저 Node.js를 설치해야 합니다. 공식 웹사이트(https://nodejs.org)에서 가장 최신의 안정화된 버전을 다운로드하면 됩니다. 설치가 완료되면, 터미널에서 node -v와 npm -v 명령어를 사용하여 Node.js와 npm(Node 패키지 매니저)의 버전을 확인할 수 있습니다.
-
프로젝트 디렉토리 생성 및 이동: mkdir project-name 명령어를 사용하여 프로젝트용 디렉토리를 만들고, cd project-name 명령어로 해당 디렉토리로 이동합니다.
-
npm 초기화: npm init 명령어를 실행하여 npm을 초기화합니다. 이는 package.json 파일을 생성하는 것으로, 이 파일은 프로젝트의 메타데이터와 사용하는 패키지들에 대한 정보를 담고 있습니다. npm init을 실행하면 프로젝트에 관한 몇 가지 질문을 받게 되며, 모든 것에 기본값으로 답하려면 npm init -y를 사용하면 됩니다.
-
Express.js 설치: Express는 Node.js를 위한 가장 인기 있는 웹 프레임워크 중 하나입니다. npm install express --save 명령어를 실행하여 설치합니다.
-
Hello World 서버 생성: 이제 간단한 Hello World 서버를 생성해볼 수 있습니다. 텍스트 에디터를 사용하여 프로젝트 디렉토리에 app.js 파일을 만듭니다. 그리고 다음 코드를 추가합니다:
const express = require('express');
const app = express();
const port = 3000;
app.get('/', (req, res) => {
res.send('Hello World!');
});
app.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});
- 서버 실행: 마지막으로, node app.js 명령어를 실행하여 서버를 시작합니다. 이제 브라우저를 열고 http://localhost:3000/로 이동하면, 'Hello World!' 메시지가 표시되는 것을 볼 수 있을 것입니다.
이 과정은 가장 기본적인 Node.js 서버 설정을 안내하는 것입니다. 실제 프로젝트에서는 데이터베이스 설정, 라우팅 설정, 미들웨어 설정 등 추가적인 설정이 필요하게 될 것입니다.
