• Plugins Framework

JIRA, eklentilerini yönetebilmek için Atlassian Plugin Framework adlı bir yapıyı kullanmaktadır. Bu kütüphane her JIRA sürümü için ayrı ayrı geliştirilmiştir fakat JIRA sürümleri arasıda yine de paylaşılan/ortak kütüphaneler de bulunur. Örnek vermek gerekirse, JIRA 4.0 versiyonunda Plugin Framework ‘ün 2.3 versiyonunu, JIRA 3.13 ‘te ise Plugin Framework ‘ün 0.23 numaralı versiyonunu kullanmaktadır.

• Plugin Versions

Plugin Framework ‘ün 2.0 versiyonundan önce(yani JIRA 3.13 ve öncesi), eklentiler JIRA ‘nın jar dosyasında, JIRA classpath ‘ine yüklenirdi(WEB-INF/lib). İşte bu şekildeki eklenti yönetimi Plugin1 diye çağırılır.

Plugin Framework ‘ün 2.0 versiyonundan sonra(yani JIRA 4.0 ve üstü) eklenti yüklenmesine yeni bir yöntem getirildi. Bu yöntemde eklentiler, JIRA ‘nın installed-plugins adlı dizinine yüklenir ve eklentinin yüklenme ve yönetimi OSCI Container ‘a bırakılır. İşte bu şekildeki eklenti yönetimi de Plugin2 diye çağırılır.

Burada önemli bir noktaya değinmek gerekiriyor. Plugin2, Plugin1 ‘in bir yedeği durumunda değildir ve ikisininde birbirlerine nazaran avantaj ve dezavantajları vardır. Eklenti geliştiriciler olarak bu iki tipten birini seçmek durumundayız.

• Plugins1

Plugins1, eklenti kurmanın ve yönetmenin birincil yoludur. Plugin1 seçiminde eklentiniz, jar dosyasının içindeki WEB_INF/lib dizini altına kurulur. Bunun anlamı eklentinizin java sınıflarının uygulamanın çekirdek classpath ‘inde barındırılacağıdır. Bu durumda eklenti sınıflarınız ile JIRA sınıfları aynı anda yüklenirler.

Diyelim ki A ve B adında iki adet Plugins1 türünden eklentiyi JIRA içine kurmak istediniz. B eklentisi aynı ClassLoader içerisinde olduğundan dolayı A eklentisine ait bir sınıfı kullanmak isteyebilir. 

Peki A eklentisi kurulmamış ise ne olur ?

İşte bu durumda çalışma zamanında(runtime), ClassNotFound exception hatası ile karşılaşırız.

• Plugins2

Plugins2 eklentileri çekirdek ClassLoader tarafından yüklenmezler. Bu tip eklentiler, OSGI konteyner tarafından yüklenirler ve yönetilirler. Bunun anlamı her eklentinin kendine has classloader ‘ının olduğudur. Aslında varsayılan olarak eklentiler başka eklentilerin sınıflarını kullanamazlar. Ancak bir eklenti kendine ait paketleri açıkça dışarıya açabilir ve başka eklentiler de bu paketleri bağımlılık(dependency) olarak kullanabilir. İşte bu yolla bağımlılıklar daha iyi yönetilebilir.

Geliştirme ve Kurulum

• Yapılandırma

Plugins1 eklentileri ile Plugins2 eklentilerinin tek farkı vardır. Plugin2 eklentileri yapılandırma dosyasında(atlassian-plugin.xml) kendilerini aşağıdaki gibi belirtmelidirler.

<atlassian-plugin key="${atlassian.plugin.key}" name="${project.name}" plugins-version=“2">

• Kurulum

Bir Plugin1 eklentisi ygulama classpath ‘inde bulunmalıdır. Bu nedenle WEB_INF/lib altına yüklenirler.

Fakat bir Plugin2 eklentileri standart classpath ‘te olmamalıdırlar. Onlar JIRA ana dizini içerisinde özel bir dizin altına( jira-home/plugins/installed-plugins/ ) kurulurlar.    

• Bağımlılıkların Yönetimi/Eklenmesi(Dependency Injection)
  • Konteyner

JIRA, kendi çekirdek sınıflarının ve Plugins1 türünden eklentilerin bağımlılıklarının yönetimi için Pico Container kullanır.

Diğer taraftan, Plugin2 türünden eklentilerin bağımlılıklarının yönetimi doğrudan JIRA tarafından yapılmaz. Bundan Plugins Framework sorumludur. Plugins Framework ise bağımlılıkların yönetimini için Spring Framework kullanır. Bu durum geliştirme aktivitesini etkilemez ancak dikkat edilmesi gereken birkaç ince husus vardır. Eğer bir class birden fazla yapıcı metoda sahipse, burada Pico Container ve Spring Framework farklı davranarak farklı yapıcı metotları seçip kullanabilirler.

Ayrıca JIRA tüm içsel bileşenlerini PluginFramework için kullanılabilir yapmaz. Bazır bileşenler sadece çekirdek sistem tarafından kullanılır. Bunun bir diğer anlamıysa bir Plugins1 türünden eklenti bazı bağımlılıkları ekleyebilirken, başka bir Plugin2 türünden eklenti aynı sınıfları yükleyemeyebilir.

• Bileşenler

JIRA bileşenleri, SOA mimarisi içerisinde birer servis olarak kabul edilirler. Servisler başka nesneler içerisini bağımlılık olarak eklenebilirler.

• Plugins1 Türünde Bileşenler

Bir Plugin1 eklentisi bir bileşen tanımlarsa, bu bileşen JIRA ‘nın çekirdek bağımlılık yönetim kontenırına tanımlandığında başka bileşenler tarafından erişilebilir bir bağımlılık haline gelir.

Aslında mevcut çekirdek bileşenlerini değiştirmek için bile bir bileşen yapmak mümkündür. Fakat bu iyi bir fikir olarak kabul edilmez. Çünkü bu durum zor, hata eğilimli ve her zaman çalışması garanti edilen bir yöntem değildir.

• Plugins2 Türünde Bileşenler

Bir Plugin2 eklentisi bir bileşen tanımlarsa, bu bileşen varsayılan olarak eklentiye özeldir. Eklenti sınıfları bu bileşeni bağımlılık olarak ekleyebilirler fakat bu bileşen başka eklentilerden erişilebilir olmaz. Fakat, geliştirici bir bileşeni açıkça erişilebilir kılarsa, işte bu durumda bileşen başka eklentilerden de bağımlılık olarak eklenebilir/yönetilebilir. 

Bir sonraki yazıda JIRA Eklentilerin bulunabilecek modül tiplerini inceleyeceğiz.