starting point

인프런/실전! 스프링부트와 JPA활용1

끝) 웹 어플리케이션 개발 [ 웹 계층 ]

backend dev 2024. 6. 7.

홈 화면과 레이아웃

홈 컨트롤러 등록

 

@Controller
@Slf4j
public class HomeController {
    @RequestMapping("/")
    public String home() {
        log.info("home controller");
        return "home";
    }
}

 

[타임리프 사용]

Home.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header">
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader" />
    <div class="jumbotron">
        <h1>HELLO SHOP</h1>
        <p class="lead">회원 기능</p>
        <p>
            <a class="btn btn-lg btn-secondary" href="/members/new">회원 가입</a>
            <a class="btn btn-lg btn-secondary" href="/members">회원 목록</a>
        </p>
        <p class="lead">상품 기능</p>
        <p>
            <a class="btn btn-lg btn-dark" href="/items/new">상품 등록</a>
            <a class="btn btn-lg btn-dark" href="/items">상품 목록</a>
        </p>
        <p class="lead">주문 기능</p>
        <p>
            <a class="btn btn-lg btn-info" href="/order">상품 주문</a>
            <a class="btn btn-lg btn-info" href="/orders">주문 내역</a>
        </p>
    </div>
    <div th:replace="fragments/footer :: footer" />
</div> <!-- /container -->
</body>
</html>

 

header.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head th:fragment="header">
    <!-- Required meta tags -->
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrinkto-fit=no">
    <!-- Bootstrap CSS -->
    <link rel="stylesheet" href="/css/bootstrap.min.css" integrity="sha384-
ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
          crossorigin="anonymous">
    <!-- Custom styles for this template -->
    <link href="/css/jumbotron-narrow.css" rel="stylesheet">
    <title>Hello, world!</title>
</head>

 

bodyHeader.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<div class="header" th:fragment="bodyHeader">
    <ul class="nav nav-pills pull-right">
        <li><a href="/">Home</a></li>
    </ul>
    <a href="/"><h3 class="text-muted">HELLO SHOP</h3></a>
</div>

 

footer.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<div class="footer" th:fragment="footer">
    <p>&copy; Hello Shop V2</p>
</div>

 

참고 Hierarchical-style layouts

예제에서는 뷰 템플릿을 최대한 간단하게 설명하려고, header , footer 같은 템플릿 파일을 반복해서 포함한다.

다음 링크의 Hierarchical-style layouts을 참고하면 이런 부분도 중복을 제거할 수 있다.

 

Thymeleaf Page Layouts - Thymeleaf

Summary In this article, we described many ways of achieving the same: layouts. You can build layouts using Thymeleaf Standard Layout System that is based on include-style approach. You also have powerful Layout Dialect, that uses decorator pattern for wor

www.thymeleaf.org

 

참고 뷰 템플릿 변경사항을 서버 재시작 없이 즉시 반영하기

1. spring-boot-devtools 추가

developmentOnly 'org.springframework.boot:spring-boot-devtools'

restartedMain으로 변경된다.

2. html 파일 build-> Recompile [ 컨트롤 + 쉬프트 + F9 ]

변경사항 바로 확인가능

 

 

 

 

회원 등록

폼 객체를 사용해서 화면 계층과 서비스 계층을 명확하게 분리한다.

 

회원등록DTO [ 폼 객체 ]

@Getter @Setter
public class MemberForm {

    @NotEmpty(message = "회원 이름은 필수입니다.")
    private String name;
    private String city;
    private String street;
    private String zipcode;

}

 

 

회원컨트롤러

@Controller
@RequiredArgsConstructor
public class MemberController {

    private final MemberService memberService;

    @GetMapping("/members/new")
    public String createForm(Model model) {
        model.addAttribute("memberForm", new MemberForm());
        return "members/createMemberForm";
    }


    @PostMapping("/members/new")
    public String create(@Valid MemberForm form, BindingResult bindingResult) {
        // form은 바디에 쓰이긴하지만 쿼리스트링형식이라 @ModelAttribute로 받을수있고 해당 어노테이션은 생략가능
        // ModelAttribute는 해당 객체를 모델에 자동으로 담는다. 그래서 바인딩실패로 해당 페이지 돌아가도 틀린 입력값을 가지고있을수있는것이다.

        if(bindingResult.hasErrors()) {
            return "members/createMemberForm";
        }
        Address address = new Address(form.getCity(), form.getStreet(), form.getZipcode());


        Member member = new Member();
        member.setName(form.getName());
        member.setAddress(address);

        memberService.join(member);
        return "redirect:/"; // post 이후에는 리다이렉트해줘야한다.  prg 패턴

    }
}

 

