Какой метод будем использовать для вставки в Repository?

Методы вставки данных в Repository

Spring Data предоставляет несколько методов для вставки (save/persist) данных в Repository. Выбор метода зависит от сценария использования.

Основной метод: save(T entity)

save() — это универсальный метод из интерфейса CrudRepository, который используется для вставки и обновления.

public interface CrudRepository<T, ID> extends Repository<T, ID> {
    <S extends T> S save(S entity);
    <S extends T> Iterable<S> saveAll(Iterable<S> entities);
    // ...
}

Поведение:

• Если id == null → INSERT (создание новой записи)
• Если id != null → UPDATE (обновление существующей записи)

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String email;
    private String username;
}

public interface UserRepository extends CrudRepository<User, Long> {}

// Использование:
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User createUser(String email, String username) {
        User user = new User();
        user.setEmail(email);
        user.setUsername(username);
        // id будет null, поэтому выполнится INSERT
        return userRepository.save(user);
    }
    
    public User updateUser(Long id, String newEmail) {
        User user = userRepository.findById(id).orElseThrow();
        user.setEmail(newEmail);
        // id != null, поэтому выполнится UPDATE
        return userRepository.save(user);
    }
}

Метод: saveAll(Iterable<S> entities)

saveAll() — вставляет или обновляет несколько записей одновременно. Это более эффективно, чем вызывать save() в цикле.

public void createMultipleUsers(List<User> users) {
    // Вместо:
    // users.forEach(userRepository::save); // ❌ N+1 запросов
    
    // Лучше:
    userRepository.saveAll(users); // ✅ 1-2 запроса
}

Метод: persist(T entity) (JPA EntityManager)

Если используешь EntityManager напрямую, можно использовать persist() для insert.

public void insertUser(User user) {
    entityManager.persist(user); // Только INSERT
}

Отличие от save():

• persist() — только INSERT, даже если есть id
• save() — INSERT или UPDATE в зависимости от id

Метод: merge(T entity) (JPA EntityManager)

merge() — гарантирует UPDATE для существующей записи.

public void mergeUser(User user) {
    entityManager.merge(user); // Всегда UPDATE
}

Bulk операции с Query

Для массовых вставок через SQL это может быть быстрее:

public interface UserRepository extends JpaRepository<User, Long> {
    @Modifying
    @Transactional
    @Query(value = "INSERT INTO users (email, username) VALUES (?1, ?2)", 
           nativeQuery = true)
    void insertUser(String email, String username);
    
    @Modifying
    @Transactional
    @Query(value = "INSERT INTO users (email, username) VALUES (:email, :username)", 
           nativeQuery = true)
    void bulkInsert(@Param("email") String email, @Param("username") String username);
}

Метод: saveAndFlush(T entity)

saveAndFlush() — save() + немедленное написание в БД (flush).

public User createUserImmediately(User user) {
    // save() записывает в Hibernate session, но не в БД
    // saveAndFlush() записывает и в БД
    return userRepository.saveAndFlush(user);
}

Когда использовать:

• Когда нужен id сразу же
• Когда нужна точная последовательность операций
• Редко (обычно хватает save())

Batch операции

Для вставки большого количества данных рекомендуется batch:

@Configuration
public class JpaConfig {
    // hibernate.jdbc.batch_size=20
    // hibernate.order_inserts=true
    // hibernate.order_updates=true
}

public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    @Transactional
    public void bulkCreateUsers(List<User> users) {
        for (int i = 0; i < users.size(); i++) {
            userRepository.save(users.get(i));
            // Каждые 20 записей Hibernate отправит batch
            if (i % 20 == 0) {
                // entityManager.flush();
                // entityManager.clear();
            }
        }
    }
}

Сравнение методов

Best Practices

// ✅ Правильно: использовать Repository методы
public User createUser(User user) {
    return userRepository.save(user);
}

// ✅ Правильно: массовые операции
public void createUsers(List<User> users) {
    userRepository.saveAll(users);
}

// ❌ Неправильно: вставка в цикле
public void createUsers(List<User> users) {
    for (User user : users) {
        userRepository.save(user); // N+1 запросов!
    }
}

// ✅ Правильно: batch с чистой памяти
@Transactional
public void bulkCreate(List<User> users) {
    for (int i = 0; i < users.size(); i++) {
        userRepository.save(users.get(i));
        if ((i + 1) % 100 == 0) {
            entityManager.flush();
            entityManager.clear();
        }
    }
}

Итого

Для вставки в Repository используй:

• save(T) — универсальный метод (INSERT или UPDATE)
• saveAll(Iterable<T>) — массовые операции
• saveAndFlush(T) — когда нужен id сразу же
• Batch операции в properties для больших объёмов данных

Выбор между ними зависит от количества данных и требований к производительности.