Spring Data JPA를 사용한 기본 데이터 쿼리

 

Spring Data JPA는 데이터베이스와의 상호작용을 간소화하고 효율적인 쿼리를 작성할 수 있도록 도와주는 강력한 ORM 도구입니다. 기본적인 CRUD(Create, Read, Update, Delete) 작업은 물론, 복잡한 쿼리도 쉽게 작성할 수 있도록 다양한 기능을 제공합니다. 이번 글에서는 Spring Data JPA의 기본 개념, 주요 기능, 그리고 예제 코드를 통해 실전 활용 방법을 알아보겠습니다.

---

1. Spring Data JPA란 무엇인가?

Spring Data JPA는 JPA(Java Persistence API)의 상위 추상화 도구로, 개발자가 데이터 액세스 계층을 더욱 쉽고 간결하게 구현할 수 있도록 돕습니다.
주요 특징:

• 리포지토리 인터페이스 기반: DAO(Data Access Object) 클래스를 직접 작성할 필요 없이 인터페이스 선언만으로 CRUD 작업이 가능합니다.
• 자동 생성 쿼리: 메서드 이름에 따라 동적으로 쿼리를 생성합니다.
• 커스텀 쿼리 지원: JPQL(Java Persistence Query Language) 또는 네이티브 SQL로 복잡한 쿼리를 정의할 수 있습니다.

---

2. Spring Data JPA의 기본 동작 원리

Spring Data JPA는 JpaRepository 인터페이스를 확장하여 데이터베이스 작업을 처리합니다. 이때, 인터페이스 메서드 이름에 따라 적절한 SQL 쿼리가 자동 생성됩니다.

public interface UserRepository extends JpaRepository<User, Long> {
    // 기본 메서드 제공: save, findAll, findById, delete 등
}

위 예제에서 UserRepository는 JpaRepository를 상속받아 자동으로 CRUD 메서드를 제공합니다.

---

3. Spring Data JPA 기본 예제

3.1 엔터티 클래스 정의

먼저, 데이터베이스 테이블과 매핑되는 엔터티(Entity) 클래스를 작성합니다.

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @Column(unique = true)
    private String email;

    // 기본 생성자 및 Getter/Setter
    public User() {}
    public User(String name, String email) {
        this.name = name;
        this.email = email;
    }

    // Getter and Setter 생략 가능 (Lombok 사용 시)
}

3.2 리포지토리 생성

리포지토리 인터페이스를 정의합니다.

public interface UserRepository extends JpaRepository<User, Long> {
    // 이름으로 사용자 검색
    List<User> findByName(String name);

    // 이메일로 사용자 검색
    Optional<User> findByEmail(String email);

    // 특정 이름 패턴으로 사용자 검색
    List<User> findByNameContaining(String keyword);
}

---

4. Spring Data JPA 사용 예제

4.1 데이터 삽입

사용자를 데이터베이스에 저장하는 예제입니다.

@RestController
@RequestMapping("/users")
public class UserController {
    private final UserRepository userRepository;

    public UserController(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userRepository.save(user);
    }
}

---

4.2 데이터 조회

(1) 전체 사용자 조회

@GetMapping
public List<User> getAllUsers() {
    return userRepository.findAll();
}

(2) 이름으로 사용자 검색

@GetMapping("/search")
public List<User> findByName(@RequestParam String name) {
    return userRepository.findByName(name);
}

(3) 이메일로 사용자 검색

@GetMapping("/{email}")
public User findByEmail(@PathVariable String email) {
    return userRepository.findByEmail(email).orElseThrow(() -> new RuntimeException("User not found"));
}

---

4.3 데이터 업데이트

Spring Data JPA는 기본적으로 save 메서드를 통해 저장과 업데이트를 처리합니다.

@PutMapping("/{id}")
public User updateUser(@PathVariable Long id, @RequestBody User updatedUser) {
    User user = userRepository.findById(id).orElseThrow(() -> new RuntimeException("User not found"));
    user.setName(updatedUser.getName());
    user.setEmail(updatedUser.getEmail());
    return userRepository.save(user);
}

---

4.4 데이터 삭제

deleteById 메서드를 사용하여 데이터를 삭제할 수 있습니다.

@DeleteMapping("/{id}")
public void deleteUser(@PathVariable Long id) {
    userRepository.deleteById(id);
}

---

5. Spring Data JPA 활용 시 주의점

• Lazy Loading: 연관 엔터티가 지연 로딩(Lazy Loading) 설정인 경우, 필요하지 않은 시점에서 데이터베이스에 접근해 성능 문제가 발생할 수 있습니다.
• 쿼리 최적화: 자동 생성된 쿼리가 항상 효율적이지는 않으므로 필요한 경우 JPQL 또는 네이티브 쿼리를 사용해 최적화해야 합니다.
• 트랜잭션 관리: 데이터 변경 작업은 반드시 트랜잭션이 필요하므로 서비스 계층에서 적절히 관리해야 합니다.

---

6. 결론

Spring Data JPA는 간결하고 강력한 데이터베이스 접근 방식을 제공하며, 기본적인 CRUD 작업부터 복잡한 쿼리까지 손쉽게 처리할 수 있습니다. 이 글에서 소개한 예제를 통해 실무에 바로 적용할 수 있는 기본적인 기능을 익히고, 프로젝트에 필요한 데이터를 효율적으로 관리해 보세요!