회원등록폼.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header"/>
<style>
    .fieldError {
        border-color: #bd2130;
    }
</style>
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader"/>
    <form role="form" action="/members/new" th:object="${memberForm}"
          method="post">
        <div class="form-group">
            <label th:for="name">이름</label>
            <input type="text" th:field="*{name}" class="form-control"
                   placeholder="이름을 입력하세요"
                   th:class="${#fields.hasErrors('name')}? 'form-control fieldError' : 'form-control'">
            <p th:if="${#fields.hasErrors('name')}"
               th:errors="*{name}">Incorrect date</p>
        </div>
        <div class="form-group">
            <label th:for="city">도시</label>
            <input type="text" th:field="*{city}" class="form-control"
                   placeholder="도시를 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="street">거리</label>
            <input type="text" th:field="*{street}" class="form-control"
                   placeholder="거리를 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="zipcode">우편번호</label>
            <input type="text" th:field="*{zipcode}" class="form-control"
                   placeholder="우편번호를 입력하세요">
        </div>
        <button type="submit" class="btn btn-primary">Submit</button>
    </form>
    <br/>
    <div th:replace="fragments/footer :: footer"/>
</div> <!-- /container -->
</body>
</html>

 

 

회원 목록 조회

회원 목록 컨트롤러[핸들러 메서드] 추가

@GetMapping("/members")
public String list(Model model) {
    List<Member> members = memberService.findMembers();
    model.addAttribute("members", members);
    return "members/memberList";
}

 

회원목록.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header" />
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader" />
    <div>
        <table class="table table-striped">
            <thead>
            <tr>
                <th>#</th>
                <th>이름</th>
                <th>도시</th>
                <th>주소</th>
                <th>우편번호</th>
            </tr>
            </thead>
            <tbody>
            <tr th:each="member : ${members}">
                <td th:text="${member.id}"></td>
                <td th:text="${member.name}"></td>
            <!--  타임리프에서 ?를 사용하면 null 을 무시한다  -> null 일시 진행안함-->
                <td th:text="${member.address?.city}"></td>
                <td th:text="${member.address?.street}"></td>
                <td th:text="${member.address?.zipcode}"></td>
            </tr>
            </tbody>
        </table>
    </div>
    <div th:replace="fragments/footer :: footer" />
</div> <!-- /container -->
</body>
</html>

 

타임리프에서 ?를 사용하면 null 을 무시한다.

 

폼 객체 vs 엔티티 직접 사용

요구사항이 정말 단순할 때는

폼 객체( MemberForm ) 없이 엔티티( Member )를 직접 등록과 수정 화면에서 사용해도 된다.

하지만 화면 요구사항이 복잡해지기 시작하면, 엔티티에 화면을 처리하기 위한 기능이 점점 증가한다.

결과적으로 엔티티는 점점 화면에 종속적으로 변하고, 이렇게 화면 기능 때문에 지저분해진 엔티티는

결국 유지보수하기 어려워진다.

실무에서 엔티티는 핵심 비즈니스 로직만 가지고 있고, 화면을 위한 로직은 없어야 한다.

화면이나 API에 맞는 폼 객체나 DTO를 사용하자.

그래서 화면이나 API 요구사항을 이것들로 처리하고, 엔티티는 최대한 순수하게 유지 하자.

 

 

@GetMapping("/members")
public String list(Model model) {
    List<Member> members = memberService.findMembers();
    model.addAttribute("members", members);
    return "members/memberList";
}

현재 회원목록페이지 이동 컨트롤러 메서드를 구현할때

Member 엔티티 그대로를 모델에 담았다.

어차피  다음과 같이

    <td th:text="${member.id}"></td>
    <td th:text="${member.name}"></td>
<!--  타임리프에서 ?를 사용하면 null 을 무시한다  -> null 일시 진행안함-->
    <td th:text="${member.address?.city}"></td>
    <td th:text="${member.address?.street}"></td>
    <td th:text="${member.address?.zipcode}"></td>

