[Spring/입문] Spring MVC부터 SQL/JDBC까지 정리

JM·5일 전
SpringTIL내일배움캠프사전캠프
post-thumbnail

Spring MVC부터 SQL/JDBC까지 정리

1. MVC 디자인 패턴

소프트웨어를 Model, View, Controller로 구분하여 각각의 역할을 분리하는 디자인 패턴이다.

  • Model: 데이터와 비즈니스 로직을 담당하며, 데이터베이스와 연동하여 데이터를 저장하고 조회한다.
  • View: 사용자 인터페이스를 담당하며, 사용자가 보는 화면과 버튼, 폼 등을 구현한다.
  • Controller: Model과 View 사이의 상호작용을 조정한다. 사용자의 입력을 받아 Model에 전달하고, Model의 결과를 바탕으로 View를 업데이트한다.

MVC의 장점

  • 코드 재사용성
  • 유지보수성
  • 개발자 간 협업 용이

2. Spring MVC

Spring MVC는 Servlet을 기반으로 HTTP 요청을 처리하고, MVC 디자인 패턴을 적용해 요청과 응답을 효율적으로 관리한다.

Servlet

Java를 사용하여 웹 페이지를 동적으로 생성하는 서버 측 프로그램 또는 사양이다.

Servlet 동작 과정

  1. Client(브라우저)에서 HTTP Request 발생
  2. HttpServletRequest, HttpServletResponse 객체 생성
  3. 요청에 해당하는 Servlet 탐색
  4. service() 호출 → HTTP Method에 따라 doGet(), doPost() 등 호출
  5. 처리 결과를 HttpServletResponse에 담아 Client에 반환
  6. 응답 완료 후 Request / Response 객체 소멸

DispatcherServlet

DispatcherServlet은 요청을 분석하고 적절한 Controller로 요청을 전달한다.

예를 들어 @GetMapping("/api/hello") 요청이 들어오면 해당 요청을 처리할 Controller의 메서드를 찾아 실행한다.

동작 과정

  1. HTTP 요청 분석
  2. Handler Mapping을 통해 Controller에 요청 전달
  3. Controller에서 처리 후 결과(Model, View) 전달
  4. DispatcherServlet이 View에 Model을 적용하여 Client에 전달

3. @Controller

@Controller는 관련된 요청을 하나의 Controller에서 관리할 수 있도록 한다.

예를 들어 회원 관리 기능의 로그인, 회원가입, 로그아웃 등을 하나의 Controller에서 관리할 수 있다.

@Controller
@RequestMapping("/user")
public class UserController {

    @GetMapping("/login")
    public String login() {
        // ...
    }

    @GetMapping("/logout")
    public String logout() {
        // ...
    }

    @GetMapping("/signup")
    public String signup() {
        // ...
    }

    @PostMapping("/signup")
    public String registerUser(SignupRequestDto requestDto) {
        // ...
    }
}

URL 경로 중복

HTTP Method가 다르면 같은 URL 경로를 사용할 수 있다.

@GetMapping("/api/hello")
@ResponseBody
public String hello() {
    return "Hello World";
}

@PostMapping("/api/hello")
@ResponseBody
public String post() {
    return "Hello World2";
}

4. @RequestMapping

공통되는 API 경로를 묶어서 관리할 수 있다.

@Controller
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    @ResponseBody
    public String hello() {
        return "Hello World";
    }
}

위와 같이 설정하면 실제 요청 경로는 /api/hello가 된다.

5. 정적 페이지와 동적 페이지

정적(Static) 페이지

이미 완성된 HTML 파일을 그대로 반환하는 페이지다.

예를 들어 http://localhost:8080/hello.html을 요청하면 Controller를 거치지 않고 정적 리소스를 반환할 수 있다.

Redirect

@GetMapping("/html/redirect")
public String htmlStatic() {
    return "redirect:/hello.html";
}

redirect:를 사용하면 해당 URL로 다시 요청을 보낸다.

동적 페이지

Controller에서 Model에 데이터를 담고, Template Engine이 HTML에 데이터를 적용하여 동적인 페이지를 생성한다.

@GetMapping("/html/dynamic")
public String htmlDynamic(Model model) {
    visitCount++;
    model.addAttribute("visits", visitCount);
    return "hello-visit";
}

model.addAttribute()로 전달한 값은 HTML의 ${visits}와 같은 표현식에 적용된다.

동적 페이지 처리 과정

  1. Controller에서 요청 처리 및 필요한 데이터를 Model에 저장
  2. Template Engine(Thymeleaf)에 View와 Model 전달
  3. Template Engine이 View에 Model을 적용
  4. 생성된 HTML을 Client에 전달

대표적인 Template Engine으로 Thymeleaf, Groovy, FreeMarker, JSP 등이 있다.

6. JSON 데이터 반환

서버에서 HTML 전체를 반환하는 대신 필요한 데이터를 JSON 형식으로 반환할 수 있다.

String 반환

@GetMapping("/response/json/string")
@ResponseBody
public String helloStringJson() {
    return "{\"name\":\"Robbie\",\"age\":95}";
}

