Bir önceki yazımızda Hybris’in ne olduğunu ve ne için kullanılabileceğine değinmiştik. Aynı zamanda Hybris’in B2C yapısına sahip e-ticaret sitesinin kurulumunu da gerçekleştirmiştik. (Bir önceki yazıya gitmek isterseniz buraya tıklayabilirsiniz.) Bu bölümde ise kendimize ait bir eklentiyi nasıl oluşturacağımızı ve bunu hybris projemize nasıl dahil edeceğimizi öğreneceğiz.

Hybris’in Dosya Yapısı

Eklenti oluşturmayı öğrenmeden önce dosyaların nerede oluştuğu nasıl oluştuğu, hangi komutların kullanılması gerektiğini açıklamak gerekiyor.

• bin ===> Bu klasörün altında sizin veya Hybris geliştiricileri tarafından geliştirilen modül, eklenti, entegrasyon veya uygulamaların bulunduğu klasördür.
• config ===> bin klasörü altında bulunan modül, eklenti, entegrasyon veya uygulamaların konfigürasyonlarını yapabileceğimiz bir klasördür. Oluşturacağımız eklentileri bu dosya altında konfigüre ederek Hybris’e dahil edeceğiz. Burası ile haşir neşir olacağımız için şuan çok üstünde durmuyorum.
• data ===> İsminden de anlaşılacağı üzere veri klasörü olarak geçmektedir. Ne tür veriler diyecek olursanız da şöyle açıklamaya çalışayım; Verilerimizin tutulduğu HSQLDB veritabanı, Solr ile dökümante ettiğimiz veriler, medya olarak sakladığımız görüntü veya herhangi bir dosya uzantılı veriyi tutabilmemizi sağlayan klasördür. İlerde şöyle bir soru sorabilirsiniz “Bu var olan verilerin tutulduğu veritanabını görmek istiyorum nerede bu?” bunun cevabı bu klasörün altında olacaktır.
• log ===> Hybris platformunda veya JDBC ile ilgili oluşan hata, bilgilendirme veya uyarı mesajların tutulduğu klasördür.
• roles ===> Proje ilk oluşturulduğunda boş olarak gelmektedir ancak daha sonra roller oluşturulduğunda buraya o roller ile ilgili klasörler ve dosyalar oluşmaktadır.
• temp ===> ant all komutu ile oluşan geçici dosyaların tutulduğu klasördür.

Hybris dosyalarını kabataslak tanıdığımıza göre eklenti nedir ve nasıl oluşturulur aşamasına geçebiliriz. Eğer detaylı olarak hybris klasörlerini incelemek isterseniz buradan erişebilirsiniz.

Eklenti Nedir ve Nasıl Oluşturulur?

Eklentiyi tek kelime ile açıklamak hem kafa karışıklığına hemde ne olduğunu anlamakta sorun yaratacağından maddeler halinde eklentiler ile neler yapılabileceğini yazmayı tercih ettim ama özetle şöyle diyebilirim; hybris platformunu genişletmek amacıyla kullanılan program parçacıklarıdır.

• Hybris projesinde var olan program parçacıklarını değiştirmek için kullanılabilir. (hybriste var olan eklentinin ezilmesi ile oluşturulan eklenti tipleridir.)
• Hybris tarafından sunulmayan yapılar oluşturmak için kullanılabilir.(tamamen geliştirici tarafından geliştirilen eklentilerdir.)
• İki farklı yazılım arasında entegrasyon sağlamak için kullanılabilir.(Entegre olunacak olan yapı ile koordineli olarak geliştirilen eklentilerdir.)

Eklentinin en önemli özellği projeden rahatlıkla çıkarılabilir ve tekrar takılabilir olmasıdır. (Burada iş yazılımcı tarafına düşüyor ve eklentinin bu amaçla geliştirilmesi gerektiğini bilmesi gerekiyor. Bu yüzden bağımlılıklara dikkat edip ona göre geliştirmesine yapmalıdır.) Eklenti projeden çıkarıldığı zaman herhangi ek bir geliştirme yapılmadan projenin eski yapısıyla çalışması mümkün olabilmelidr aksi taktirde iyi geliştirilen bir eklenti değildir.

Eklenti kavramını anladığımıza göre şimdi eklenti oluşturalım; Öncelikle hybris platformumuzun kapalı halde olması gerekiyor böylece oluşturacağımız eklentiyi ekledikten sonra ant komuları ile tekrardan derleyip dosyaları oluşturduktan sonra başlatabileceğiz.

