Strona główna / Enterprise / Ręczna transakcja JPA kontra deklaratywna @Transactional
Enterprise Średniozaawansowany

Ręczna transakcja JPA kontra deklaratywna @Transactional

Zastąp rozwlekłe bloki begin/commit/rollback pojedynczą adnotacją @Transactional.

Porównanie kodu
✕ Java EE 
@PersistenceContext
EntityManager em;

public void transferFunds(Long from, Long to,
                          BigDecimal amount) {
    EntityTransaction tx = em.getTransaction();
    tx.begin();
    try {
        Account src = em.find(Account.class, from);
        Account dst = em.find(Account.class, to);
        src.debit(amount);
        dst.credit(amount);
        tx.commit();
    } catch (Exception e) {
        tx.rollback();
        throw e;
    }
}
✓ Jakarta EE 8+ 
@ApplicationScoped
public class AccountService {
    @PersistenceContext
    EntityManager em;

    @Transactional
    public void transferFunds(Long from, Long to,
                              BigDecimal amount) {
        var src = em.find(Account.class, from);
        var dst = em.find(Account.class, to);
        src.debit(amount);
        dst.credit(amount);
    }
}
Widzisz problem z tym kodem? Daj nam znać.
Dlaczego nowoczesne podejście wygrywa
🗑️

Bez boilerplate

Jedna adnotacja zastępuje powtarzające się bloki try-catch begin/commit/rollback.

🛡️

Bezpieczniejsze wycofanie

Kontener gwarantuje wycofanie przy wyjątkach unchecked — bez ryzyka zapomnienia bloku catch.

📐

Deklaratywna kontrola

Propagacja, izolacja i reguły wycofania są wyrażone jako atrybuty adnotacji.

Stare podejście
Ręczna transakcja
Nowoczesne podejście
@Transactional
Od JDK
11
Poziom trudności
Średniozaawansowany
Wsparcie JDK
Ręczna transakcja JPA kontra deklaratywna @Transactional
Dostępne

Szeroko dostępne od Jakarta EE 8 / Java 11

Jak to działa

Ręczne zarządzanie transakcjami wymaga jawnych wywołań begin(), commit() i rollback() opakowanych w bloki try-catch — każda metoda serwisu powtarza ten boilerplate. Adnotacja @Transactional deleguje zarządzanie cyklem życia do kontenera — rozpoczyna transakcję przed metodą, zatwierdza przy sukcesie i automatycznie cofa przy RuntimeException.

Powiązana dokumentacja
Jakarta Transactions Specification ↗ Jakarta Transactions 2.0 API ↗
Dowód
Zobacz źródło dowodu ↗
Powiązane wzorce
Enterprise Średniozaawansowany

EJB versus CDI

Java EE
@Stateless
public class OrderEJB {
    @EJB
    private InventoryEJB inventory;

    public void placeOrder(Order order) {
        // container-managed transaction
        inventory.reserve(order.getItem());
    }
}
Jakarta EE 8+
@ApplicationScoped
public class OrderService {
    @Inject
    private InventoryService inventory;

    @Transactional
    public void placeOrder(Order order) {
        inventory.reserve(order.getItem());
    }
}
Najedź, aby zobaczyć nową wersję ➜
JDK 11+ →
Enterprise Średniozaawansowany

JDBC versus JPA

Java EE
String sql = "SELECT * FROM users WHERE id = ?";
try (Connection con = dataSource.getConnection();
     PreparedStatement ps =
             con.prepareStatement(sql)) {
    ps.setLong(1, id);
    ResultSet rs = ps.executeQuery();
    if (rs.next()) {
        User u = new User();
        u.setId(rs.getLong("id"));
        u.setName(rs.getString("name"));
    }
}
Jakarta EE 8+
@PersistenceContext
EntityManager em;

public User findUser(Long id) {
    return em.find(User.class, id);
}

public List<User> findByName(String name) {
    return em.createQuery(
        "SELECT u FROM User u WHERE u.name = :name",
        User.class)
        .setParameter("name", name)
        .getResultList();
}
Najedź, aby zobaczyć nową wersję ➜
JDK 11+ →
Enterprise Średniozaawansowany

JPA versus Jakarta Data

Jakarta EE 8+
@PersistenceContext
EntityManager em;

public User findById(Long id) {
    return em.find(User.class, id);
}

public List<User> findByName(String name) {
    return em.createQuery(
        "SELECT u FROM User u WHERE u.name = :name",
        User.class)
        .setParameter("name", name)
        .getResultList();
}

public void save(User user) {
    em.persist(user);
}
Jakarta EE 11+
@Repository
public interface Users extends CrudRepository<User, Long> {
    List<User> findByName(String name);
}
Najedź, aby zobaczyć nową wersję ➜
JDK 21+ →