Member안에 원하는 데이터만 렌더링해서 보내기 때문이다.

[하지만 여기서도 DTO를 생성해서 사용하는것이 깔끔하다.]

 

하지만 

api (restful api)를 구현할때는 이유를 불문하고 엔티티(Member)를 반환하면 안된다.

이유 

1. 엔티티에 필드가 추가되면 API스펙이 변경된다. [ API 스펙과 다른 필드가 추가되어 반환되므로 ] 

2. 공개되면 안되는 필드까지 반환된다. [ 보안상 문제 ]

 

즉 API는 DTO를 생성하여 반환.

 

 

 

 

상품 등록, 상품 목록

 

상품 등록 폼 

@Getter
@Setter
public class BookForm {
    private Long id; // 상품 수정이 있으므로 아이디가 필요
    private String name;
    private int price;
    private int stockQuantity;

    // 위에는 상품의 공통속성 , 아래는 책의 고유 속성
    private String author;
    private String isbn;
}

 

@Controller
@RequiredArgsConstructor
public class ItemController {

    private final ItemService itemService;

    @GetMapping("/items/new")
    public String createForm(Model model) {
        model.addAttribute("form", new BookForm());
        return "items/createItemForm";
    }

    @PostMapping("/items/new")
    public String create(BookForm form) {
        Book book = new Book();
        book.setName(form.getName());
        book.setPrice(form.getPrice());
        book.setStockQuantity(form.getStockQuantity());
        book.setAuthor(form.getAuthor());
        book.setIsbn(form.getIsbn());

        itemService.save(book);
        return "redirect:/";
    }

    @GetMapping("/items")
    public String list(Model model) {
        List<Item> items = itemService.findItems();
        model.addAttribute("items", items);
        return "items/itemList";
    }

}

 

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header" />
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader"/>
    <form th:action="@{/items/new}" th:object="${form}" method="post">
        <div class="form-group">
            <label th:for="name">상품명</label>
            <input type="text" th:field="*{name}" class="form-control"
                   placeholder="이름을 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="price">가격</label>
            <input type="number" th:field="*{price}" class="form-control"
                   placeholder="가격을 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="stockQuantity">수량</label>
            <input type="number" th:field="*{stockQuantity}" class="formcontrol" placeholder="수량을 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="author">저자</label>
            <input type="text" th:field="*{author}" class="form-control"
                   placeholder="저자를 입력하세요">
        </div>
        <div class="form-group">
            <label th:for="isbn">ISBN</label>
            <input type="text" th:field="*{isbn}" class="form-control"
                   placeholder="ISBN을 입력하세요">
        </div>
        <button type="submit" class="btn btn-primary">Submit</button>
    </form>
    <br/>
    <div th:replace="fragments/footer :: footer" />
</div> <!-- /container -->
</body>
</html>

 

 

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header" />
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader"/>
    <div>
        <table class="table table-striped">
            <thead>
            <tr>
                <th>#</th>
                <th>상품명</th>
                <th>가격</th>
                <th>재고수량</th>
                <th></th>
            </tr>
            </thead>
            <tbody>
            <tr th:each="item : ${items}">
                <td th:text="${item.id}"></td>
                <td th:text="${item.name}"></td>
                <td th:text="${item.price}"></td>
                <td th:text="${item.stockQuantity}"></td>
                <td>
                    <a href="#" th:href="@{/items/{id}/edit (id=${item.id})}"
                       class="btn btn-primary" role="button">수정</a>
                </td>
            </tr>
            </tbody>
        </table>
    </div>
    <div th:replace="fragments/footer :: footer"/>
</div> <!-- /container -->
</body>
</html>

 

상품 등록

- 상품 등록 폼에서 데이터를 입력하고 Submit 버튼을 클릭하면 /items/new 를 POST 방식으로 요청

- 상품 저장이 끝나면 상품 목록 화면( redirect:/items )으로 리다이렉트

 

 

 

상품 수정

상품 수정과 관련된 컨트롤러 코드

@GetMapping("items/{itemId}/edit")
public String updateItemForm(@PathVariable Long itemId, Model model) {
    Book item = (Book) itemService.findOne(itemId); // 예제라서 바로 캐스팅해서 사용

    BookForm form = new BookForm();
    form.setId(item.getId());
    form.setName(item.getName());
    form.setPrice(item.getPrice());
    form.setStockQuantity(item.getStockQuantity());
    form.setAuthor(item.getAuthor());
    form.setIsbn(item.getIsbn());

    model.addAttribute("form", form);
    return "items/updateItemForm";
}

