Reclazz ile SAP Commerce kurulumu
Reclazz, SAP Commerce'te Java, Spring XML, items.xml, beans.xml, ImpEx ve properties değişikliklerini sunucuyu yeniden başlatmadan uygular. Kurulum IntelliJ eklentisiyle yapılır; ajanı eklentinin Install Agent düğmesiyle (kolay yol) ya da local.properties dosyasını elle düzenleyerek (manuel yol) eklersiniz. Yaklaşık 10 dakika sürer. Ücretsiz ve açık kaynaktır (Apache 2.0).
Reclazz yalnızca geliştirme ortamı içindir. Production'a, CCv2 manifest'ine ya da projenin build'ine girmez; eklediğiniz satır sizin makinenizde kalır.
JetBrains Marketplace'ten kurun (önerilen)
- IntelliJ IDEA'da Settings → Plugins → Marketplace ekranını açın. Reclazz arayın ve Install seçin; istenirse IntelliJ'yi yeniden başlatın.
- SAP Commerce projenizi açın. Settings → Tools → Reclazz ekranında Enable Reclazz in this project kutusunu işaretleyip Apply seçin.
- SAP Commerce bölümündeki Install Agent düğmesine basın. Ajan eklentinin içindedir; güncellenen başlangıç ayarlarının yedeği alınır.
- Kurulum kontrolündeki önerileri izleyin. Wrapper seçenekleri farklıysa
ant serverçalıştırın, ardından geliştirme sunucunuzu yeniden başlatın. Aşağıdaki adım bu komutları gösterir. - Check setup bağlantısını açın. Ajan bağlanınca mevcut bir metodu değiştirin, kullandığınız yöntemle derleyin ve aynı uygulama işlemini tekrarlayın.
Aynı sunucu yeniden başlamadan değiştirdiğiniz sonucu döndürüyorsa ilk reload çalışmıştır.
Marketplace'ten yükle · English setup guide
Diğer kurulum yolları ve ayrıntılar
Gereksinimler
| Bileşen | Gereken |
|---|---|
| Java | JDK 17 veya üstü (SAP Commerce tarafında SapMachine 17 ve 21 test ediliyor) |
| SAP Commerce | Yerel geliştirme kurulumu; test edilen sürüm 2211 |
| Reclazz ajanı | Eklentinin içinde gelir |
| IntelliJ IDEA | 2023.3-2026.3 arası bir sürüm, Reclazz eklentisi 1.9.0 |
Aşağıdaki örneklerde HYBRIS_HOME, kurulumunuzdaki hybris klasörünün tam yoludur (örneğin /Users/ad/projeler/proje/hybris).
1. IntelliJ eklentisini kurun
- IntelliJ'de Settings → Plugins → Marketplace açın, Reclazz arayın ve kurun.
- IDE yeniden başlatma isterse yeniden başlatın.
Sonra iki yoldan birini seçin. Kolay yolda eklenti ajanı sizin yerinize kurar. Manuel yolda ayarları kendiniz düzenlersiniz. İkisinin sonunda 3. adımdan devam edin.
2A. Kolay yol: Install Agent
- Settings → Tools → Reclazz ekranında Enable Reclazz in this project kutusunu işaretleyin.
- SAP Commerce bölümünde Compile Java in the IDE instead of ant kutusunu işaretleyin.
- Install Agent düğmesine basın. Eklenti ajanı
local.propertiesdosyasına (opsiyonel config klasörü varsa95-local.properties) işaretli bir blok olarak yazar ve dosyanın yedeğini alır. - Ekranda "Agent installed in the server startup properties" yazmalı.
- Yazılan dosyada
tomcat.debugjavaoptionssatırını kontrol edin: debug bayraklarınız (-Xdebug,-Xrunjdwp:...) durmalı ve satırda tek bir-javaagent:...reclazz-agent.jarolmalı. Gerekirse elle düzeltin.
Çalışan ajana bağlıyken AutoCompile, ImpEx import, Allow REMOVE, Backoffice reset, Update Running System ve Solr reindex seçenekleri Apply ile ve yeniden bağlanınca canlı uygulanır. Ayarlardaki durum satırı ajanın gerçekte kullandığı değerleri ya da bekleme/hata sonucunu gösterir. Watch extensions içindeki keşfedilmiş eklentiler adlarıyla canlı eklenip çıkarılabilir. Önceden yüklenmiş ve enstrümante edilmemiş sınıflarda yeniden başlatmaya kadar yalnız gövde değişir; sonradan yüklenen sınıflar yapısal reload desteği alabilir. * veya boş listeyle tümünü izlemeye geçiş ve diğer başlangıç ayarları için Reinstall düğmesine basıp 3. adımı tekrarlayın.
Yazılan blok makineye özel bir yol içerir; dosya git'te tutuluyorsa commit etmeyin.
2B. Manuel yol
Ayarları kendiniz yönetmek istiyorsanız bu üç adımı izleyin; Install Agent düğmesine basmayın.
Manuel 1. Ajanı sabit bir konuma kopyalayın
Ajan eklentinin içinde gelir; ayrıca indirmeniz gerekmez. Ancak eklenti klasörünün yolu IDE sürümüyle değişir (örneğin IntelliJIdea2025.2, IntelliJIdea2026.1). Sunucuya bu yolu yazarsanız IDE güncellendiğinde sunucu ajanı bulamaz. Bu yüzden jar'ı bir kez sabit bir yere kopyalayın.
- Eklentinin içindeki jar'ı bulun (
<sürüm>yerine kullandığınız IntelliJ'in klasörü, Community sürümündeIdeaIC...):- macOS:
~/Library/Application Support/JetBrains/IntelliJIdea<sürüm>/plugins/reclazz/agent/reclazz-agent.jar - Windows:
%APPDATA%\JetBrains\IntelliJIdea<sürüm>\plugins\reclazz\agent\reclazz-agent.jar - Linux:
~/.local/share/JetBrains/IntelliJIdea<sürüm>/plugins/reclazz/agent/reclazz-agent.jar
- macOS:
- Dosyayı tam olarak şu konuma kopyalayın:
~/.reclazz/agent/reclazz-agent.jar(Windows'ta kullanıcı klasörünüzün altında.reclazz\agent\reclazz-agent.jar).
macOS için komut (Linux'ta kaynak yolu yukarıdaki Linux yoludur):
mkdir -p ~/.reclazz/agent
cp ~/Library/Application\ Support/JetBrains/IntelliJIdea<sürüm>/plugins/reclazz/agent/reclazz-agent.jar ~/.reclazz/agent/
Bu konumdaki kopyayı eklenti her IDE açılışında güncel tutar; eklentiyi güncellediğinizde sunucunun ajanı da güncellenir.
Manuel 2. local.properties dosyasını elle düzenleyin
SAP Commerce sunucusu Tanuki wrapper ile başlar. tomcat/conf/wrapper.conf her ant çalıştığında yeniden üretilir; oraya yazılan satır kaybolur. Doğru yer platformun kendi ayarlarıdır: tomcat.javaoptions (normal başlatma) ve tomcat.debugjavaoptions (debug başlatma).
HYBRIS_HOME/config/local.propertiesdosyasını açın.- Bu iki ayar zaten varsa değerlerini silmeyin; ajanı mevcut değerin sonuna ekleyin. Özellikle
tomcat.debugjavaoptionsgenelde-Xdebugve-Xrunjdwp:...gibi debug bayraklarını taşır, silerseniz debug çalışmaz. - Her iki satırda da yalnızca bir tane
-javaagent:...reclazz-agent.jarolsun.
tomcat.javaoptions=<mevcut değerler> -javaagent:/Users/ad/.reclazz/agent/reclazz-agent.jar=autoCompile=true
tomcat.debugjavaoptions=<mevcut debug bayrakları> -javaagent:/Users/ad/.reclazz/agent/reclazz-agent.jar=autoCompile=true
hybrisHome=, hybrisserver.sh ile başlatmada isteğe bağlıdır: ajan kurulumu SAP Commerce'in kendi HYBRIS_BIN_DIR bilgisinden bulur. JVM'i başka yolla başlatıyorsanız veya bilinçli bir override istiyorsanız kullanın. Açık değer çakışırsa uyarı verilir ve açık değer korunur. Managed Reinstall bu gereksiz argümanı çıkarır; doğrudan IDE başlatma ve attach açık yolu korur.
autoCompile=true kaydettiğiniz Java dosyasını ant build beklemeden ajana derletir. Elle eklenen satır başlangıç varsayımıdır; IDE ajana bağlandığında yukarıdaki altı canlı seçenek Settings'teki kayıtlı değerlerle eşitlenir. IDE bağlantısı yoksa başlangıç satırı geçerlidir. Canlı değişiklik satırı yeniden yazmaz. Satırlar makineye özel yol içerir; local.properties git'te tutuluyorsa commit etmeyin.
Manuel 3. IntelliJ'de Reclazz'ı açın (otomatik kurulum olmadan)
- Projeyi IntelliJ'de açın. Bir Reclazz bildirimi Install Agent ya da Enable Reclazz düğmesiyle gelirse basmayın; ikisi de ajanı sizin yerinize ayarlara yazar. Bildirim hiç çıkmayabilir, sorun değil.
- Settings → Tools → Reclazz ekranını açın.
- En üstteki Enable Reclazz in this project kutusunu işaretleyin. Bu kutu ayarlara bir şey yazmaz. Açıkken eklenti "Reclazz is off" önerisini artık göstermez ve ayarlardaki ajan jar'ı silinmişse sizi uyarır. IntelliJ ajana bu kutudan bağımsız olarak bağlanır.
- SAP Commerce bölümündeki Install Agent düğmesine basmayın.
- OK ile kaydedin.
Elle kurulumda bu ekranda şunları görmeniz normaldir:
- Agent not installed in the server: Eklenti yalnız kendi yazdığı bloğu arar; elle eklenen satırı burada göstermez. Ajanın çalıştığını sunucu konsolundan ve bağlantı durumundan anlarsınız.
- Agent: not connected: Sunucu kapalıyken böyle yazar. Sunucu açılınca IntelliJ ajana
HYBRIS_HOME/.reclazz/agent.portdosyası üzerinden bağlanır; Test connection ile kontrol edebilirsiniz.
3. Ayarları uygulayın ve sunucuyu başlatın
Başlangıç satırındaki ayarlar wrapper.conf dosyasına ancak ant ile geçer. Bu varsayımları kalıcı değiştirmek için sadece sunucuyu yeniden başlatmak yetmez; canlı seçenekler ise bağlı ajanda ayrıca uygulanır.
cd $HYBRIS_HOME/bin/platform
. ./setantenv.sh
ant server
./hybrisserver.sh # debug için: ./hybrisserver.sh debug
Windows'ta aynı klasörde setantenv.bat, ant server ve hybrisserver.bat kullanın.
Sunucu açılırken konsolda Reclazz satırlarını görmelisiniz:
[Reclazz] [INFO] Agent loaded via -javaagent (premain)
[Reclazz] [ OK ] Reclazz is active. Watching for changes...
[Reclazz] [INFO] Watching ... directories
Bu satırlar yoksa ajan yüklenmemiştir; önce Sorun giderme bölümüne bakın. IntelliJ'in alt durum çubuğundaki gösterge de "Reclazz: Connected" yazar; "Reclazz: Not connected" kalıyorsa ajan sunucuya bağlanmamıştır.
4. İlk deneme
Kurulumun çalıştığını görmenin en kısa yolu, sık kullandığınız bir endpoint'te küçük bir değişikliktir.
- Bir OCC controller'ın ya da servisin döndürdüğü bir değeri seçin ve endpoint'i çağırıp cevabı not edin.
- Metodun içindeki dönen metni değiştirin ve dosyayı kaydedin.
- Konsolda
Compiled ...javave ardındanReloaded ...satırlarını bekleyin; genelde bir iki saniye sürer. - Endpoint'i tekrar çağırın. Yeni metin gelmeli; sunucu yeniden başlamamalı.
Sorun giderme
Önce Settings → Tools → Reclazz → Check setup bağlantısını açın. Her satır kurulumdaki bir kontrolü ve gerekiyorsa çözümünü gösterir: normal/debug ajan seçenekleri, üretilen wrapper, debug bayrakları, JAR sürümü, sunucu JDK'sı, diğer ajanlar ve izlenen uzantılar. Sunucu açıksa çalışan ajan sürümü ve DOCTOR özeti de görünür; kapalıysa bu adım atlanır. Kontrol dosya oluşturmaz veya değiştirmez.
Install Agent veya Reinstall başarılı olunca kurulum sonucu hemen gösterilir; aynı kontrol otomatik çalışır ve özeti ayrı bir bildirimle iletilir. Wrapper seçenekleri gerçekten farklıysa ant server önerilir; ilgisiz bir properties değişikliğinin tarihi tek başına hata sayılmaz. Önerilen düzeltmeden sonra yeniden kontrol edin.
| Belirti | Neden | Çözüm |
|---|---|---|
Açılışta hiç [Reclazz] satırı yok | Ayarlar wrapper.conf dosyasına geçmemiş | ant server çalıştırıp sunucuyu yeniden başlatın |
| Normal modda çalışıyor, debug modda Reclazz satırı yok | tomcat.debugjavaoptions içinde ajan yok | Kolay yolda 2A'nın 5. maddesini, manuel yolda Manuel 2'yi yapın, sonra ant server |
| Debug modda breakpoint'ler çalışmıyor | tomcat.debugjavaoptions düzenlenirken JDWP bayrakları silinmiş | .reclazz-bak yedeğinden ya da ekibin ayarından bayrakları geri ekleyin |
| Kaydediyorum ama değişiklik gelmiyor | Java derlenmiyor ya da uzantı izlenmiyor | local.properties satırınızda autoCompile=true var mı bakın; Tools → Why Didn't My Class Reload? ile sınıfı sorun |
Konsolda Holding 1 source files | Dosya derlenemedi (örneğin yeni DTO alanı henüz üretilmedi) | Hatayı düzeltin ya da "DTOs ready" sonrası dosyayı tekrar kaydedin |
| Yeni items.xml attribute'u hata veriyor | Veritabanı kolonu yok | HAC → Update Running System |
| Bir değişiklik için restart isteniyor | Bazı değişiklikler (örneğin üst sınıf değişikliği) restart gerektirir | Tools → What Still Needs a Restart? listesine bakın; nedeni orada yazar |
Çözemediğiniz bir durumda GitHub'da issue açabilirsiniz; konsoldaki [Reclazz] satırlarını eklemeniz yeterli.
Kaldırma
- Kolay yolla kurduysanız: Settings → Tools → Reclazz → SAP Commerce bölümünde Remove bağlantısına tıklayın; eklenti kendi bloğunu ya da
95-local.propertiesdosyasını kaldırır.tomcat.debugjavaoptionssatırını elle düzelttiyseniz oradaki-javaagent:...kısmını da silin. - Manuel kurduysanız:
local.propertiesdosyasında iki satırdan yalnızca-javaagent:...reclazz-agent.jar...kısmını silin; diğer değerlere ve debug bayraklarına dokunmayın. ant serverçalıştırıp sunucuyu yeniden başlatın.- İsterseniz IntelliJ'de Enable Reclazz in this project kutusunu kapatın ya da eklentiyi kaldırın.
Projenin koduna ve build'ine hiçbir şey eklenmediği için kaldırmak bu kadardır.