Install Pluto 1.1.4 on Geronimo 2.0.2

剛把pluto 1.1.4安裝到geronimo 2.0.2上，花掉一天以上的時間，在這裡作個記錄。

安裝環境
OS: Windows XP sp2 中文版
JDK: Sun jdk 5.0 update 12
Geronimo: 2.0.2
Pluto: 1.1.4

在安裝之前需要由pluto網站上下載pluto-current-bin.zip檔。

安裝share library
將以下檔案安裝為geronimo 的common library:

• castor-1.1.1.jar


• commons-logging-1.1.jar


• pluto-container-1.1.4.jar


• pluto-descriptor-api-1.1.4.jar


• pluto-descriptor-impl-1.1.4.jar


• pluto-taglib-1.1.4.jar

安裝pluto-portal
建立pluto-portal用的deployment plan，dependency中加入上述的common library以及xercesImpl 2.8.1版。正常狀況下，應該就能夠順利的安裝到geronimo中，能夠在http://localhost/pluto中看到pluto的登入畫面。

如果在安裝過程中發生Portlet init NullPointException，log中發現register 0 portlet的訊息，有可能是castor parse portlet.xml時發生問題，只需要把pluto-portal.war解開，將portlet.xml裡 tag的namespace拿掉，應該就能夠順利的部署上去。

安裝pluto-testsuite
pluto testsuite並不需要安裝額外的library，只需要在dependency中以classes的方式import pluto.pluto 的class以及pluto-taglib就行了，如果遇到register 0 portlet，和pluto-portal一樣，修改portlet.xml就能夠解決。

security config
在pluto-portal的deployement plan也需要註記security 的定義，定義如下

/pluto

geronimo-admin


class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/>




class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/>






pluto-testsuite的deployement plan中需包含下列片段:

    /testsuite
  
      geronimo-admin
  
      
          
                                class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/>
          
          
              
                  
                                                class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/>
                  
              
  
          
     

如此應該就能夠順利把pluto 1.1.4安裝到geronimo上了。

Java 專案環境設定 -- maven 篇 (簡介)

maven 是一個比較新近的java 專案開發工具，能夠簡化開發人員設置專案開發環境的程序與步驟，快速的進入專案的開發階段。透過Convention over Configuration 的概念以及設定檔的繼承機制，maven能夠讓團隊中所進行的各個開發專案有相同的檔案結構，同時也讓個別專案所需要進行的設定減到最低。

檔案結構

maven 預設的檔案結構如下


/src
/main
/java
/resources
/configuration
/webapp
/test
/java
/resources
/configuration
/target


以 main子目錄下放置專案的production code，test下則放置專案的testing code以及configuration，專案建置(build)的結果與過程中的中間產物則會產生在target子目錄之下。/src/main/webapp則是進行網頁專案開發時的特別目錄，放置如web.xml等等的網頁相關資訊。

專案設定檔

maven的設定檔(如同ant的 build.xml)稱作pom.xml(project object model)，設定了如建置環境(java 版本，application server)，相依性(使用到的其他library及版本)。

設定檔的設定方式都是定義式的，如在相依性的設定中，僅需定義使用的library的名稱與版本，在建置過程中，maven會依據所設定的相依性，由repository中取得所需要的函式。定義式的設定檔另外一個好處就是與系統維持最低的相依性，同樣的設定檔，不過是在 *nix或是Windows系統下，都能夠正常的使用。

專案設定檔的繼承

專案設定檔間的繼承提供了一個能夠設定團隊中跨專案的共通性設定的地方。在一般的團隊中有許多跨專案的共通規範，如coding convention, coding style, test rule等等，團隊能夠建立一個團隊的pom設定檔，而個別的專案，只需要繼承這個團隊設定檔即可擁有相同的設定，不需要在個別的專案設定檔中重複的進行這些共通的設定。