@PostMapping("items/{itemId}/edit")
public String updateItem(@PathVariable Long itemId,@ModelAttribute("form") BookForm form) {
    Book book = new Book();
    book.setId(form.getId());
    book.setName(form.getName());
    book.setPrice(form.getPrice());
    book.setStockQuantity(form.getStockQuantity());
    book.setAuthor(form.getAuthor());
    book.setIsbn(form.getIsbn());
    itemService.save(book);
    return "redirect:/items";

}

 

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header" />
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader"/>
    <form th:object="${form}" method="post">
        <!-- id -->
        <input type="hidden" th:field="*{id}" />
        <div class="form-group">
            <label th:for="name">상품명</label>
            <input type="text" th:field="*{name}" class="form-control"
                   placeholder="이름을 입력하세요" />
        </div>
        <div class="form-group">
            <label th:for="price">가격</label>
            <input type="number" th:field="*{price}" class="form-control"
                   placeholder="가격을 입력하세요" />
        </div>
        <div class="form-group">
            <label th:for="stockQuantity">수량</label>
            <input type="number" th:field="*{stockQuantity}" class="formcontrol" placeholder="수량을 입력하세요" />
        </div>
        <div class="form-group">
            <label th:for="author">저자</label>
            <input type="text" th:field="*{author}" class="form-control"
                   placeholder="저자를 입력하세요" />
        </div>
        <div class="form-group">
            <label th:for="isbn">ISBN</label>
            <input type="text" th:field="*{isbn}" class="form-control"
                   placeholder="ISBN을 입력하세요" />
        </div>
        <button type="submit" class="btn btn-primary">Submit</button>
    </form>
    <div th:replace="fragments/footer :: footer" />
</div> <!-- /container -->
</body>
</html>

 

상품 수정 폼 이동

1. 수정 버튼을 선택하면 /items/{itemId}/edit URL을 GET 방식으로 요청

2. 그 결과로 updateItemForm() 메서드를 실행하는데 이 메서드는 itemService.findOne(itemId) 를 호출해서

수정할 상품을 조회

3. 조회 결과를 모델 객체에 담아서 뷰( items/updateItemForm )에 전달

 

 

상품 수정 실행

상품 수정 폼 HTML에는 상품의 id(hidden), 상품명, 가격, 수량 정보 있음

1. 상품 수정 폼에서 정보를 수정하고 Submit 버튼을 선택

2. /items/{itemId}/edit URL을 POST 방식으로 요청하고 updateItem() 메서드를 실행

3. 이때 컨트롤러에 파라미터로 넘어온 item 엔티티 인스턴스는 현재 준영속 상태다.

따라서 영속성 컨텍스트의 지원을 받을 수 없고 데이터를 수정해도 변경 감지 기능은 동작X

 

 

변경 감지와 병합(merge)

매우 중요

 

 

준영속 엔티티?

영속성 컨텍스트가 더는 관리하지 않는 엔티티를 말한다.

@PostMapping("items/{itemId}/edit")
public String updateItem(@PathVariable Long itemId,@ModelAttribute("form") BookForm form) {
    Book book = new Book();
    book.setId(form.getId());
    book.setName(form.getName());
    book.setPrice(form.getPrice());
    book.setStockQuantity(form.getStockQuantity());
    book.setAuthor(form.getAuthor());
    book.setIsbn(form.getIsbn());
    itemService.save(book);
    return "redirect:/items";

}

(여기서는 itemService.save(book) 에서 수정을 시도하는 Book 객체다.

Book 객체는 이미 DB에 한번 저장되어서 식별자가 존재한다. [ 식별자 == id ]

이렇게 임의로 만들어낸 엔티티도 기존 식별자를 가지고 있으면 준영속 엔티티로 볼 수 있다.)

 

BookForm을 통해 담겨온 Book 정보는 이미 DB에 저장됬으므로 ID를 가진다.

즉 한번 영속성컨테이너에서 관리되었던 엔티티의 정보라는것이다.

그걸 다시 book이라는 엔티티에 담았다.

그러므로 book 엔티티가 기존에 관리되던 엔티티의 정보를 담았으므로 준영속 엔티티로 볼 수 있다.

