🐯[TIL] 250704-025

byo·2025년 7월 4일

[TIL] 🐯멋쟁이사자처럼

목록 보기

25/42

💫 Lombok

✔️ 왜 Lombok을 사용하는가?

보일러플레이트 제거
- 반복되는 생성자, getter/setter, toString, equals/hashCode 등을 어노테이션 한 줄로 자동 생성
코드 가독성 향상
- 핵심 비즈니스 로직에 집중할 수 있고, 클래스 정의가 간결해짐
유지보수성 증대
- 변경이 필요할 때 어노테이션 옵션만 조정하면 되므로 수정 범위 최소화
컴파일 타임 처리
- IDE와 빌드 툴에서 자동으로 코드를 생성하므로 런타임 오버헤드는 없음

👉 핵심: Lombok은 코드 자동 생성을 통해 개발 생산성과 코드 품질을 동시에 끌어올려 줍니다.

✔️ Lombok 라이브러리 주요 어노테이션 활용 가이드

✅ 1. `@Getter` / `@Setter`

역할: 각 필드에 대한 getter 및 setter 메서드를 생성
적용법: 클래스 레벨 또는 개별 필드에 붙이면 자동 생성
확인법: IDE에서 메서드 자동 완성 또는 단위 테스트로 호출해 보기

@Getter @Setter
public class Memo {
    private int id;
    private String title;
    private String content;
}

// 사용 예시 (단위 테스트)
public void testGetterSetter() {
    Memo memo = new Memo();
    memo.setTitle("Hello");
    assert "Hello".equals(memo.getTitle());
}

✅ 2. `@NoArgsConstructor` / `@AllArgsConstructor`

@NoArgsConstructor: 매개변수 없는 기본 생성자 생성
@AllArgsConstructor: 모든 필드를 파라미터로 받는 생성자 생성
확인법: IDE에서 생성자 호출 또는 리플렉션 사용

@NoArgsConstructor
@AllArgsConstructor
public class CustomerRank {
    private int customerId;
    private BigDecimal totalSpent;
    private int rank;
}

// 사용 예시
public void testConstructors() {
    CustomerRank empty = new CustomerRank();          // NoArgs
    CustomerRank full  = new CustomerRank(1, new BigDecimal("100.00"), 1);
    assert full.getCustomerId() == 1;
}

✅ 3. `@RequiredArgsConstructor`

역할: final 또는 @NonNull 필드만 파라미터로 받는 생성자 생성
장점: 생성자 주입 코드를 간결하게 작성
확인법: final 필드 자동 주입 확인, IDE에서 생성자 확인

@RequiredArgsConstructor
public class DashboardController {
    private final DashboardRepository repo;
}

// 사용 예시
public void testRequiredArgs() {
    DashboardRepository repo = new DashboardRepository(...);
    DashboardController ctrl = new DashboardController(repo);
    assert ctrl.getRepo() == repo;
}

✅ 4. `@ToString`

역할: toString() 메서드를 자동으로 생성
옵션: exclude, of, callSuper 등으로 필드 지정 가능
확인법: System.out.println() 으로 출력

@ToString(includeFieldNames = true)
public class DailySales {
    private LocalDate saleDate;
    private BigDecimal totalAmount;
    private int orderCount;
}

// 사용 예시
public void testToString() {
    DailySales ds = new DailySales(LocalDate.now(), new BigDecimal("50.00"), 5);
    System.out.println(ds);  // DailySales(saleDate=..., totalAmount=50.00, orderCount=5)
}

✅ 5. `@EqualsAndHashCode`

역할: equals() 및 hashCode() 메서드를 자동 생성
옵션: exclude, onlyExplicitlyIncluded 등으로 필드 지정
확인법: 컬렉션 비교 또는 equals() 직접 호출

@EqualsAndHashCode(onlyExplicitlyIncluded = true)
public class Memo {
    @EqualsAndHashCode.Include
    private int id;
    private String title;
    private String content;
}

// 사용 예시
public void testEqualsHashCode() {
    Memo m1 = new Memo(1, "A", "B");
    Memo m2 = new Memo(1, "X", "Y");
    assert m1.equals(m2);
    assert m1.hashCode() == m2.hashCode();
}