. ./setantenv.sh
ant extgen

Yukarıdaki komutlar çalıştırıldıktan sonra karşımıza aşağıdaki gibi bir ekran çıkıyor.

Yukarıda bulunan resimde kırmızı ile işaretli olan kısım varsayılan olarak seçilmiş eklenti şablonunu göstermektedir, siz doğrudan enter tuşuna basarsanız bu eklenti şablonundan yeni bir eklenti oluşturmaya başlayacaktır. Sarı ile işaretli olan kısımlar ise hybris’in sizin için işe yarayacağını düşündüğü diğer eklenti şablonlarıdır. Biz şimdilik basit bir yapı ile ilerleyeceğimiz için varsayılan şablon ile devam ediyoruz.

Enter tuşuna bastıktan sonra yukarıdaki resimde kırmızı ile işaretlenmiş kısımda eklentimize isim vermek için bizden bir isim bekliyor, ben eklentinin ismini hellohybris diye koyuyorum.(Eklentilere isim verilirken dikkat edilmelidir, oluşturulan bir eklentinin ismini değiştirmek oldukça zordur.) İsmi verdikten sonra enter tuşuna basıp devam ediyoruz.

Şimdide oluşturduğunuz eklenti için paket ismi vermemizi istiyor, ben com.ugurhalil.hellohybris diye koyuyorum.

Paket ismi girildikten sonra eklenti oluşturma işlemini bitirmiş oluyoruz. Son gelinen ekranda size bu eklentinin nerede oluşturulduğu ve nasıl sisteme dahil edileceğinin bilgisini vermektedir.

Oluşturulan Eklentinin Projeye Dahil Edilmesi

İlk adımda “<exten…” ile başlayan ifadeyi localextensions.xml dosyasına eklemenizi istiyor. Burada küçük bir noktaya değinmek istiyorum, size verilen “<extension dir=”/home/halilugur….. “ ifadesi, eklentinin bilgisayardaki tam dizinini belirterek veriyor. Bunun nedeni aynı isme sahip iki eklenti var ise birbirleri ile karışmasını önlemek amacı ile yapıyor, eğer o isimde sadece birtane eklentiniz var ise aşağıdaki şekilde kullanılması localextensions.xml dosyasının okunaklığı açısından daha verimli olacaktır. Örnek kullanım;

<extension name='hellohybris' />

Eklentiyi localextensions.xml dosyasına ekledikten sonra aşağıda bulunan tek satırlık komutu çalıştırıyoruz.

hybrisProject/hybris/bin/platform klasörün altına giderek;

. ./setantenv.sh && ant clean all && ./hybrisserver.sh debug

İşlemler bittikten sonra tarayıcınızı açıp aşağıdaki url’yi girin;

https://electronics.local:9002/hellohybris/

Hybris platformunu bir önceki yazımızda ant initialize çekerek hazır hale getirmiştik. Bu yüzden yeni eklediğimiz eklentinin logosu hybris tarafında oluşmadığı için arka tarafta hata fırlatıyor ve eklentimizin açılmamasına neden oluyor.

Yukarıda bulunan resimdeki gibi bir hata alıyorsanız platformunuza ant initialize çekin daha sonra tekrar denediğinizde böyle bir sorun ile karşılaşmadığınızı göreceksiniz.

Platformu sıfırladıktan sonra tekrar url’yi test ettiğimizde karşımıza aşağıdaki gibi bir görüntü çıkmasını bekliyoruz.

Eklentimiz artık özelleştirilebilir ve özellik eklenebilir duruma geldi. Son olarak eklentimizin dosya yapısına da göz atalım ve bu yazıyı sonlandıralım.

Eklentimizi bin/custom klasörü altında bulabiliriz. Bu klasör bizim oluşturuduğumuz eklentilerin veya ezdiğimiz hybris eklentilerin yer aldığı klasördür.

• classes ===> derlenen java dosyaların bulunduğu klasördür.
• gnsrc ===> hybris tarafından otomotik oluşturulan dosyaların bulunduğu klasördür.
• lib ===> eklentimize ekstradan eklemek istediğimiz kütüphanlerin klasörüdür.
• resources ===> Kaynakların oluşturulduğu klasördür.
• src ===> Java dosyaların bulunduğu klasördür.
• testsrc ===> Oluşturduğumuz java sınıflarının test sınıflarını yazdığımız klasördür.
• web ===> eklentimizin bir arayüzü var ise arayüzün geliştirilebilmesini sağlayan klasördür.
• .externalToolBuilders ve .settings ===> eclipse ile ilgili klasörlerdir.