Java 객체 반환

@GetMapping("/response/json/class")
@ResponseBody
public Star helloClassJson() {
    return new Star("Robbie", 95);
}

Spring은 Java 객체를 JSON으로 변환하여 반환할 수 있다.

7. @RestController

@RestController는 @Controller와 @ResponseBody를 함께 사용하는 것과 같다.

@RestController
public class HelloController {
    // ...
}

@ResponseBody를 사용하면 HTML View가 아닌 데이터를 응답으로 반환한다.

8. Jackson

Jackson은 JSON 데이터를 처리하는 라이브러리다.

  • Java Object → JSON
  • JSON → Java Object

Spring은 Jackson과 관련된 기능을 제공하여 Java 객체를 JSON으로 변환할 수 있다.

@Test
@DisplayName("Object To JSON")
void test1() throws JsonProcessingException {
    Star star = new Star("Robbie", 95);

    ObjectMapper objectMapper = new ObjectMapper();
    String json = objectMapper.writeValueAsString(star);

    System.out.println("json = " + json);
}

9. Path Variable과 Request Param

둘 다 HTTP 요청으로 데이터를 전달받는 방법이지만, 데이터가 URL에 표현되는 방식이 다르다.

Path Variable

URL 경로에 값을 포함하여 전달하는 방식이다.

// GET http://localhost:8080/hello/request/star/Robbie/age/95
@GetMapping("/star/{name}/age/{age}")
@ResponseBody
public String helloRequestPath(
        @PathVariable String name,
        @PathVariable int age
) {
    return String.format(
        "Hello, @PathVariable.<br> name = %s, age = %d",
        name, age
    );
}
  • {name}, {age} 형태로 URL 경로에 변수 지정
  • @PathVariable로 해당 값 전달받음

Request Param

Query String을 통해 데이터를 전달하는 방식이다.

// GET http://localhost:8080/hello/request/form/param?name=Robbie&age=95
@GetMapping("/form/param")
@ResponseBody
public String helloGetRequestParam(
        @RequestParam(required = false) String name,
        int age
) {
    return String.format(
        "Hello, @RequestParam.<br> name = %s, age = %d",
        name, age
    );
}
  • @RequestParam 생략 가능
  • required = false 설정 시 해당 값이 없어도 됨

10. HTTP 데이터를 객체로 처리

@ModelAttribute

여러 데이터를 하나씩 @RequestParam으로 받는 대신 Java 객체로 한 번에 받을 수 있다.

// POST http://localhost:8080/hello/request/form/model
// Content-Type: application/x-www-form-urlencoded
// Body: name=Robbie&age=95

@PostMapping("/form/model")
@ResponseBody
public String helloRequestBodyForm(@ModelAttribute Star star) {
    return String.format(
        "Hello, @ModelAttribute.<br> (name = %s, age = %d)",
        star.name, star.age
    );
}

Query String에서도 사용할 수 있다.

// GET http://localhost:8080/hello/request/form/param/model?name=Robbie&age=95
@GetMapping("/form/param/model")
@ResponseBody
public String helloRequestParam(@ModelAttribute Star star) {
    return String.format(
        "Hello, @ModelAttribute.<br> (name = %s, age = %d)",
        star.name, star.age
    );
}

@ModelAttribute는 생략할 수 있다.

@RequestBody

JSON 형식으로 전달된 HTTP Body를 Java 객체로 받을 때 사용한다.

// POST http://localhost:8080/hello/request/form/json
// Content-Type: application/json
// Body: {"name":"Robbie","age":"95"}

@PostMapping("/form/json")
@ResponseBody
public String helloPostRequestJson(@RequestBody Star star) {
    return String.format(
        "Hello, @RequestBody.<br> (name = %s, age = %d)",
        star.name, star.age
    );
}

11. CRUD 구현

CRUD는 데이터를 생성(Create), 조회(Read), 수정(Update), 삭제(Delete)하는 기본적인 데이터 처리 방식이다.

DTO란?

DTO(Data Transfer Object)는 데이터 전송 및 이동을 위해 사용하는 객체다.

  • Client에서 전달받은 데이터를 객체로 처리
  • 서버 계층 간 데이터 이동

Create

@PostMapping("/memos")
public MemoResponseDto createMemo(@RequestBody MemoRequestDto requestDto) {
    // RequestDto -> Entity
    Memo memo = new Memo(requestDto);

    // Memo Max ID Check
    Long maxId = memoList.size() > 0
            ? Collections.max(memoList.keySet()) + 1
            : 1;
    memo.setId(maxId);

    // DB 저장
    memoList.put(memo.getId(), memo);

    // Entity -> ResponseDto
    MemoResponseDto memoResponseDto = new MemoResponseDto(memo);

    return memoResponseDto;
}

Read

@GetMapping("/memos")
public List<MemoResponseDto> getMemos() {
    List<MemoResponseDto> responseList = memoList.values().stream()
            .map(MemoResponseDto::new)
            .toList();

    return responseList;
}

Update