✅ 6. `@Data`

역할: @Getter, @Setter, @RequiredArgsConstructor, @ToString, @EqualsAndHashCode를 한 번에 포함
추천: 순수 데이터 객체 정의
확인법: 위 모든 기능 확인

@Data
public class CustomerRank {
    private final int customerId;
    private BigDecimal totalSpent;
    private int rank;
}

// 사용 예시: getter, setter, toString, equals 모두 즉시 사용 가능
public void testDataAnnotation() {
    CustomerRank cr = new CustomerRank(1);
    cr.setTotalSpent(new BigDecimal("200"));
    System.out.println(cr);
    assert cr.getCustomerId() == 1;
}

✅ 7. `@Builder`

역할: 빌더 패턴 코드를 자동 생성
장점: 가독성 높은 객체 생성, 선택적 파라미터 처리
확인법: builder() 메서드 호출

@Builder
public class DailySales {
    private LocalDate saleDate;
    private BigDecimal totalAmount;
    private int orderCount;
}

// 사용 예시
public void testBuilder() {
    DailySales ds = DailySales.builder()
        .saleDate(LocalDate.of(2025,1,1))
        .totalAmount(new BigDecimal("1000.00"))
        .orderCount(20)
        .build();
    assert ds.getOrderCount() == 20;
}

☑️ 8. 실전 팁

스프링 빈 생성자 주입: @RequiredArgsConstructor + final 필드 → 깔끔한 컨트롤러/서비스 선언
데이터 전송 객체(DTO): @Data + @NoArgsConstructor + @AllArgsConstructor로 빠르게 정의
로깅/디버깅: @ToString(exclude="password") 처럼 민감 정보 제외 가능

📝 실습 : 교사, 학생 CRUD

💫 DB Table 구성

postgreSql로 구성된 로컬 db에 테이블 생성

powerShell > postgreSQL

psql -U postgres

CREATE USER edu_system WITH PASSWORD 'password';
\du

CREATE DATABASE edu_system OWNER edu_system;
\l

\q

psql -U edu_system -W

CREATE TABLE teacher (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL
);

CREATE TABLE student (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  score INT NOT NULL,
  teacher_id INT REFERENCES teacher(id)
);

RDB 1:n 같은거 첨에 배울때 어지러웠는데..
reference 를 teacher 테이블에 두냐 student 테이블에 두냐 비교해서 보니까 확 와닿았다.. 당연히 student에 둬야 조회할때 편하다. teacher가 모든 학생을 갖고있으면 하나 검색할때 모든 배열을 순회해야 하니까 에너지가 더 들어 비효율적이다.

🌐 HTTP 메서드

HTTP 메서드는 클라이언트가 서버에 어떤 동작을 요청하는지 나타내는 방식이다.
REST API 설계에서도 이 메서드들이 매우 중요한 역할을 한다.

메서드	의미	설명
GET	조회	리소스를 요청 (읽기 전용, 안전함)
POST	생성	서버에 새로운 리소스를 생성 (보통 html form으로 받아오고 있다.)
PUT	수정 (전체)	리소스를 전체 수정
PATCH	수정 (일부)	리소스 일부 필드만 수정
DELETE	삭제	리소스 제거

💫 Spring

✔️ Teacher, Student CRUD

➕ Add Teacher

🧠 model

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Teacher {
    private Integer id;
    private String name;
}

lombok으로 필드 초기화 없는 생성자, 모든 필드를 초기화하는 생성자 등 주입

🗄️ repository - jdbc로 db에 저장

@Repository
@RequiredArgsConstructor
//@NoArgsConstructor
public class TeacherRepository {
    private final JdbcTemplate jdbcTemplate;

    public int save(Teacher teacher) {
        return jdbcTemplate.update(
                "INSERT INTO teacher (name) VALUES (?)",
                teacher.getName()
        );
    }
}

save 반환형이 int 인 이유는 jdbc.update가 쿼리 영향 받은 row 개수를 반환하기 때문임

📡 controller

@Controller
@RequestMapping("/teachers")
@RequiredArgsConstructor
public class StudentController {
    private final TeacherRepository teacherRepository;

