** 📌 RESTful API 설계**

URL과 HTTP 메서드를 의미 있게 나누어

유지보수성과 확장성을 높이는 웹 서비스 설계 원칙

JSP + Servlet 환경에서의 RESTful API 실전 설계 예제 포함

---

🧩 목차

1. REST란?
2. RESTful이란?
3. RESTful URL 설계 원칙
4. HTTP 메서드와 CRUD 매핑
5. Servlet 기반 RESTful 설계 예제
6. 실무 적용 팁
7. 기술 면접 대비 핵심 요약
8. 마무리 요약 + Notion 작성 팁

---

✅ 1. REST란?

항목	설명
정의	REpresentational State Transfer – 자원을 명확히 표현하고 상태를 전송하는 설계 방식
특징	URL은 자원(Resource) 를 나타내고, 동사(행위) 는 HTTP 메서드로 표현
목적	웹 서비스의 구조를 단순하고 명확하게 만들어 유지보수성 ↑

---

✅ 2. RESTful이란?

구분	설명
RESTful	REST 원칙을 잘 지킨 API 설계 방식 (자원 중심, 메서드 명확, 상태 무관)
예	/posts/3 → 게시글 3번을 의미. GET/PUT/DELETE 등은 메서드로 구분
비RESTful	/getPost.do, /deletePost.jsp 처럼 URL에 동사가 포함되는 방식 ❌

---

✅ 3. RESTful URL 설계 원칙

항목	예시	의미
✅ 명사 사용	/users	사용자 목록
✅ 리소스 ID	/users/5	ID가 5인 사용자
✅ 하위 관계	/users/5/posts	사용자 5의 게시글 목록
❌ 동사 포함 금지	/getUser.do, /deleteUser.jsp	비권장 방식

---

✅ 4. HTTP 메서드와 CRUD 매핑

메서드	의미	사용 예
GET	조회 (Read)	/posts, /posts/1
POST	생성 (Create)	/posts
PUT	수정 (Update)	/posts/1
DELETE	삭제 (Delete)	/posts/1

💡 JSP/Servlet에서는 실제 메서드에 따라 doGet, doPost, doPut, doDelete 등 사용 가능 (단, JS에서 PUT/DELETE 요청 시 JS + 필터 필요)

---

✅ 5. Servlet 기반 RESTful 설계 예제 🎯

---

📄 URL 설계 예

기능	URL	메서드	설명
게시글 전체 조회	/posts	GET	게시글 목록 보기
게시글 상세 조회	/posts/5	GET	5번 글 보기
게시글 등록	/posts	POST	새 글 작성
게시글 수정	/posts/5	PUT	5번 글 수정
게시글 삭제	/posts/5	DELETE	5번 글 삭제

---

📄 PostsServlet.java (단일 서블릿 처리)

@WebServlet("/posts/*")
public class PostsServlet extends HttpServlet {
  protected void doGet(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    String pathInfo = req.getPathInfo(); // / or /5
    if (pathInfo == null || "/".equals(pathInfo)) {
      // 전체 목록 조회
    } else {
      // 특정 게시글 상세 조회
      int id = Integer.parseInt(pathInfo.substring(1));
    }
  }

  protected void doPost(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 새 게시글 등록 처리
  }

  protected void doPut(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 게시글 수정 처리
  }

  protected void doDelete(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 게시글 삭제 처리
  }
}

---

✅ PUT/DELETE 요청 보내기 (JS에서)

fetch("/posts/5", {
  method: "DELETE"
}).then(res => res.text()).then(msg => alert(msg));

💡 JSP/Servlet 환경에서는 PUT/DELETE 요청을 필터나 JS로 보내야 함

---

✅ 6. 실무 적용 팁

항목	팁
RESTful 구조 유지	URL은 항상 명사형, 메서드는 동작을 나눔
ID 파라미터는 path에 포함	/users/5, /posts/3
PUT/DELETE 사용 시	JS fetch로 메서드 지정 또는 hidden input 사용
컨트롤러 분리	/posts, /users 등 리소스 단위로 서블릿 분리 권장

---

✅ 7. 기술 면접 대비 핵심 요약 💬

질문	요점 정리
REST란?	자원을 명사로 표현하고, 상태는 HTTP 메서드로 구분하는 설계 원칙
RESTful URL 설계 원칙은?	URL은 명사로, 메서드에 따라 의미 구분 (GET/POST/PUT/DELETE)
Servlet에서 REST 방식 적용 예는?	@WebServlet("/posts/*") → pathInfo로 리소스 구분
PUT/DELETE는 어떻게 구현하나요?	JS fetch로 요청하거나 _method=PUT 방식으로 전환 처리

---

✅ 8. 마무리 요약 🧠

• 🌐 REST는 URL을 리소스(명사) 로 설계하고, 메서드로 행위 를 구분
• 📦 Servlet에서는 doGet, doPost, doPut, doDelete 활용 가능
• 🚫 .do, .jsp 등의 동사 기반 URL은 RESTful하지 않음
• ✅ 클린한 URL 구조와 명확한 역할 분리는 유지보수성을 높여줌