@PutMapping("/memos/{id}")
public Long updateMemo(
        @PathVariable Long id,
        @RequestBody MemoRequestDto requestDto
) {
    if (memoList.containsKey(id)) {
        Memo memo = memoList.get(id);
        memo.update(requestDto);
        return memo.getId();
    } else {
        throw new IllegalArgumentException("선택한 메모는 존재하지 않습니다.");
    }
}

Delete

@DeleteMapping("/memos/{id}")
public Long deleteMemo(@PathVariable Long id) {
    if (memoList.containsKey(id)) {
        memoList.remove(id);
        return id;
    } else {
        throw new IllegalArgumentException("선택한 메모는 존재하지 않습니다.");
    }
}

12. Database

Spring에서 데이터를 다루기 위해서는 애플리케이션뿐 아니라 데이터베이스의 기본 구조도 이해해야 한다.

  • DB(Database): 데이터의 집합
  • DBMS(Database Management System): 데이터베이스를 관리하고 운영하는 소프트웨어
  • RDBMS(Relational DBMS): 관계형 데이터베이스 관리 시스템

RDBMS는 테이블을 기본 단위로 데이터를 관리한다.

  • 테이블은 행(row)과 열(column)으로 구성된다.
  • 테이블 간에는 외래키를 통해 관계를 구성할 수 있다.
아이디이름전화번호
1홍길동010-7777-7777
2김철수010-6666-6666
3이가영010-8888-8888

13. SQL

SQL(Structured Query Language)은 RDBMS에서 데이터를 조작하고 관리하기 위해 사용하는 언어다.

DDL

DDL(Data Definition Language)은 데이터베이스와 테이블의 구조를 정의하는 언어

CREATE

CREATE DATABASE 데이터베이스이름;

CREATE TABLE 테이블이름 (
    필드이름1 필드타입1,
    필드이름2 필드타입2
);

ALTER

ALTER TABLE 테이블이름 ADD 필드이름 필드타입;
ALTER TABLE 테이블이름 DROP 필드이름;
ALTER TABLE 테이블이름 MODIFY COLUMN 필드이름 필드타입;

DROP

데이터베이스 또는 테이블을 삭제한다.

DROP DATABASE 데이터베이스이름;
DROP TABLE 테이블이름;

TRUNCATE

테이블의 데이터를 삭제하고 테이블 구조는 유지한다.

TRUNCATE TABLE 테이블이름;

DML

DML(Data Manipulation Language)은 데이터를 조작하는 언어

INSERT

INSERT INTO 테이블이름(필드이름1, 필드이름2, 필드이름3)
VALUES(데이터값1, 데이터값2, 데이터값3);

SELECT

SELECT 필드이름
FROM 테이블이름
WHERE 조건;

UPDATE

UPDATE 테이블이름
SET 필드이름1 = 데이터값1,
    필드이름2 = 데이터값2
WHERE 필드이름 = 데이터값;

DELETE

DELETE FROM 테이블이름
WHERE 필드이름 = 데이터값;

DCL

DCL(Data Control Language)은 데이터베이스의 권한을 제어하는 언어

GRANT

사용자 또는 ROLE에 권한을 부여한다.

GRANT [객체권한명] (컬럼)
ON [객체명]
TO { 유저명 | 롤명 | PUBLIC } [WITH GRANT OPTION];

REVOKE

사용자 또는 ROLE에 부여한 권한을 회수한다.

REVOKE { 권한명 [, 권한명...] | ALL }
ON 객체명
FROM { 유저명 [, 유저명...] | 롤명 | PUBLIC };

14. JDBC

JDBC(Java Database Connectivity)는 Java에서 데이터베이스에 접근할 수 있도록 제공하는 API다.

JDBC를 사용하면 애플리케이션의 DB 접근 로직을 특정 DB에 직접 종속시키는 것을 줄일 수 있다.

애플리케이션의 DB 접근 과정

  1. DB 연결(Connection)
  2. SQL 요청
  3. 결과 응답

예를 들어 MySQL에서 PostgreSQL로 DB를 변경할 경우 DB 연결 및 요청 방식이 달라질 수 있다. JDBC는 이러한 DB 접근을 위한 표준화된 인터페이스를 제공한다.

JDBC Template

JDBC를 사용할 때 반복되는 작업을 줄이기 위해 Spring에서는 JdbcTemplate을 제공한다.

  • 커넥션 연결
  • Statement 준비 및 실행
  • 커넥션 종료
  • 반복 작업을 줄여줌

등의 반복적인 작업을 대신 처리할 수 있다.

마무리

  • DispatcherServlet을 중심으로 HTTP 요청이 Controller까지 전달되는 흐름
  • @RestController, @ResponseBody를 이용한 JSON 응답
  • @PathVariable, @RequestParam, @ModelAttribute, @RequestBody의 차이
  • CRUD의 기본적인 데이터 처리 방식
  • DDL / DML / DCL의 역할
  • JDBC와 JdbcTemplate의 역할
profile
JM
이전 포스트

[Spring/입문] 네트워크부터 Spring Boot 설정까지

다음 포스트

[Spring/입문] 3 Layer Architecture, IoC/DI, Spring IoC Container, JPA

0개의 댓글