Hybris’te items.xml Nedir? Basit Bir Ürün Yapısıyla Anlayalım

Hybris’le çalışmaya yeni başladıysan, kısa sürede sıkça karşına çıkacak bir dosya var: items.xml. İlk bakışta karmaşık görünse de, aslında Hybris’in veri modelini tanımladığın yerdir. Kısaca diyebiliriz ki: sistemin hangi verilerle çalışacağını belirleyen temel dosya budur.

Peki, items.xml Ne İşe Yarar?

Hybris’te her şey bir Item üzerinden yürür. Ürün, kategori, müşteri, sipariş… hepsi aslında birer item’dır. Ve bu item’ların nasıl davranacağını items.xml dosyası belirler.

Bunu bir Java sınıfı gibi düşünebilirsin sadece class yerine XML ile tanımlarsın.

Diyelim ki sistemine basit bir ürün yapısı eklemek istiyorsun. items.xml içinde şöyle bir tanım yapabilirsin:

Bu örnekte üç temel şey tanımlıyoruz:

• code → Ürünün benzersiz kodu
• name → Ürünün adı
• price → Ürünün fiyatı

Yani bu dosya Hybris’e şunu söylüyor: “Benim bir Product item tipim var. Bu item’in kod, isim ve fiyat alanları olacak. Ve bu alanlara erişebilecek, hatta arama yapabileceksin.”

Sonuçta Ne Oluyor?

Bu tanımlamayı yaptıktan sonra sistem, senin için otomatik olarak bir tablo oluşturur. Evet, veritabanında Product adında bir tablo oluşur ve bu alanlar sütun olarak eklenir. Yani items.xml, Hybris’in veri modelini şekillendirdiğin katmandır.

Bir nevi “Spring JPA + Hibernate” karışımı gibi düşünebilirsin ama Hybris’in kendi diliyle.

items.xml, yalnızca tablo tanımlamak için değil, aynı zamanda ilişkileri (relation) ve sabit değer yapılarını (enumtype) oluşturmak için de kullanılır. Örneğin:

• Bir ürün ile kategori arasında ilişki kurmak istiyorsan relation tanımı yaparsın.
• Bir sipariş durumu gibi sabit değerleri yönetmek istiyorsan enumtype tanımı kullanırsın.

Bu yazıda temele odaklandık ilişkiler ve enum yapılarını sonraki adımlarda detaylıca konuşacağız. 😉

Kısaca

items.xml, Hybris’in yapı taşlarından biridir. Bir entity tanımlamak, tablo oluşturmak veya yeni bir alan eklemek istiyorsan, ilk durağın burasıdır.

Java tarafında @Entity, @Column, @Id ile yaptığın işi burada XML formatında yaparsın.

Bir sonraki adımda, bu tanımladığın item’ları sisteme nasıl yükleyeceğini yani impex dosyalarını konuşalım mı? 😉