[ 하나의 영속성 컨텍스트는 하나의 트랜잭션 범위에 존재한다. BookForm에 담겨왔던 엔티티정보는 이미 이전 영속성 컨텍스트에서 영속을 한 뒤 DB에 쿼리를 실행했고 ,현재 트랜잭션의 영속성 컨텍스트에서는 관리되고 있지않는다.

그 정보를 저장한 book을 예전에 영속성 컨텍스트가 관리했으므로 준영속 엔티티로 본다.
즉 예전에 영속성컨텍스트에서 관리했으나, 현재 트랜잭션의 영속성컨텍스트에서는 관리되고있지않다.]

 

그러므로 book을 수정해도 변경감지가 되지않아서 update 되지않는다.

 

준영속 엔티티를 수정하는 2가지 방법

- 변경 감지 기능

- 사용 병합( merge ) 사용

 

 

 

 

변경 감지 기능 사용 

@Transactional
public void updateItem(Long itemId, Book param) {
    Item findItem = itemRepository.findOne(itemId); // 조회를 함으로써 영속성컨테이너에서 관리되게한다. 영속상태로 만든다.
    findItem.setPrice(param.getPrice());
    findItem.setName(param.getName());
    findItem.setStockQuantity(param.getStockQuantity());
    // 모든 코드가 정상적으로 진행됬다면 commit이 되고, commmit 이 되면 flush가 되어 변경감지로 인해  update 쿼리 실행된다.
}

영속성 컨텍스트에서 엔티티를 다시 조회한 후에 데이터를 수정하는 방법

트랜잭션 안에서 엔티티를 다시 조회, 변경할 값 선택

 -> 트랜잭션 커밋 시점에 변경 감지(Dirty Checking)이 동작해서 데이터베이스에 UPDATE SQL 실행

 

 

병합 사용

병합은 준영속 상태의 엔티티를 영속 상태로 변경할 때 사용하는 기능이다.

@PostMapping("items/{itemId}/edit")
public String updateItem(@PathVariable Long itemId,@ModelAttribute("form") BookForm form) {
    Book book = new Book();
    book.setId(form.getId());
    book.setName(form.getName());
    book.setPrice(form.getPrice());
    book.setStockQuantity(form.getStockQuantity());
    book.setAuthor(form.getAuthor());
    book.setIsbn(form.getIsbn());
    itemService.save(book);
    return "redirect:/items";

}
public void save(Item item) {
    if (item.getId() == null) { // 엔티티의 id값이 없다는것은 아직 해당 엔티티가 저장이 안되어있다는것
        em.persist(item);
    } else {
        em.merge(item);
    }
}

save() 메서드는 식별자 값이 없으면( null ) 새로운 엔티티로 판단해서 영속화(persist)하고 식별자가 있으면 병합(merge) 지금처럼 준영속 상태인 상품 엔티티를 수정할 때는 id 값이 있으므로 병합 수행

 

merge는 위에 변경 감지 기능 사용을 위한 코드를 jpa가 알아서 진행하게 해준다.

[엔티티를 조회해서 영속상태로 만들고, 파라미터로 받은값을 이용해서 수정을 진행. 변경감지로 update 처리]

 

 

새로운 엔티티 저장과 준영속 엔티티 병합을 편리하게 한번에 처리

상품 리포지토리에선 save() 메서드를 유심히 봐야 하는데, 이 메서드 하나로 저장과 수정(병합)을 다 처리한다.

코드를 보면 식별자 값이 없으면 새로운 엔티티로 판단해서 persist() 로 영속화하고

만약 식별자 값이 있으면 이미 한번 영속화 되었던 엔티티로 판단해서 merge() 로 수정(병합)한다.

결국 여기서의 저장(save)이라는 의미는 신규 데이터 를 저장하는 것뿐만 아니라

변경된 데이터의 저장이라는 의미도 포함한다.

 

이렇게 함으로써 이 메서드를 사용하는 클라이언트는 저장과 수정을 구분하지 않아도 되므로

클라이언트의 로직이 단순해진다. 여기서 사용하는 수정(병합)은 준영속 상태의 엔티티를 수정할 때 사용한다.

영속 상태의 엔티티는 변경 감지(dirty checking)기능이 동작해서 트랜잭션을 커밋할 때 자동으로 수정되므로

