Jetspeed'i ve anlatimi yapilandirmak için, Maven'i kurmalisiniz. Devam etmeden önce Maven'i indirin ve kurun. Bundan sonraki örnekler sizin komut satirinda jetspeed'in /tutorial dizininde çalistiginizi varsayacak.
Jetspeed Plugin Portal sitesi insasini yönetmek için kullanilir. Portal sitenizi Jetspeed plugin ve Maven kullanarak yapilandirmaniz kuvvetle tavsiye edilir. Eger degisiklerin geri dönüsümünü gerçeklestirmeyi düsünmüyorsaniz, kesinlikle Jetspeed kaynak kod agacinda degisiklik yapmayin. Buradaki önemli nokta portalin saglikli çalismasi ve sürdürülebilir olmasi için, kaynak kütüklerinizi ve diger kaynaklari Jetspeed'den ayri tutmanizi saglar. Bunu saglayarak, kendi CVS'inizdeki kaynak kodunuzu yönetebilirsiniz ve Jetspeed'in kaynak kodunu ve diger kaynaklarinin da kontrolü elinizde olur. Böylelikle yeni bir Jetspeed sürümü çiktiginda, çekirdek kodda hangi degisiklikleri yaptiginizi düsünmeden bütünlestirmeye hazir olacaksiniz.
Jetspeed Plugin'i çok fazla özellige gereksinim duymaz. Kendi ana dizininizde build.properties ile ya da projenizdeki project.properties ile bu ayarlari yapabilirsiniz.
# Tell the Plugin which property files to merge
maven.merge.properties =
JetspeedResources,JetspeedSecurity,TurbineResources,Torque # tell the plugin
which version of Jetspeed distribution we are merging with jetspeed.dist.version
= 1.5
Anlatim projesiyle hedeflenenler sunlardir:
jetspeed:war
Bütün anlatimlarin yapilandirilip bir WAR kütügü seklinde dagitiminin yapilmasi
clean
Eski yapilandirmalarin ve dist dizinlerinin silinmesi
java:compile
Java kodlarinin derlenmesi
jetspeed:deploy
Uygulamalarin servlet kabina konuslandirilmasi
dist
Ikil dagitiminin olusturulmasi
jetspeed:hotdeploy
Uygulamanin Hot Deploy yöntemiyle portlet kabina yerlestirilmesi
javadoc
Javadoc API belgelemesinin olusturulmasi
torque:om
Nesne Model kaynaklarinin olusturulmasi
-Dtutorial=0
Anlatimi sifirlar
tutorial-n [1-12] deploy
Dagitimi n'inci anlatim örneklerine göre ayarla.
Hatirlatalim ki, jetspeed:deploy, jetspeed:hotdeploy, jetspeed:war hedefleri için anlatimda deploy, hotdeploy, war kisaltmalarini kullanabilirsiniz. Hotdeploy hedefi kendi projeniz içinde en yararli olan olacaktir ve bu anlatimda adim adim izlenmesi gerekmez. Belirli bir anlatim örnegini insa etmek için, asagidakini yazin;
maven -Dtutorial=[n] jetspeed:deploy (n = anlatimin numarasi)
Anlatimlar istenen sirada çalistirilabilir. Eger tutorial-5'i yerlestirmek istiyorsaniz, 1'den 4'e kadar olan anlatimlari çalistirmaniza gerek yok, çünkü 5. anlatim 1'den 4 kadar olan anlatimlari içerir.
YapIlandIrma Örneklerİ
Simdi JPortal sanal doku uygulamasina baslamak için hazirsiniz. Catalina'yi baslatin ve tarayiciyla asagidaki sekilde sayfaya ulasin:
http://localhost:8080/jportal/portal
JPortal anasayfasini göreceksiniz. JPortal'in bir kullaniciya göre uyarlanmis sekliyle görüntülemek için, sisteme asagidaki sekilde giris yapin:
Username = turbine
Password = turbine
NOT: Yerlestirme islemlerinin gerçeklesmesi için ilk önce Catalina'yi kapatmalisiniz.
Anlatim örneklerinin gelistirilmesi sirasinda, genelde portletlerimizi bir portlet kabi olan Jetspeed web uygulamasina yerlestirecegiz. Bu anlatimla birlikte saglanan maven araçlariyla gerçeklestirilmektedir. Bir Jetspeed portali Java'nin Standard WAR kütükleriyle dagitilir. Uygulama sunucunuza elle kopyalayabileceginiz bu portal war'ini olusturmak için, maven jetspeed:war' komutuyla yapilandirin. jetspeed:war komutu anlatimin varsayilan komutudur. Bu war kütügü örnek kodla birlikte Jetspeed dagitiminin bir birlesimini içerir. Bu war kütüğü Jetspeed portal çekirdeği ile örnek portletleri ve bunlarına belirtimlerini bir araya getirir. war kütüğü '/target/jportal.war" olarak kaydedilir. 'jetspeed:war' komutu varsayılan komutunuzdur, böylece 'maven' yazılması bunu çalıştırır.
maven
Anlatım esnasında, jetspeed:deploy komutunu kullanmanızı öneririz. NOT: jetspeed:deploy komutunu çalıştırmadan önce Tomcat ve Catalina'yı kapattığınızdan emin olun. war'ın üretilmesini ve konuşlandırılmasını anlatımla uyuşmasını sağlamak için, komutu aşağıda belirtilen şekilde kullanın:
maven -Dtutorial=[n] deploy
deploy komutu jetspeed:war komutuna bağımlıdır. war kütüğünü ürettikten sonra, seçtiğiniz uygulama sunucusuna otomatik olarak konuşlandırılır. Bu anlatım için Jakarta Tomcat 4 ya da 5'e ihtiyacınız var. NOT: deploy komutunu çalıştırmadan önce Catalina kapatmalısınız. Ayrıca Tomcat'in bulunduğu yeri ana dizininizdeki build.properties kütüğünü tomcat.root özelliğini kullanarak ayarlamalısınız.
maven jetspeed:hotdeploy
jetspeed:hotdeploy komutu deploy komutunun hızlı tipidir. Sadece farklı olan class ve belirleme kütüklerini kütükleri konuşlandırır. deploy komutunun en az bir kere çalıştırılması bu komutunun çalışması için gereklidir. Bu komut sıradan günlük konuşandırmalar için sıkça kullanılır. Anlatım kapsamında bu komutu kullanmayacağız. Eğer herhangi bir Java kütüğünü değiştirirseniz, uygulama sunucusuna yeni class kütüklerini yüklemek için yeniden derleyeceksiniz.
Eğer JPortal örneklerini temizlemek ve varsayılan Jetspeed konuşlandırmasına dönemk isterseniz, aşağıdaki komutları yazın:
maven clean maven jetspeed:deploy
Maven'in temizleme komutu bütün class ve belirleme kütüklerini konuşlandırmadan arındırarak, size Jetspeed'in web uygulamasını bırakır. Jetspeed dağıtımında bir değişiklik yapılmaz. Tarayıcıdan http://localhost:8080/jportal/portal adresine yönlendiğinizde, varsayılan Jetspeed portalı ile karşılaşırsınız. Bu komut eğer anlatıma baştan başlamak isterseniz yararlı olabilir.
Jetspeed 2.0, Java Standard Portlet API'yi destekler. Bu API standart konuşlandırma tanımlayıcılarını (standard deployment descriptor) ve portlet arşivini (portlet archive) portletlerin portlet kabına yerleştirilebilmesi için desteklemektedir. Jetspeed'in 1.x sürümü bu standardı desteklemediğinden, özel konuşlandırma usülunü kullanmak gereklidir.