체크박스·라디오·셀렉트

<!doctype html>
<html lang="ko" xmlns:th="http://www.thymeleaf.org">
<head>
  <meta charset="utf-8" />
  <title>게시글 표시 설정</title>
</head>
<body>
  <main>
    <h1>게시글 표시 설정</h1>
    <form th:action="@{/b88/controls/posts/{id}/settings(id=${postId})}"
          th:object="${form}" method="post">
      <label>
        <input type="checkbox" th:field="*{publicVisible}" />
        다른 회원에게 공개
      </label>
      <fieldset>
        <legend>게시글 분류</legend>
        <label th:each="category : ${categories}">
          <input type="radio" th:field="*{category}"
                 th:value="${category}" />
          <span th:text="${category.label}">질문</span>
        </label>
      </fieldset>
      <div th:replace="~{controls/_post-settings-options :: options}"></div>
      <button type="submit">설정 저장</button>
    </form>
  </main>
</body>
</html>

package board.controls;

import java.util.ArrayList;
import java.util.List;

public final class PostSettingsForm {
    private boolean publicVisible;
    private PostCategory category;
    private String categoryCode = "";
    private List<String> tagCodes = new ArrayList<>();

    public boolean isPublicVisible() {
        return publicVisible;
    }

    public void setPublicVisible(boolean publicVisible) {
        this.publicVisible = publicVisible;
    }

    public PostCategory getCategory() {
        return category;
    }

    public void setCategory(PostCategory category) {
        this.category = category;
    }

    public String getCategoryCode() {
        return categoryCode;
    }

    public void setCategoryCode(String categoryCode) {
        this.categoryCode = categoryCode;
    }

    public List<String> getTagCodes() {
        return List.copyOf(tagCodes);
    }

    public void setTagCodes(List<String> tagCodes) {
        this.tagCodes = tagCodes == null
                ? new ArrayList<>()
                : new ArrayList<>(tagCodes);
    }

    public enum PostCategory {
        GENERAL("일반"), QUESTION("질문"), NOTICE("공지");

        private final String label;

        PostCategory(String label) {
            this.label = label;
        }

        public String getLabel() {
            return label;
        }
    }
}

<div xmlns:th="http://www.thymeleaf.org" th:fragment="options">
  <label for="categoryCode">분류</label>
  <select id="categoryCode" th:field="*{categoryCode}">
    <option value="">분류를 선택하세요</option>
    <option th:each="category : ${categories}"
            th:value="${category.name()}"
            th:text="${category.label}">일반</option>
  </select>

  <fieldset>
    <legend>태그</legend>
    <label th:each="tag : ${tags}">
      <input type="checkbox" th:field="*{tagCodes}"
             th:value="${tag.code}" />
      <span th:text="${tag.name}">Backend</span>
    </label>
  </fieldset>
</div>

package board.controls;

import java.util.List;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/b88/controls/posts/{postId}/settings")
public final class PostSettingsController {
    @ModelAttribute("categories")
    List<PostSettingsForm.PostCategory> categories() {
        return List.of(PostSettingsForm.PostCategory.values());
    }

    @ModelAttribute("tags")
    List<TagOption> tags() {
        return List.of(
                new TagOption("java", "Java"),
                new TagOption("spring", "Spring"));
    }

    @GetMapping
    String edit(@PathVariable long postId, Model model) {
        var form = new PostSettingsForm();
        form.setPublicVisible(true);
        form.setCategory(PostSettingsForm.PostCategory.QUESTION);
        form.setCategoryCode("NOTICE");
        form.setTagCodes(List.of("spring"));
        model.addAttribute("postId", postId);
        model.addAttribute("form", form);
        return "controls/post-settings";
    }

    @PostMapping
    String update(
            @PathVariable long postId,
            @ModelAttribute("form") PostSettingsForm form,
            Model model
    ) {
        model.addAttribute("postId", postId);
        return "controls/post-settings";
    }

    public record TagOption(String code, String name) {}
}

package board.controls;

import static org.assertj.core.api.Assertions.assertThat;

import java.util.List;
import java.util.Map;

import org.junit.jupiter.api.Test;
import org.springframework.beans.MutablePropertyValues;
import org.springframework.web.bind.WebDataBinder;

class PostSettingsBindingTest {
    @Test
    void checkbox_marker는_기존_true를_false로_바꾼다() {
        var form = new PostSettingsForm();
        form.setPublicVisible(true);
        var binder = new WebDataBinder(form, "form");

        binder.bind(new MutablePropertyValues(
                Map.of("_publicVisible", "on")));

        assertThat(form.isPublicVisible()).isFalse();
        assertThat(binder.getBindingResult().hasErrors()).isFalse();
    }