별도의 수정 메서드를 호출할 필요가 없고 그런 메서드도 없다.

 

 

참고

save() 메서드는 식별자를 자동 생성해야 정상 동작한다.

여기서 사용한 Item 엔티티의 식별자는 자동으로 생성되도록 @GeneratedValue 를 선언했다.

따라서 식별자 없이 save() 메서드를 호출하면 persist()가 호출되면서 식별자 값이 자동으로 할당된다.

반면에 식별자를 직접 할당하도록 @Id 만 선언했다고 가정하자.

이 경우 식별자를 직접 할당하지 않고, save() 메서드를 호출하면 식별자가 없는 상태로 persist() 를 호출한다.

그러면 식별자가 없다는 예외가 발생한다

 

참고

실무에서는 보통 업데이트 기능이 매우 제한적이다.

그런데 병합은 모든 필드를 변경해버리고, 데이터가 없으면 null 로 업데이트 해버린다.

병합을 사용하면서 이 문제를 해결하려면, 변경 폼 화면에서 모든 데이터를 항상 유지해야 한다.

실무에서는 보통 변경가능한 데이터만 노출하기 때문에, 병합을 사용하는 것이 오히려 번거롭다.

 

 

병합 동작 방식

 

1. merge() 를 실행한다.

 

2. 파라미터로 넘어온 준영속 엔티티의 식별자 값으로 1차 캐시에서 엔티티를 조회한다.

2-1. 만약 1차 캐시에 엔티티가 없으면 데이터베이스에서 엔티티를 조회하고, 1차 캐시에 저장한다.

 

3. 조회한 영속 엔티티( mergeMember )에 member 엔티티의 값을 채워 넣는다.

(member 엔티티의 모든 값을 mergeMember에 밀어 넣는다.

이때 mergeMember의 “회원1”이라는 이름이 “회원명변경”으로 바뀐다.)

 

4. 영속 상태인 mergeMember를 반환한다.

 

 

 

병합시 동작 방식을 간단히 정리

 

1. 준영속 엔티티의 식별자 값으로 영속 엔티티를 조회한다.

 

2. 영속 엔티티의 값을 준영속 엔티티의 값으로 모두 교체한다.(병합한다.)

 

3. 트랜잭션 커밋 시점에 변경 감지 기능이 동작해서 데이터베이스에 UPDATE SQL이 실행

 

[ 파라미터로 넘어온 엔티티는 영속성컨테이너에서 관리되지않는다. 식별자 및 변경사항을 위한 엔티티임 ]

 

 

주의

변경 감지 기능을 사용하면 원하는 속성만 선택해서 변경할 수 있지만,

병합을 사용하면 모든 속성이 변경된다.

병합시 값이 없으면 null 로 업데이트 할 위험도 있다. (병합은 모든 필드를 교체한다.)

 

merge 방법을 사용하면 안되고 변경감지 방법을 사용해야한다.

 

가장 좋은 해결 방법

엔티티를 변경할 때는 항상 변경 감지를 사용

 

- 컨트롤러에서 어설프게 엔티티를 생성하지마세요

- 트랜잭션이 있는 서비스 계층에 식별자( id )와 변경할 데이터를 명확하게 전달하세요.(파라미터 or dto)

- 트랜잭션이 있는 서비스 계층에서 영속 상태의 엔티티를 조회하고, 엔티티의 데이터를 직접 변경하세요.

- 트랜잭션 커밋 시점에 변경 감지가 실행됩니다

@PostMapping("items/{itemId}/edit")
    public String updateItem(@PathVariable Long itemId,@ModelAttribute("form") BookForm form) {
//        Book book = new Book();
//        book.setId(form.getId());
//        book.setName(form.getName());
//        book.setPrice(form.getPrice());
//        book.setStockQuantity(form.getStockQuantity());
//        book.setAuthor(form.getAuthor());
//        book.setIsbn(form.getIsbn());
//        itemService.save(book);

        itemService.updateItem(itemId,form.getName(),form.getPrice(),form.getStockQuantity());
        return "redirect:/items";
    }

기존의 코드는 Book엔티티를 생성해서 service로 넘겼다.

[ 웹계층에서 사용되는 DTO를 넘기게 되면 서비스가 웹 계층 DTO를 의존하게 되니까.]

이렇게 엔티티를 생성하지않고, 필요한 값만 딱 넘겨주고