Klasör altında bulunan dosyaları daha sonra detaylı bir şekilde inceleyeceğiz ve her birinin ne işe yaradığına değineceğiz. Şimdilik hoşçakalın esenle kalın.

Bir sonraki hybris yazısında görüşmek üzere.

The post Hybris Dosya Yapısı, Extension Oluşturma: Bölüm 2 appeared first on Halil UĞUR.

Hybris nedir sorusuna standart cevaplara karşın kendi anladığım ve üzerinde nelerin inşa edilebileceği bilgisini içerebilecek bir yazı yazmayı hedefledim. Keyifli okumalar.

Hybris Nedir?

Hybris 1997’de ilk olarak ürün içerik yönetim sistemi yapısıyla ortaya çıkmış ve daha sonra çok kanallı ticaret, veri yönetimi, mobil ticaret ve e-ticaret danışmanlığı olarak genişlemeye devam etmiş bir platformdur. (Detaylı wiki sayfası için buraya tıklayın. Hybris’in kendi wiki sayfası için buraya tıklayın. SAP üyeliğinizin olması gerekir.)

Hybris platformun kendisini anlatmandan önce platformun ne anlamda kullanıldığına değinmek istiyorum: Farklı teknoloji ve yazılımların bir araya gelerek oluşturdukları yazılım topluluğu diyebiliriz. (Frameworks, Softwares, Libraries, Servers vs..)

“Hybris neden bir platformdur” diyecek olursakta sebebi şu: İçinde birden çok teknolojiyi barındırması yanı sıra hybris ekibinin özel olarak geliştirdiği sistemler de mevcuttur, içerisinde framework ve kübütpahnelerin dışında bağımsız yazılımlar da barındırıyor aynı zamanda içinde barındırdığı bu yazılım ve eklentileri kontrol edebileceğimiz yapılarda mevcut, bu sepeble hybris bir yazılımdır demek diğer teknolojileri yok saymak diyebilriz bu yüzden bir platform demek daha doğru olacaktır.

Hybris platformu yaygın olarak e-ticaret üzerinde kurulmuştur, e-ticaret sistemi dışında, ister bir blog sitesi yaparsınız, ister kişi yönetim sistemi yaparsınız isterseniz de sadece onay sistemi barındıran bir yapı kurarsınız tamamen size kalmış. Hybris nedir sorusuna cevaben en iyi cevap şöyle verebilirim; siz yazılımsal olarak ne isterseniz onu yapabilirsiniz.

Hybris Kurulumu

Hybrisin ne olduğunu bildiğimize göre artık hybris uzmanıyız :P, şimdi biraz görsel biraz da kod ile nasıl kurulur onu anlatayım. Kurulumu Linux işletim sistemi üzerinde yapacağım.

• Öncelikle buradan hybris’i indiriyoruz, büyük ihtimalle indiremeyenler olacaktır, bunun sebebi ya yetkiniz yoktur ya da SAP üyesi değilsiniz. Ne yetkim var ne de SAP üyeliğim var diyorsanızda biraz github üzerinden araştırma yapmanızı tavsiye ederim birşeyler bulacaksınız. 🙂
• Dosyayı indirdiniz aşağıdaki bir klasör yapısı ile karşılaşmanız lazım. (veya github üzerinden bulduysanız.)

• Dosyaları olduğu gibi bir klasöre çıkartıyoruz, ismi hybrisProject olabilir.
• Kuruluma başlamadan önce üzerinde çalıştığımız hybris sürümünü öğrenmek için; hybrisProject/installer/version dosyasını herhangi bir edidör ile açıyoruz. Benim şuan çalıştığım sürüm 18.11.0-M13 versiyonu olarak geçiyor.
• Java’nın 1.8 sürümü ile uyumlu çalışmaktadır, Hybris’in yukarıdaki verisyonundan sonrakiler Java 11 desteklemektedir.
• Kuruluma başlamak için installer/ dosyasındayken bir komut penceresi açıyoruz.

./install.sh -r b2c_acc -A local_property:initialpassword.admin=nimda

