Akışları görsel ve kod olarak geliştirin

Bir akış, bir mesajın nereden geldiğini, hangi sırayla işlendiğini ve nereye gönderildiğini tanımlar. Lunex’te route’ları görsel olarak düzenleyebilir, aynı tanımı YAML olarak açabilir, gerektiğinde Java kodu, bean ve yeniden kullanılabilir Kamelet ekleyebilirsiniz.

Proje, dosya ve route ilişkisi

Kavram	Kullanımı
Proje	Birlikte çalıştırılan ve dağıtılan route’ları, API’yi, kodu ve ayarları toplar
`.camel.yaml` dosyası	Bir veya daha fazla route, route configuration, template veya bean tanımı içerir
Route	Bir `from` girişi ve onu izleyen işlem adımlarıdır
Endpoint	Giriş veya çıkış adresidir; örneğin `direct:validateOrder`, bir HTTP adresi veya kuyruk
Route ID	Çalışan route’un teknik kimliğidir
Route name	Akışın amacını insanlara anlatan adıdır; designer ve Message Monitor’da gösterilir

Bir route ayrı deployment veya güvenlik sınırı değildir. Aynı projedeki route’lar runtime’ı paylaşır. Ayrı kaynak, yaşam döngüsü ve dağıtım ihtiyacı için proje ve runtime sınırını değerlendirin.

Architecture görünümünü okuyun

Projede Architecture, kaynak dosyalarından API, route, giriş/çıkış ve ilgili bean ilişkilerini gösterir. Bir akışın hangi bağlantıyı kullandığını ve başka bir route’a nasıl geçtiğini bu görünümden izleyebilirsiniz. Grafikteki öğeden ilgili kaynak dosyasını açın.

Route yeni bir giriş seçer. OpenAPI API sözleşmesini oluşturur. More create options menüsünde Route Configuration, Route Template, Kamelet, Bean, Properties ve Kubernetes kurulumunda Deployment bulunur. Grafiği okumak için yakınlaştırma, sığdırma, gruplama, yerleşim, Beans, Legend ve Statistics kontrollerini kullanabilirsiniz.

Architecture, tasarım ilişkilerini açıklar. Mesajın gerçekten hangi adımlardan geçtiğini görmek için Simulation veya canlı çalışma kayıtlarını kullanın.

Architecture ekranı rehberi, düğümleri, çift tıklayarak dosya açmayı, görünüm kontrollerini ve Statistics sayaçlarını ayrıntılı açıklar.

İlk route’u oluşturun

Set Body’nin neyi değiştirdiğini ve ${body} ifadesinin ne okuduğunu mesaj ve veri temellerinde görebilirsiniz.

Bu örnek bir kez tetiklenip log’a Hello from Lunex yazar; dış sisteme bağlanmaz.

Geliştirme ortamında projenizi açın ve Architecture → Route seçin.
Select source penceresindeki Search catalog alanında timer arayın.
Timer kaynağını seçin; adını hello belirleyin. Dosya adını hello yapıp Select seçin; .camel.yaml uzantısı eklenir.
Oluşturulan Timer girişini açın; özellik panelinde Repeat Count değerini 1 yapın.
Route’ta Add ile Set Body ekleyin ve Constant değerini Hello from Lunex yapın.
Ardından Logger adımı ekleyip message değerini ${body} yapın.
Saved durumunu bekleyin; projenin Run düğmesiyle çalıştırın.
Projenin Log bölümünde mesajı kontrol edin.

Aynı route’u Code görünümünde şu şekilde yazabilirsiniz:

- route:
    id: hello-once
    description: Write one greeting
    from:
      uri: timer:hello
      parameters:
        delay: 1000
        repeatCount: 1
      steps:
        - setBody:
            constant: Hello from Lunex
        - log:
            message: ${body}

timer geliştirme runtime’ı açılınca tetiklenir. Tekrar görmek için runtime’ı yeniden başlatabilirsiniz. Sürekli çalışan bir kaynak istiyorsanız ilgili component’in periyot ve tüketim seçeneklerini ayarlayın.

Adımları düzenleyin

Bir adımı seçtiğinizde özellik paneli o adımın alanlarını açar. Filter properties ile arayın; Required, Changed ve Sensitive filtreleriyle alanları daraltın. Bir filtre açıkken beklediğiniz alan görünmüyorsa önce filtreleri temizleyin.

Sağ panel rehberi Properties, Step details, Language/Expression, Input ve Output alanlarını bir arada açıklar. Akış sırası ise aynı mesajın ardışık adımlarda nasıl değiştiğini gösterir.

Add yeni adım ekler; uygun öğelerde Insert öncesine ekler, Copy kopyalama işlemini başlatır. Delete silme işlemini açar. Desteklenen öğelerde devre dışı bırakma ve route başlangıcını kontrol eden AutoStartup seçenekleri bulunur. Değişiklikten sonra Code görünümünde adımların sırasını ve kapsamını kontrol edin; özellikle Choice, Split ve Try bloklarının içinde ekleme yaparken üst öğeye dikkat edin.

