Node.js와 Express

mkdir my-express-ts-app
cd my-express-ts-app
npm init -y

npm install express
npm install --save-dev typescript @types/node @types/express ts-node nodemon

npx tsc --init

{
  "compilerOptions": {
    "target": "es2018",                        // Node.js 버전과 호환되는 ES 버전
    "module": "commonjs",                     // Node.js는 CommonJS 모듈 시스템 사용
    "lib": ["es2018"],                        // 사용 가능한 런타임 라이브러리
    "outDir": "./dist",                       // 컴파일된 JS 파일이 저장될 디렉토리
    "rootDir": "./src",                       // 소스 코드의 루트 디렉토리
    "strict": true,                           // 엄격한 타입 검사 활성화
    "esModuleInterop": true,                  // CommonJS/ES Modules 간의 상호 운용성 지원
    "skipLibCheck": true,                     // 선언 파일(*.d.ts)에 대한 타입 검사 건너뛰기
    "forceConsistentCasingInFileNames": true, // 파일 이름 대소문자 일관성 강제
    "noImplicitAny": true,                    // 'any' 타입으로 추론되는 경우 오류 발생
    "resolveJsonModule": true                 // JSON 파일을 모듈로 가져올 수 있게 허용
  },
  "include": ["src/**/*.ts"],                 // 컴파일할 파일 지정
  "exclude": ["node_modules"]                 // 컴파일에서 제외할 파일 지정
}

{
  "name": "my-express-ts-app",
  "version": "1.0.0",
  "description": "",
  "main": "dist/index.js", // 컴파일 후 메인 파일
  "scripts": {
    "build": "tsc", // TypeScript 컴파일
    "start": "node dist/index.js", // 컴파일된 JS 실행
    "dev": "nodemon --exec ts-node src/index.ts" // 개발 모드 (TS 파일 직접 실행)
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.19.2"
  },
  "devDependencies": {
    "@types/express": "^4.17.21",
    "@types/node": "^20.14.9",
    "nodemon": "^3.1.4",
    "ts-node": "^10.9.2",
    "typescript": "^5.5.3"
  }
}

import express, { Request, Response, NextFunction } from 'express';

const app = express();
const port = 3000;

// JSON 요청 본문을 파싱하기 위한 미들웨어
app.use(express.json());

// 루트 경로 핸들러
app.get('/', (req: Request, res: Response) => {
  res.send('Hello from Express with TypeScript!');
});

// GET 요청 예시
app.get('/api/users', (req: Request, res: Response) => {
  const users = [
    { id: 1, name: 'Alice', email: 'alice@example.com' },
    { id: 2, name: 'Bob', email: 'bob@example.com' },
  ];
  res.json(users);
});

// POST 요청 예시: 새로운 사용자 추가
interface NewUserRequest extends Request {
  body: { name: string; email: string };
}

app.post('/api/users', (req: NewUserRequest, res: Response) => {
  const newUser = req.body; // req.body는 타입스크립트에서 기본적으로 any로 추론됩니다.
                           // 인터페이스로 명시하여 타입 안정성을 확보할 수 있습니다.
  console.log('Received new user:', newUser);
  // 실제 애플리케이션에서는 데이터베이스에 저장하는 로직이 들어갑니다.
  res.status(201).json({ message: 'User created successfully', user: newUser });
});

// 에러 핸들링 미들웨어 (가장 마지막에 위치)
app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
  console.error(err.stack);
  res.status(500).send('Something broke!');
});

// 서버 시작
app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
  console.log('Press Ctrl+C to stop the server.');
});

npm run dev

npm run build
npm run start