@Transactional
public void updateItem(Long itemId, String name,int price,int stockQuantity) {
    Item findItem = itemRepository.findOne(itemId); // 조회를 함으로써 영속성컨테이너에서 관리되게한다. 영속상태로 만든다.
    findItem.updateItem(name, price, stockQuantity);
    // 모든 코드가 정상적으로 진행됬다면 commit이 되고, commmit 이 되면 flush가 되어 변경감지로 인해  update 쿼리 실행된다.
}

다음과 같이 처리하면 깔끔하다.

[ update해야할 정보가 많다면 서비스 계층의 DTO를 생성해서 사용한다.

또는 컨트롤러,서비스,리포지토리 전 계층에서 사용되는 DTO를 생성해서 사용한다.]

 

그리고

@Transactional
public void updateItem(Long itemId, Book param) {
    Item findItem = itemRepository.findOne(itemId); // 조회를 함으로써 영속성컨테이너에서 관리되게한다. 영속상태로 만든다.
    findItem.setPrice(param.getPrice());
    findItem.setName(param.getName());
    findItem.setStockQuantity(param.getStockQuantity());
    // 모든 코드가 정상적으로 진행됬다면 commit이 되고, commmit 이 되면 flush가 되어 변경감지로 인해  update 쿼리 실행된다.
}

service에서 setter를 이용해서 수정하는것보다는

엔티티에 수정하는 메소드를 가지고있어서 한곳에서 처리하는것이 좋다.

어디서 엔티티의 값을 수정하는지 찾기도 쉽고 비즈니스 로직을 엔티티안에 넣게되면 객체 응집도가 좋아진다.

@Transactional
    public void updateItem(Long itemId, String name,int price,int stockQuantity) {
        Item findItem = itemRepository.findOne(itemId); // 조회를 함으로써 영속성컨테이너에서 관리되게한다. 영속상태로 만든다.
        findItem.updateItem(name, price, stockQuantity);
        // 모든 코드가 정상적으로 진행됬다면 commit이 되고, commmit 이 되면 flush가 되어 변경감지로 인해  update 쿼리 실행된다.
    }

 

 

 

상품 주문 

@Controller
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;
    private final MemberService memberService;
    private final ItemService itemService;

    @GetMapping("/order")
    public String createForm(Model model) {
        List<Member> members = memberService.findMembers();
        List<Item> items = itemService.findItems();

        model.addAttribute("members", members);
        model.addAttribute("items", items);

        return "order/orderForm";
    }

    @PostMapping("/order")
    public String order(@RequestParam("memberId") Long memberId,
                        @RequestParam("itemId") Long itemId,
                        @RequestParam("count") int count){
        // Form 데이터는 바디에 쓰이지만 쿼리스트링으로 온다. 즉 쿼리파라미터값이므로 @RequestParam으로 받을 수있다.
        // DTO를 만들어서 @ModelAttribute를 쓰는경우도 있지만 여기서는 @RequestParam을 사용
        // 컨트롤러에서 직접 엔티티를 찾아서 전달하는것보다는 식별자를 넘긴다.
        // 엔티티 조회는 하나의 트랜잭션에서 진행되면 영속상태로 로직이 흘러가기 때문에 좋다. 
        //즉 서비스에서 조회를 진행해서 영속안되어있는 엔티티는 영속화 시키고 진행하는것이 이득이 많다.
        orderService.order(memberId, itemId, count);
        return "redirect:/orders";
    }
}

주문 폼 이동

 

- 메인 화면에서 상품 주문을 선택하면 /order 를 GET 방식으로 호출

 

- OrderController 의 createForm() 메서드

 

- 주문 화면에는 주문할 고객정보와 상품 정보가 필요하므로 model 객체에 담아서 뷰에 넘겨줌

 

주문 실행

 

- 주문할 회원과 상품 그리고 수량을 선택해서 Submit 버튼을 누르면 /order URL을 POST 방식으로 호출

 

- 컨트롤러의 order() 메서드를 실행

 

- 이 메서드는 고객 식별자( memberId ), 주문할 상품 식별자( itemId ), 수량( count ) 정보를 받아서

주문 서비스에 주문을 요청

 

- 주문이 끝나면 상품 주문 내역이 있는 /orders URL로 리다이렉트

 

/*
주문
 */