Mesajın parçalarını kullanım amacına göre seçin:

Body: İşlediğiniz asıl içerik; JSON, XML, metin veya bellekte bir nesne olabilir.
Header: Protokol veya işleme bilgisi. Bazı header’lar sonraki endpoint’e taşınır.
Exchange property: Aynı işlemin içinde taşıdığınız çalışma bilgisi.
Variable: Kendi ara değeriniz; öneksiz kullanımda exchange’e özeldir ve exchange property’den ayrı tutulur. Alan seçimi ve örnek.

Alanlara sabit değer, expression veya {{property.name}} yazabilirsiniz. Ortam değeri ve Secret seçimi için yapılandırma rehberini kullanın.

Designer ve Code arasında geçin

Designer ve Code aynı dosyanın iki görünümüdür. Görsel route/bean düzenleme uygun Camel YAML dosyalarında, Kamelet düzenleme .kamelet.yaml dosyalarında kullanılabilir. JSON, properties, Java, XML ve script dosyalarını kaynak editöründe açarsınız.

Bir Camel YAML dosyası ayrıştırılamıyorsa Code’da girinti, alan adları ve veri türlerini düzeltin; sonra Designer’a dönün. Full screen düzenleme alanını büyütür; Esc çıkartır. Görünümler arasında geçmek, değişiklikleri Git’e göndermez veya runtime’a yüklemez.

Route, kod ve properties değişiklikleri otomatik kaydedilir. Saving… bitip Saved görünmesini bekleyin. Could not save file durumunda değişiklik oturumda tutulur; Retry save ile yeniden deneyin. API editörü ise ayrıca Save ister.

Bean ile ortak nesne veya iş mantığı kullanın

Bean, route’ların adıyla kullanabildiği bir nesnedir. Veri kaynağı/bağlantı fabrikası gibi yapılandırma nesnesi veya özel Java iş mantığı için kullanılır.

Architecture → More create options → Bean seçin.
Type adımında varsa şablon seçin; Empty boş tanımla başlamanızı sağlar.
Şablonlu akışta Template ve Properties adımlarını tamamlayın.
File adımında ekleneceği dosyayı seçin veya yeni dosya adı girin.
Dosyanın Designer → Beans görünümünde bean adını, sınıfını, constructor ve property değerlerini inceleyin.
Route içindeki Bean veya ilgili component property alanından bu adı referans verin.

Beans → Create bean aynı dosyaya yeni bean ekler. Java kaynağı gereken alanlarda Open Java Class ilgili sınıfı açabilir veya oluşturabilir. Sınıfın bağımlılıkları çalışma ortamında bulunmalıdır; dosyanın varlığı tek başına bağlantının hazır olduğunu göstermez.

Route Template ve Kamelet ile tekrar kullanın

Route Template, aynı akış yapısından farklı parametrelerle route üretmek içindir. Architecture → More create options → Route Template ile başlayın; template parametrelerini ve route’unu tanımlayın. Bir template tanımı, somut parametrelerle kullanılmadan çalışan iş akışınızın yerini almaz. İleri template tanımlarını Code’da düzenleyebilirsiniz.

Kamelet, parametreleri ve bağımlılıklarıyla paketlenmiş, tekrar kullanılabilir bir kaynak, hedef veya işlem parçasıdır. Yeni tanım için More create options → Kamelet kullanın. Dosyanın Kamelet görünümünde başlık/açıklama, Properties ve Dependencies alanlarını; Routes görünümünde iç akışı düzenleyin. Beans görünümü ortak nesneleri barındırır.

Kaynak seçiminde veya bir adıma eklerken katalogdaki Kamelets filtresini kullanın. Custom Kamelets only, size ait tanımları daraltır. Paylaşılabilir Kamelet veya template dosyasında Source → Files → Share, dosyayı ortak kütüphaneye kopyalar; paylaşımı Git üzerinden taşımak için kopyalanan dosyayı da commit edin.

Dosyaları ve değişiklikleri yönetin

Source → Files üzerinden Create file, Upload, uygun dosyalarda Rename, Download source ve Delete kullanabilirsiniz. Ortam dosyaları için Copy for environment sunulur. Projenin yerleşik dosyalarında bazı ad veya silme işlemleri kısıtlıdır.

Dosyanın kaydedilmesi çalışma alanını günceller. Çalışan projeye geçirmek için Run/Reload, sürümü ekiple paylaşmak ve deployment’a almak için Git ve Build kullanın. Bir dosyayı silmeden önce başka route, bean, resource veya schema referansının ona bağlı olup olmadığını kontrol edin.

Sonraki adımlar: bileşen ve veri dönüşümü, hata yönetimi, Simulation.