    @GetMapping
    public String list() {
        return "teacher-list";
    }

    @GetMapping("/add")
    public String addForm() {
        return "teacher-form";
    }

    @PostMapping("/add")
    public String add(@ModelAttribute Teacher teacher) {
        teacherRepository.save(teacher);
        return "redirect:/teachers";
    }
}

@RequestMapping("/teachers")
@GetMapping() -> teacher-list.html
@GetMapping("/add") -> teacher-form.html
@PostMapping("/add") -> (repository)save -> redirect to teacher-list.html

🎨 styles.css

/* 전체 배경 & 기본 폰트 */
body {
  margin: 0;
  padding: 20px;
  font-family: 'Helvetica Neue', Arial, sans-serif;
  background-color: #FFF8F0; /* 연한 베이지 */
  color: #5A4E4D;            /* 부드러운 브라운 */
}

/* 컨테이너 */
.container {
  max-width: 960px;
  margin: 0 auto;
}

/* 제목 */
h1 {
  text-align: center;
  margin-bottom: 24px;
  font-size: 2rem;
  color: #A27B5C; /* 파스텔 브라운 */
}

/* 내비게이션 링크 */
a {
  text-decoration: none;
  color: #7DAEA3; /* 파스텔 민트 */
  margin-right: 12px;
}
a:hover {
  text-decoration: underline;
  color: #60948C;
}

/* 버튼 */
button, .btn {
  display: inline-block;
  padding: 8px 16px;
  font-size: 0.95rem;
  border: none;
  border-radius: 8px;
  background-color: #E3C9C1; /* 파스텔 핑크 */
  color: #5A4E4D;
  cursor: pointer;
  transition: background-color 0.3s;
}
button:hover, .btn:hover {
  background-color: #D3B6AE;
}

/* 표 */
table {
  width: 100%;
  border-collapse: collapse;
  margin-top: 16px;
  background-color: #FFF5E4; /* 아주 연한 살구 */
}
th, td {
  padding: 12px;
  border: 1px solid #E3C9C1;
  text-align: center;
}
th {
  background-color: #F6E8E1; /* 파스텔 살구 */
  color: #7D5A50;
}

/* 폼 */
form, .form-container {
  max-width: 600px;
  margin: 0 auto 24px auto;
  padding: 20px;
  background-color: #FEF9F5; /* 거의 흰색에 가까운 살구 */
  border: 1px solid #E3C9C1;
  border-radius: 10px;
  box-shadow: 0 2px 4px rgba(0,0,0,0.05);
}
input[type="text"],
input[type="number"],
select {
  width: 100%;
  padding: 10px;
  margin-top: 6px;
  margin-bottom: 16px;
  border: 1px solid #E3C9C1;
  border-radius: 6px;
  background-color: #FFFBF8;
  font-size: 1rem;
}
input:focus,
select:focus {
  outline: none;
  border-color: #7DAEA3; /* 포커스 시 파스텔 민트 */
}

/* 액션 링크(취소) */
.cancel {
  margin-left: 12px;
  color: #A27B5C;
}
.cancel:hover {
  color: #7D5A50;
}

🖼️ teacher-form.html

교사 등록 폼

<body>
    <h1>교사 등록</h1>
    <p>
        <a href="/">홈으로</a>
        <a href="/teachers">교사 목록</a>
    </p>
    <form th:action="@{/teachers/add}" th:object="${teacher}" method="post">
        <p><label>이름: <input type="text" th:field="*{name}" required/></label></p>
        <p>
            <button type="submit">저장하기</button>
            <a href="/teachers">취소하기</a>
        </p>
    </form>
</body>

'/' 홈으로 가는 링크, '/teachers' 교사 목록으로 가는 링크 추가
폼 태그에서
타임리프를 활용해서 th:object 로 Model의 ${teacher} 에 인풋 데이터를 필드 *{name} 으로 매핑해준다.
<button type="submit">
th:action="@{/teachers/add}" method="post" 와 함께 동작
다시 교사 목록으로 돌아가는 취소하기 링크 추가

🖼️ teacher-list.html

