Express.js를 사용한 API 구축을 위한 초보자 가이드

API(애플리케이션 프로그래밍 인터페이스)는 현대 웹 애플리케이션의 백본으로, 프런트엔드와 백엔드 간의 통신을 가능하게 합니다. JavaScript로 API를 구축하는 데 가장 널리 사용되는 도구 중 하나는 미니멀하고 유연한 Node.js 프레임워크인 Express.js입니다. 이 가이드는 Express.js를 사용하여 API를 구축하는 기본 사항을 안내합니다.

Express.js란 무엇인가요?
Express.js는 Node.js로 서버 측 애플리케이션을 구축하기 위한 경량 프레임워크입니다. HTTP 요청 처리, 라우팅, 미들웨어 통합과 같은 작업을 단순화하므로 API 생성에 탁월한 선택입니다.

Express.js를 사용하는 이유

• 사용 편의성: 간단한 구문과 빠른 설정.
• 유연성: 미들웨어로 사용자 정의하여 인증, 로깅, 오류 처리 등의 기능을 추가할 수 있습니다.
• 확장성: 소규모 및 대규모 애플리케이션 모두에 적합합니다.

Express.js 환경 설정

1단계: Node.js 설치
Node.js가 설치되어 있는지 확인하세요. 필요한 경우 nodejs.org에서 다운로드하세요.

2단계: 프로젝트 초기화
새 프로젝트 디렉토리를 생성하고 초기화합니다.

mkdir express-api  
cd express-api  
npm init -y 

이것은 종속성을 관리하기 위한 package.json 파일을 생성합니다.

3단계: Express.js 설치
npm을 사용하여 Express.js를 설치하세요.

npm install express  

첫 번째 API 구축

1단계: 기본 서버 생성
먼저 server.js 파일을 만들고 다음 코드를 추가하세요.

const express = require('express');  
const app = express();  
const PORT = 3000;  

app.listen(PORT, () => {  
  console.log(`Server is running on http://localhost:${PORT}`);  
});  

다음을 사용하여 서버를 실행하세요.

node server.js 

http://localhost:3000을 방문하면 서버가 실행 중인 것을 볼 수 있습니다(아직 아무것도 반환하지 않지만).

2단계: 첫 번째 경로 정의
경로는 API가 클라이언트 요청에 응답하는 방식을 정의합니다. 환영 메시지를 반환하는 간단한 경로를 추가하세요:

app.get('/', (req, res) => {  
  res.send('Welcome to your first Express API!');  
});  

서버를 다시 시작하고 http://localhost:3000을 방문하면 이제 메시지가 표시됩니다.

3단계: API 엔드포인트 생성
데이터를 처리할 엔드포인트를 추가해 보겠습니다. 예를 들어 사용자 목록을 반환하는 /users 경로는 다음과 같습니다.

const users = [  
  { id: 1, name: 'Alice' },  
  { id: 2, name: 'Bob' },  
  { id: 3, name: 'Charlie' }  
];  

app.get('/users', (req, res) => {  
  res.json(users);  
}); 

이제 http://localhost:3000/users를 방문하면 사용자 데이터가 JSON 형식으로 반환됩니다.

미들웨어 추가
Express.js의 미들웨어 기능은 요청과 응답을 처리합니다. 예를 들어 미들웨어를 사용하여 클라이언트가 보낸 JSON 데이터를 구문 분석할 수 있습니다.

1단계: 내장 미들웨어 사용
JSON 구문 분석을 활성화하려면 다음을 추가하세요.

app.use(express.json());  

2단계: POST 요청 처리
새 사용자를 생성하려면 경로를 추가하세요.

mkdir express-api  
cd express-api  
npm init -y 

이제 JSON 데이터가 포함된 POST 요청을 http://localhost:3000/users로 보내 새 사용자를 추가할 수 있습니다.

오류 처리
오류를 적절하게 처리하려면 미들웨어를 사용하세요. 예:

npm install express  

이렇게 하면 처리되지 않은 오류가 의미 있는 응답을 반환하도록 보장됩니다.

최종 코드
전체 예는 다음과 같습니다.

const express = require('express');  
const app = express();  
const PORT = 3000;  

app.listen(PORT, () => {  
  console.log(`Server is running on http://localhost:${PORT}`);  
});  

결론
Express.js는 API 구축을 간단하고 효율적으로 만들어 빠르게 시작하는 데 필요한 도구와 유연성을 제공합니다. 경로 설정, 데이터 처리, 미들웨어 사용의 기본 사항을 이해하면 웹 애플리케이션을 위한 강력한 API를 만들 수 있습니다.

인증, 데이터베이스 통합, 고급 오류 처리 등의 기능을 계속 탐색하여 API를 한 단계 더 발전시키세요!

위 내용은 Express.js를 사용한 API 구축을 위한 초보자 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!