@Transactional
public Long order(Long memberId, Long itemId, int count) {
    // 엔티티 조회
    Member member = memberRepository.findOne(memberId);
    Item item = itemRepository.findOne(itemId);

    // 배송정보 생성
    Delivery delivery = new Delivery();
    delivery.setAddress(member.getAddress());

    // 주문상품 생성 -> 기본 생성자를 protected로 막고(@NoArgsConstructor(access = AccessLevel.PROTECTED), 정적 팩토리 메서드 패턴을 이용하여 생성메소드를 사용하게끔 유도해야한다. 기본생성자로 객체 생성시 객체 생성로직 바뀌면 전부 수정해야한다.
    OrderItem orderItem = OrderItem.createOrderItem(item, item.getPrice(), count);

    // 주문 생성
    Order order = Order.createOrder(member, delivery, orderItem);

    // 주문 저장  -> Delivery , OrderItem 도 생성했으므로 save를 해줘야하지않나? -> Order안에 필드로 delivery , OrderItem이 있는데 Cascade 설정이 되어있으므로
    // Order가 생성될때 같이 생성된다.
    orderRepository.save(order);

    return order.getId();
}

생성해놓은 오더서비스의 주문 메서드

 

 

 

주문 목록 검색, 취소 

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header"/>
<body>
<div class="container">
    <div th:replace="fragments/bodyHeader :: bodyHeader"/>
    <div>
        <div>
            <form th:object="${orderSearch}" class="form-inline">
                <div class="form-group mb-2">
                    <input type="text" th:field="*{memberName}" class="formcontrol" placeholder="회원명"/>
                </div>
                <div class="form-group mx-sm-1 mb-2">
                    <select th:field="*{orderStatus}" class="form-control">
                        <option value="">주문상태</option>
                        <option th:each="status : ${T(jpabook.jpashop.domain.OrderStatus).values()}"
                                th:value="${status}"
                                th:text="${status}">option
                        </option>
                    </select>
                </div>
                <button type="submit" class="btn btn-primary mb-2">검색</button>
            </form>
        </div>
        <table class="table table-striped">
            <thead>
            <tr>
                <th>#</th>
                <th>회원명</th>
                <th>대표상품 이름</th>
                <th>대표상품 주문가격</th>
                <th>대표상품 주문수량</th>
                <th>상태</th>
                <th>일시</th>
                <th></th>
            </tr>
            </thead>
            <tbody>
            <tr th:each="item : ${orders}">
                <td th:text="${item.id}"></td>
                <td th:text="${item.member.name}"></td>
                <td th:text="${item.orderItems[0].item.name}"></td>
                <td th:text="${item.orderItems[0].orderPrice}"></td>
                <td th:text="${item.orderItems[0].count}"></td>
                <td th:text="${item.status}"></td>
                <td th:text="${item.orderDate}"></td>
                <td>
                    <a th:if="${item.status.name() == 'ORDER'}" href="#"
                       th:href="'javascript:cancel('+${item.id}+')'"
                       class="btn btn-danger">CANCEL</a>
                </td>
            </tr>
            </tbody>
        </table>
    </div>
    <div th:replace="fragments/footer :: footer"/>
</div> <!-- /container -->
</body>
<script>
    function cancel(id) {
        var form = document.createElement("form");
        form.setAttribute("method", "post");
        form.setAttribute("action", "/orders/" + id + "/cancel");
        document.body.appendChild(form);
        form.submit();
    }
</script>
</html>

 

@GetMapping("/orders")
public String orderList(@ModelAttribute("orderSearch") OrderSearch orderSearch, Model model) {
    List<Order> orders = orderService.findOrders(orderSearch); // 서비스단이 단순 위임이라면, 서비스를 스킵하고 Repository를 이용해서 바로 실행해도된다.
    model.addAttribute("orders", orders);

    return "order/orderList";
}

@PostMapping("/orders/{orderId}/cancel")
public String cancelOrder(@PathVariable Long orderId) {
    orderService.cancelOrder(orderId);
    return "redirect:/orders";
}

 

'인프런 > 실전! 스프링부트와 JPA활용1' 카테고리의 다른 글

3) 웹 어플리케이션 개발 [회원,상품,주문 도메인]  (0) 2024.06.07
2) 도메인 분석 설계  (1) 2024.06.05
1)프로젝트생성,설정, 테스트  (0) 2023.01.12

댓글

티스토리툴바