<body>
<h1>🧑‍🏫 교사 목록</h1>
<p>
    <a href="/">🏠 홈으로</a>
    <a href="/teachers/add">➕ 교사 등록</a>
</p>
</body>

teacher-form.html 에서 th:action=@{/teachers/add} method="post" 요청했을 때 teacher-list로 리다이렉트 잘 되는지 확인

🔍 Retrieve Teacher

🗄️ repository

데이터를 자바 객체로 바인딩 하기 위한 RowMapper

    private final RowMapper<Teacher> mapper = (resultSet, rowNum) ->
            Teacher.builder()
                    .id(resultSet.getInt("id"))
                    .name(resultSet.getString("name"))
                    .build();

    public List<Teacher> findAll() {
        return jdbcTemplate.query("SELECT * FROM teacher ORDER BY name", mapper);
    }

findAll : jdbc sql로 SELECT * FROM teacher ORDER BY name 로 row를 mapper에 넘겨준다.
RowMapper 가 resultSet으로 데이터 row를 Teacher 객체에 바인딩

× query로 넘겨받은 row 수만큼 반복
builder 를 쓰지 않으면 :

private final RowMapper<DailySales> dailySalesRowMapper = (resultSet, rowNum) ->
       new DailySales(
               resultSet.getDate("sale_date").toLocalDate(),
               resultSet.getBigDecimal("total_amount"),
               resultSet.getInt("order_count")
       );

📡 controller

/teachers 로 들어가면 Model에 teacherRepository.findAll()로 받아온 List<Teacher>를 담아 클라이언트에 보낸다.

@Controller
@RequestMapping("/teachers")
@RequiredArgsConstructor
public class TeacherController {
    private final TeacherRepository teacherRepository;

    @GetMapping
    public String list(Model model) {
        model.addAttribute("teachers", teacherRepository.findAll());
        return "teacher-list";
    }
}

🖼️ teacher-list.html

<body>
<h1>🧑‍🏫 교사 목록</h1>
<p>
    <a href="/">🏠 홈으로</a>
    <a href="/teachers/add">➕ 교사 등록</a>
</p>
<table>
    <thead>
    <tr>
        <td>ID</td>
        <td>이름</td>
        <td>액션</td>
    </tr>
    </thead>
    <tbody th:each="teacher: ${teachers}">
    <tr>
        <td th:text="${teacher.id}"></td>
        <td th:text="${teacher.name}"></td>
        <td>
            <a th:href="@{'/teachers/edit/' + ${teacher.id}}">수정</a>
        </td>
    </tr>
    </tbody>
</table>
</body>

<tbody th:each="teacher: ${teachers}">
Model에서 받아온 teachers (List<Teacher>)에서 하나씩 받아 tr에 매핑

✏️ Edit Teacher

🗄️ repository

public Teacher findById(int id) {
    return jdbcTemplate.queryForObject(
    	"SELECT * FROM teacher WHERE id=?", 
        mapper, 
        id);
//        하나 찾을때는 queryForObject 쓰고 바인딩은 세번재 arg부터
}

public int <update(Teacher teacher) {
    return jdbcTemplate.update(
            "UPDATE teacher SET name = ? WHERE id = ?",
            teacher.getName(), 
            teacher.getId()
    );
}

findById : 편집할 객체를 db에서 찾기 위한 id 인덱스 제공
컨트롤러에서 넘겨주는 teacher 에서 getName, getId 해서 데이터 덮어쓰기

📡 controller

@GetMapping("/edit/{id}")
public String editForm(@PathVariable int id, Model model) {
    model.addAttribute("teacher", teacherRepository.findById(id));
    return "teacher-form";
}

@PostMapping("/edit")
public String edit(@ModelAttribute Teacher teacher) {
    teacherRepository.update(teacher);
    return "redirect:/teachers";
}

editForm : 클라이언트가 /edit/{id} 로 들어오면 findById로 Teacher 객체 받아서 Model로 teacher-form.html에 넘기게끔 정의

🖼️ teacher-form.html

