## Genel Bakış
`@SQLDelete` ve `@SQLUpdate`, Hibernate tarafından sağlanan ve özel SQL ifadeleriyle silme ve güncelleme işlemlerini tanımlamak için kullanılan anotasyonlardır. Bu anotasyonlar, varsayılan JPA davranışını özelleştirmek ve daha karmaşık veya özel işlemler gerçekleştirmek için kullanılır.
## @SQLDelete
### Tanım ve Amaç
`@SQLDelete`, bir entity silindiğinde çalıştırılacak özel bir SQL ifadesi tanımlar. Bu, özellikle "soft delete" (yumuşak silme) senaryolarında kullanışlıdır.
### Kullanımı
```java
import org.hibernate.annotations.SQLDelete;
import org.hibernate.annotations.Where;
@Entity
@SQLDelete(sql = "UPDATE users SET deleted = true WHERE id = ?")
@Where(clause = "deleted = false")
public class User {
@Id
private Long id;
private String name;
private boolean deleted = false;
// Diğer alanlar ve metodlar
}
```
### Avantajları
1. **Soft Delete İmkanı**: Kayıtları fiziksel olarak silmek yerine, mantıksal olarak silinmiş olarak işaretleyebilirsiniz.
2. **Veri Bütünlüğü**: Silinen verileri koruyarak, gerektiğinde geri getirme imkanı sağlar.
3. **Özelleştirilmiş Silme Mantığı**: Standart DELETE sorgusunun ötesinde karmaşık silme işlemleri gerçekleştirebilirsiniz.
## @SQLUpdate
### Tanım ve Amaç
`@SQLUpdate`, bir entity güncellendiğinde çalıştırılacak özel bir SQL ifadesi tanımlar. Bu, standart UPDATE sorgusunun yetersiz kaldığı durumlarda kullanışlıdır.
### Kullanımı
```java
import org.hibernate.annotations.SQLUpdate;
@Entity
@SQLUpdate(sql = "UPDATE products SET last_updated = CURRENT_TIMESTAMP, price = ?, stock = ? WHERE id = ?")
public class Product {
@Id
private Long id;
private BigDecimal price;
private int stock;
private LocalDateTime lastUpdated;
// Diğer alanlar ve metodlar
}
```
### Avantajları
1. **Özelleştirilmiş Güncelleme Mantığı**: Standart JPA güncelleme davranışının ötesinde karmaşık güncelleme işlemleri yapabilirsiniz.
2. **Otomatik Alan Güncellemeleri**: Örneğin, her güncelleme işleminde otomatik olarak zaman damgası ekleyebilirsiniz.
3. **Veritabanı Seviyesinde İşlemler**: Veritabanı fonksiyonları veya hesaplamaları doğrudan SQL içinde kullanabilirsiniz.
## Dikkat Edilmesi Gerekenler
1. **Performans**: Özel SQL ifadeleri, bazı durumlarda Hibernate'in optimizasyonlarını bypass edebilir.
2. **Bakım**: SQL ifadeleri entity sınıflarında gömülü olduğundan, bakımı zorlaşabilir.
3. **Veritabanı Bağımlılığı**: Özel SQL ifadeleri genellikle belirli bir veritabanı sistemine özgüdür, bu da taşınabilirliği etkileyebilir.
4. **Tutarlılık**: Entity'nin Java tarafındaki durumu ile veritabanındaki durumu arasında tutarsızlıklar oluşmamasına dikkat edilmelidir.
## En İyi Kullanım Pratikleri
1. Bu anotasyonları sadece gerektiğinde kullanın; standart JPA davranışı çoğu durumda yeterlidir.
2. Soft delete senaryoları için `@SQLDelete` ve `@Where` anotasyonlarını birlikte kullanın.
3. SQL ifadelerini parametrize edin ve SQL enjeksiyon saldırılarına karşı koruma sağlayın.
4. Bu anotasyonları kullanan entity'lerin davranışlarını kapsamlı bir şekilde test edin.
5. Veritabanı taşınabilirliği önemliyse, veritabanı-agnostik SQL ifadeleri kullanmaya çalışın.
## Sonuç
`@SQLDelete` ve `@SQLUpdate` anotasyonları, JPA ve Hibernate'in sunduğu güçlü özelleştirme araçlarıdır. Doğru kullanıldıklarında, karmaşık iş gereksinimlerini ele almanıza ve veritabanı işlemleriniz üzerinde daha fazla kontrol sağlamanıza olanak tanırlar. Ancak, bu gücün sorumluluğu da beraberinde geldiğini unutmamak önemlidir; bu anotasyonları dikkatli bir şekilde ve sadece gerektiğinde kullanın.