    @Test
    void category_속성들은_같은_이름의_accessor로_바인딩된다() {
        var form = new PostSettingsForm();
        var binder = new WebDataBinder(form, "form");

        binder.bind(new MutablePropertyValues(
                Map.of(
                        "category", "QUESTION",
                        "categoryCode", "NOTICE")));

        assertThat(form.getCategory())
                .isEqualTo(PostSettingsForm.PostCategory.QUESTION);
        assertThat(form.getCategoryCode()).isEqualTo("NOTICE");
        assertThat(binder.getBindingResult().hasErrors()).isFalse();
    }

    @Test
    void 존재하지_않는_enum은_typeMismatch로_남는다() {
        var form = new PostSettingsForm();
        var binder = new WebDataBinder(form, "form");

        binder.bind(new MutablePropertyValues(
                Map.of("category", "EXTREME")));

        assertThat(binder.getBindingResult()
                .getFieldError("category")
                .getCode()).isEqualTo("typeMismatch");
    }

    @Test
    void 반복된_tagCodes는_원본_순서와_중복을_보존한다() {
        var form = new PostSettingsForm();
        var binder = new WebDataBinder(form, "form");
        var values = new MutablePropertyValues();
        values.add("tagCodes", new String[]{"java", "spring", "java"});

        binder.bind(values);

        assertThat(form.getTagCodes())
                .containsExactly("java", "spring", "java");
    }

    @Test
    void tagCodes_marker는_기존_선택을_빈_목록으로_바꾼다() {
        var form = new PostSettingsForm();
        form.setTagCodes(List.of("java"));
        var binder = new WebDataBinder(form, "form");

        binder.bind(new MutablePropertyValues(
                Map.of("_tagCodes", "on")));

        assertThat(form.getTagCodes()).isEmpty();
        assertThat(binder.getBindingResult().hasErrors()).isFalse();
    }
}

package board.controls;

import org.springframework.boot.SpringBootConfiguration;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.Import;

@SpringBootConfiguration(proxyBeanMethods = false)
@EnableAutoConfiguration
@Import(PostSettingsController.class)
public class ControlsTestApplication {}

package board.controls;

import static java.nio.charset.StandardCharsets.UTF_8;
import static org.assertj.core.api.Assertions.assertThat;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.view;

import org.jsoup.Jsoup;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc;
import org.springframework.test.web.servlet.MockMvc;

@SpringBootTest(classes = ControlsTestApplication.class)
@AutoConfigureMockMvc
class PostSettingsMvcRenderTest {
    @Autowired
    MockMvc mvc;

    @Test
    void 수정_화면은_marker와_저장된_선택을_fragment까지_렌더링한다()
            throws Exception {
        var response = mvc.perform(get(
                        "/b88/controls/posts/42/settings"))
                .andExpect(status().isOk())
                .andExpect(view().name("controls/post-settings"))
                .andReturn()
                .getResponse();
        var document = Jsoup.parse(response.getContentAsString(UTF_8));

        assertThat(document.select(
                "form[action='/b88/controls/posts/42/settings']"))
                .hasSize(1);
        assertThat(document.select(
                "input[name=_publicVisible][value=on]")).hasSize(1);
        assertThat(document.select(
                "input[name=publicVisible][checked]")).hasSize(1);
        assertThat(document.select(
                "input[name=category][value=QUESTION][checked]")).hasSize(1);
        assertThat(document.select(
                "select[name=categoryCode] option[value=NOTICE][selected]"))
                .hasSize(1);
        assertThat(document.select(
                "input[name=_tagCodes][value=on]")).isNotEmpty();
        assertThat(document.select(
                "input[name=tagCodes][value=spring][checked]")).hasSize(1);
    }

    @Test
    void marker만_POST하면_체크박스_선택을_비운_상태로_다시_그린다()
            throws Exception {
        var result = mvc.perform(post(
                        "/b88/controls/posts/42/settings")
                        .param("_publicVisible", "on")
                        .param("_tagCodes", "on"))
                .andExpect(status().isOk())
                .andExpect(view().name("controls/post-settings"))
                .andReturn();
        var form = (PostSettingsForm) result.getModelAndView()
                .getModel().get("form");
        var document = Jsoup.parse(
                result.getResponse().getContentAsString(UTF_8));

        assertThat(form.isPublicVisible()).isFalse();
        assertThat(form.getTagCodes()).isEmpty();
        assertThat(document.select(
                "input[name=publicVisible][checked]")).isEmpty();
        assertThat(document.select(
                "input[name=tagCodes][checked]")).isEmpty();
        assertThat(document.select(
                "input[name=_tagCodes][value=on]")).isNotEmpty();
    }
}