<form th:action="${teacher.id} == null ? @{/teachers/add} : @{/teachers/edit}" th:object="${teacher}" method="post">
        <input type="hidden" th:field="*{id}">
        <p><label>이름: <input type="text" th:field="*{name}" required/></label></p>
        <p>
            <button type="submit">저장하기</button>
            <a href="/teachers">취소하기</a>
        </p>
    </form>

아까 teacher-form 교사 추가 폼 재사용 할것이므로 삼항연산자를 이용해서 action 수정해준다.
th:object로 Model 넘길준비
edit을 위해 인풋 히든으로 *{id} 필드 값 전달
인풋으로 *{name}도 전달

📡 controller

@PostMapping("/edit")
public String edit(@ModelAttribute Teacher teacher) {
    teacherRepository.update(teacher);
    return "redirect:/teachers";
}

edit : 클라이언트에서 Model에 th:object="${teacher}" Teacher 넘기고 있으므로 @ModelAttribute로 받아와서 repository update

🗑️ Delete Teacher

🗄️ repository

public int delete(int id) {
    return jdbcTemplate.update(
            "DELETE FROM teacher WHERE id = ?",
            id
    );
}

데이터 내용에 관계없이 id에 맞는 데이터 삭제만 하면 되므로 간단하게 id로 delete 쿼리 실행

📡 controller

@GetMapping("/delete/{id}")
public String delete(@PathVariable int id) {
    teacherRepository.delete(id);
    return "redirect:/teachers";
}

db로 전달할 데이터 같은건 없으므로 (인덱스 제외) Get 방식으로 delete 처리만 하고 리다이렉트 하면 알아서 teachers로 넘어가서 teacher-list.html 반환한다.

🖼️ teacher-list.html

<a th:href="@{'/teachers/edit/' + ${teacher.id}}">수정</a>
            <a th:href="@{'/teachers/delete/' + ${teacher.id}}">삭제</a>

간단히 수정 옆에 링크 달아줬다

byo

🗂️ hamstern

이전 포스트

🐯[TIL] 250703-024

다음 포스트

🐯[TIL] 250704-025

[TIL] 🐯멋쟁이사자처럼

💫 Lombok

✔️ 왜 Lombok을 사용하는가?

✔️ Lombok 라이브러리 주요 어노테이션 활용 가이드

✅ 1. `@Getter` / `@Setter`

✅ 2. `@NoArgsConstructor` / `@AllArgsConstructor`

✅ 3. `@RequiredArgsConstructor`

✅ 4. `@ToString`

✅ 5. `@EqualsAndHashCode`

✅ 6. `@Data`

✅ 7. `@Builder`

☑️ 8. 실전 팁

📝 실습 : 교사, 학생 CRUD

💫 DB Table 구성

🌐 HTTP 메서드

💫 Spring

✔️ Teacher, Student CRUD

➕ Add Teacher

🔍 Retrieve Teacher

✏️ Edit Teacher

🗑️ Delete Teacher

🐯[TIL] 250703-024

🐯[TIL] 250707-026

0개의 댓글

🐯[TIL] 250704-025

[TIL] 🐯멋쟁이사자처럼

💫 Lombok

✔️ 왜 Lombok을 사용하는가?

✔️ Lombok 라이브러리 주요 어노테이션 활용 가이드

✅ 1. @Getter / @Setter

✅ 2. @NoArgsConstructor / @AllArgsConstructor

✅ 3. @RequiredArgsConstructor

✅ 4. @ToString

✅ 5. @EqualsAndHashCode

✅ 6. @Data

✅ 7. @Builder

☑️ 8. 실전 팁

📝 실습 : 교사, 학생 CRUD

💫 DB Table 구성

🌐 HTTP 메서드

💫 Spring

✔️ Teacher, Student CRUD

➕ Add Teacher

🔍 Retrieve Teacher

✏️ Edit Teacher

🗑️ Delete Teacher

🐯[TIL] 250703-024

🐯[TIL] 250707-026

0개의 댓글

✅ 1. `@Getter` / `@Setter`

✅ 2. `@NoArgsConstructor` / `@AllArgsConstructor`

✅ 3. `@RequiredArgsConstructor`

✅ 4. `@ToString`

✅ 5. `@EqualsAndHashCode`

✅ 6. `@Data`

✅ 7. `@Builder`