• Komutlar;
  • ./install.sh ===> kurulum dosyasını bulup kopayalanacak olan dosyaların hedeflerine kopyalanmasını başlatan batch dosyası.
  • -r ===> installer dosyasının altında bulunan recipes klasörünü işaret etmektedir.
  • b2c_acc ===> recipes klasörünün altında bulunan ve kurulması istenen yapıyı işaret etmektedir.
  • -A local_property:initialpassword.admin=nimda ===> sistemin tamamen kurulumu bittiğinde başlangıç olarak admin şifresini belirlemek amacı ile kullanılmaktadır, daha önceki hybris sürümlerinde böyle bir komut girmenize gerek yoktu ve doğrudan admin şifresi nimda olarak belirlenirdi.
  • Siz hybrisin eski bir versiyonunu bulduysanız şu komutu girmeniz yeterli olacaktır; ./install.sh -r b2c_acc
• Yukarıdaki komut sizin indirdiğiniz hybris projesinde yer alan yapılardan biri olan B2C yapısı, yani Business to Customer yapısını kurmuş olacağız. B2C, B2B veya Marketplace gibi birbirinden farklı yapılar hybris içerisinde mevcut ve bunların hangi amaçla ne için kullanıldığı SAP sitesinden veya internet üzerinden küçük bir araştırma yaparak bulabilirsiniz. (Örnek araştırma; what’s the difference between b2b and b2c marketing)
• Yukarıdaki komutu çalıştırdıktan sonra herhangi bir sorun ile karşılaşmamanız gerekiyor. Aşağıdaki gibi bir çıktı almanızı bekliyorum.

Bir sorun ile karşılaşırsanız lütfen yorum yapın elimden geldiğince yardım etmeye çalışırım.

Hybris’i Çalıştıralım

• Kurulum işlemi tamamlandıktan sonra komut penceresinden hybrisProject/hybris/bin/platform altına giderek sırası ile;

. ./setantenv.sh
ant clean
ant all
ant initialize
./hybrisserver.sh debug

• Komutlar;
  • . ./setantenv.sh ===> Apache ant kütüphanesini aktif edebilmek için kullanılan bir batch dosyası. Apache Ant ile ilgili detaylı bilgiye buradan ulaşabilirsini.
  • ant clean ===> Daha önce derlenmiş veya alt eklentilerden ana eklentilere kopyalanmış dosyaların tamamını temizlemek için kullanılan bir komuttur. (Hangi dosyalar derseniz java, properties, jsp, css, js vs….)
  • ant all ===> Bütün dosyaların derlenmesini ve kopyalanmasını sağlayan komuttur. (Hangi dosyalar olduğunu biliyorsunuz.)
  • ant initialize ===> Bütün dosyaları temizledik ve tekrardan en güncel halleri ile oluşturduk, şimdi platformun hazırlanması gerekiyor. initialize komutu çalıştırıldığında veritabanını basit veriler ile doldurarak bizim için hazır hale getirmesini sağlıyor.
  • ./hybrisserver.sh debug ===> Platform tamamen hazır hale geldikten sonra bu komut ile platformu başlatıyoruz ve lolcalde hybris platformunu çalıştırmış oluyoruz. Yanındaki debug kelimesini eklemek zorunda değilsiniz eğer bunu eklerseniz java üzerinde debugging işlemi yapabilmenizi sağlayacaktır. (Debug nedir bilmiyorsanız; what is debug in java veya what is mean debug (google amca direk size bilgi veriyor ne olduğu ile ilgili))
• Komutların ne olduğunu anladığımıza göre şimdi herbir komutu sırasıyla çalıştıracağım ve tek tek ekran görüntüsünü paylaşacağım.

Bütün komutlar sağlıklı bir şekilde çalıştıysa ve herhangi bir sorunla karşılaşmadıysanız platformunuz ayakta demektir, yani şuan hybris server’ı çalışıyor durumda olması lazım. Sitemizi görmek için son bir ayar yaparak bu yazımı sonlandıracağım.

Host Konfigürasyonu

Yeni bir komut penceresi açın ve hemen aşağıdaki komutu girin;

sudo nano /etc/hosts

Resimde işaretlediğim kısma electronics.local ifdesini ekleyin ve kaydedin. Böylece hybris’te default olarak tanımlanmış olan web siteye erişebiliyor olacağız.

https://electronics.local:9002/yacceleratorstorefront/electronics/en/

Yukarıdaki linke tıklayarak localinizde kaldırmış olduğunuz web site arayüzüne erişebilirsiniz.

Dilim döndüğünce anlatmaya ve açık bir şekilde aktarmaya çalıştırm eksik veya bir hatam var ise affola.

Bir sonraki hybris yazısında görüşmek üzere.

The post Hybris Nedir ve Nasıl Kurulur : Bölüm 1 appeared first on Halil UĞUR.