الرئيسية / Enterprise / معاملة JPA اليدوية مقابل @Transactional التصريحية
Enterprise متوسط

معاملة JPA اليدوية مقابل @Transactional التصريحية

استبدل كتل begin/commit/rollback المطوّلة بتعليق توضيحي @Transactional واحد.

مقارنة الكود
✕ 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);
    }
}
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🗑️

لا كليشيه

تعليق توضيحي واحد يستبدل كتل try-catch المتكررة لـ begin/commit/rollback.

🛡️

تراجع أكثر أماناً

الحاوية تضمن التراجع عن الاستثناءات غير المفحوصة — لا خطر نسيان كتلة catch.

📐

تحكم تصريحي

قواعد الانتشار والعزل والتراجع مُعبَّر عنها كسمات تعليق توضيحي.

الأسلوب القديم
معاملة يدوية
الأسلوب الحديث
@Transactional
منذ JDK
11
الصعوبة
متوسط
دعم JDK
معاملة JPA اليدوية مقابل @Transactional التصريحية
متاح

متاح على نطاق واسع منذ Jakarta EE 8 / Java 11

كيف يعمل

تتطلب إدارة المعاملات اليدوية استدعاءات صريحة لـ begin() و commit() و rollback() مغلّفةً في كتل try-catch — كل دالة خدمة تكرر هذه الكليشيهات. يفوّض التعليق التوضيحي @Transactional إدارة دورة الحياة إلى الحاوية: تبدأ معاملةً قبل الدالة وتُودعها عند النجاح وتتراجع عنها عند RuntimeException تلقائياً.

توثيق ذو صلة
Jakarta Transactions Specification ↗ Jakarta Transactions 2.0 API ↗
أنماط ذات صلة
Enterprise متوسط

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());
    }
}
مرر للرؤية الحديث ←
JDK 11+ →
Enterprise متوسط

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();
}
مرر للرؤية الحديث ←
JDK 11+ →
Enterprise متوسط

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);
}
مرر للرؤية الحديث ←
JDK 21+ →
مشاركة 𝕏 🦋 in ⬡