淺談ofbiz.doc

淺談OFBIZ作者：李心（北京郵電大學(xué)）Email:今年的暑假，本著走進社會，了解生活的目的，我踏進了北京朗華世紀科技發(fā)展有限公司，開始我的暑期實習。正在我興奮著自己能夠成功地進入了這家公司后，一個不小的挑戰(zhàn)擺在了我的面前。公司交給我的任務(wù)是對OFBIZ的release4.0中的bug的測試。在這期間我遇到了許多大大小小的麻煩，主要是因為對OFBIZ的不熟悉造成的，幸虧同事們對我的幫助，讓我克服了這一個個困難。為了像我一樣的新手們能夠?qū)FBIZ有一個初步的了解，所以我主要從以下三個方面來對OFBIZ 4.0做一個大致的介紹。1. OFBIZ的release4.0開發(fā)環(huán)境的搭建。2. OFBIZ的漢化示例。3. OFBIZ的模塊開發(fā)示例。開發(fā)環(huán)境的搭建首先，我們先來安裝JDK1.5.0。第一步：我們要先從 上下載jdk-1_5_0_04-windows-i586-p.exe。第二步：我們要把它安裝到指定的路徑里。第三步：開始配置環(huán)境變量。下面我舉一個小例子：例如我安裝JDK到E:jdk1.5.0，那么環(huán)境變量應(yīng)改為如下：Java_HOME: E:jdk1.5.0PATH: E:jdk1.5.0bin;CLASSPATH: E:jdk1.5.0libtools.jar;E:jdk1.5.0jrelibrt.jar;其次，我們來安裝mysql5.0.第一步：我們要先從/downloads/mysql/5.0.html 上下載mysql5.0的安裝文件。第二步：我們最好按照它的默認路徑安裝好。并記好你安裝時輸入的密碼，在以后安裝OFBIZ時還有用。接著我們就要來安裝我們的編譯器eclipse了。eclipse現(xiàn)在主要有三個版本3.1，3.2和3.3(也就是Europe版的)。第一步：我們要從 上下載eclipse3.2的安裝文件。第二步：我們就按著安裝步驟一步步地安裝好就可以了。然后我們打開eclipse，來安裝我們要測試release4.0的subclipse, mylyn, mylyn-extras。其實它們的安裝方法基本一樣。1.subclipse的安裝（1）在eclipse里點“幫助”里的軟件更新中的查找并安裝。（2）點擊搜索要安裝的新功能部件選項后，點擊下一步。（3）在這里安裝軟件有兩種方法：一選擇“新建遠程站點”。出來新建遠程站點對話框后，輸入名字和要下載的軟件的地址。我們下的是subclipse，當然名字就輸入subclipse了。下載subclipse的網(wǎng)站地址是/update_1.0.x 當這些都輸入好后，我們點擊確定，然后再點擊完成。如圖1-1所示。此時就會自動地連接站點下載了，到進度快完成的時候，你會看到有提示，問是否完全安裝？一般我們初學(xué)者就選擇完全安裝就好了，對于有自己要求的人來說，可以選擇性的安裝。圖1-1二是我們從網(wǎng)站上已經(jīng)把軟件下載到電腦里了的情況。我們選擇“新建本地站點”。出來新建本地站點對話框后，輸入名字和本地軟件所在的地址。當這些都輸入好后，我們點擊確定，然后再點擊完成，它就會自動安裝了。2.mylyn 的安裝和上文提到的subclipse的步驟一樣，在此我就僅把mylyn的下載地址提供給大家/tools/mylyn/update/e3.2（這個地址是適用于3.1和3.2版的，要是要安裝適用于3.3版的，把地址最后的3.2改為3.3即可）3.mylyn-extras 的安裝也和上文提到的subclipse的步驟一樣，在此我也就僅把mylyn-extras的下載地址提供給大家/tools/mylyn/update/extras（適用于三個版本）下面我們就要開始用SVN檢測并下載OFBIZ的release4.0了。第一步：我們點擊“文件”里的新建中的“項目”。第二步：我們將SVN文件夾點開，選擇里面的“從SVN檢出項目”，然后點擊下一步。第三步：我們選擇創(chuàng)建新的資源庫位置，然后點擊下一步。第四步：會出現(xiàn)一個讓我們輸入URL的對話窗，我們在對話框里輸入我們要檢測出的地址/repos/asf/ofbiz后點擊下一步。第五步：我們點開branches后，選擇release4.0，然后點擊下一步。如圖1-2。第六步：我們輸入任意的項目名稱后點擊下一步。第七步：我們可以使用省缺工作空間（也就是默認的地址），也可以自己選擇路徑，然后點擊完成即可。圖1-2在我們下好了OFBIZ的release4.0后，下面我們要開始安裝了。第一步：我們要更改一下數(shù)據(jù)庫。我們要在“包資源管理器”或“導(dǎo)航器”里的你剛剛下載的OFBIZ下的branches中的release4.0下的framework下的entity里的config里面打開entityengine.xml文件。第二步：在此文件里找有四行都是以delegator name開頭的，請將里面的datasource-name=localderby都改為datasource-name=localmysql。第三步：在此文件里找到datasource-name=localmysql開頭的代碼區(qū)域，將里面的jdbc-username= 和jdbc-password= 都改為你安裝mysql時的用戶名和密碼。第四步：我們要在entity下的lib下的jdbc中導(dǎo)入mysql5.0的驅(qū)動，mysql5.0的驅(qū)動可以上這個網(wǎng)頁上任選其一下載/get/Downloads/Connector-J/ mysql-connector-java-5.0.6.zip /from/pick#mirrors 第五步：我們可以在“包資源管理器”或“導(dǎo)航器”里的你剛剛下載的OFBIZ下的branches中的release4.0中找到一個名為build.xml的文件，我們在此文件上點擊鼠標右鍵，選擇運行方式里的2 Ant構(gòu)建。（此時不要點擊1 Ant構(gòu)建，這個為默認構(gòu)建，第一次需要做一些調(diào)節(jié)，所以選另一個構(gòu)建）第六步：在左側(cè)的“名稱”欄目里我們要選擇clean，build，run-install，然后點擊運行。（接下來將是一段漫長的安裝時間，大約40分鐘左右）如圖1-3所示。第七步：當安裝的窗口里顯示complete時，就安裝好了。提示：再安裝的過程中你可能會像我一樣遇到了這個問題而不能安裝成功，就是沒有建立mysql的數(shù)據(jù)庫。下面我來說一下解決方法：第一步：打開你的MySQL Command Client，然后輸入你安裝mysql時的密碼。第二步：輸入 show databases; 然后回車。然后你會看到一個database的表格，檢查一下這個表格里有沒有mysql這一項，如果有了，那說明就不是這個問題了，要是沒有接著進行下一步。第三步：輸入 create database mysql; 然后回車。第四步：重復(fù)第二步，此時應(yīng)該在database的表格里有mysql這一項了。然后再按照前面說過的安裝一下OFBIZ,這下應(yīng)該就可以了。圖1-3當我們安裝成功了以后，要開始運行OFBIZ了。第一步：還是找到build.xml文件，我們在此文件上點擊鼠標右鍵，選擇運行方式里的2 Ant構(gòu)建。第二步：在左側(cè)的“名稱”欄目里我們要選擇clean，build，run，然后點擊應(yīng)用，再點擊運行。第三步：等待運行成功后，打開https:/localhost:8443/accounting/control/main 這一網(wǎng)址，輸入用戶名為admin，密碼就是你設(shè)的密碼，如果能成功進入，那就說明運行成功了。最后我們還剩下的工作就很簡單了，要加入OFBIZ的DEV_ML和Apache的JIRA。OFBIZ的DEV_ML第一步：打開/display/OFBADMIN/Mailing+Lists 這個網(wǎng)址，點擊User List里的Subscribe。第二步：發(fā)送郵件，主題和內(nèi)容寫什么都可以。第三步：很快你會收到一封回信，你需要再給它回一封信，確認你要加入就可以了，從此以后你就可以收到很多信息了。Apache的JIRA加入JIRA的方法是一樣的，網(wǎng)址是/foundation/mailinglists.html 當這一切都做好了以后，我們就可以建立task來接受JIRA的信息了。操作步驟如下：第一步：點開窗口，點顯示視圖里的“其它”選項。第二步：選擇Mylyn里的Task List，然后點確定。第三步：用鼠標右鍵點擊 Uncategorized里的New里的Query。第四步：點擊Add Task Repository后選擇JIRA，然后點Next。第五步：先進入/jira/secure/Dashboard.jspa 注冊一個用戶，然后再在server里輸入/jira ，UserID和Password就是你剛剛注冊的用戶名和密碼，Label可以隨便寫。輸完這些以后點擊一下Validate setting，檢查一下是不是都可以了。都可以了以后，點擊完成。第六步：之后會出現(xiàn)一個大的表格有許多需要選的。我們可以根據(jù)自己的需要在里面進行選擇。然后點擊完成，它就會自動聯(lián)網(wǎng)，進行同步更新。OFBIZ的漢化示例首先我們先來了解一個名詞“漢化”，顧名思義，就是把不是中文的語言翻譯成中文，方便大家的使用。大家都知道，OFBIZ的release4.0是由各個模塊組成的（會在以后有所介紹），而每個模塊里又包含有許許多多的子文件夾，每個文件夾里又有許多的程序文件。幾乎每個文件里都會有“鍵”和“值”，我們的漢化任務(wù)就是把這些“鍵”所對應(yīng)的“值”的英文改為中文，這是一個看似簡單的工作，不就是把英文翻譯成中文嘛，可是實際上卻實在是個累人的工作，不計其數(shù)的文件，每個文件里又有許多要翻譯的，著實是個龐大的工程。所以在翻譯的過程中出現(xiàn)錯誤也是在所難免的，所以這就要求我們在翻譯之后要進行校對工作。在我們核實了翻譯的準確無誤之后，我們再要做的就是把這些以Unicode碼記錄下來的中文轉(zhuǎn)換為Java能夠使用的ASCII碼，再將修改過的文件的文件名按照國際統(tǒng)一標準加上后綴_zh就算是漢化完成了。為了大家能夠更好的理解，下面我就來舉一個簡單的小例子。我們以release4.0下的applications/accounting/config/AccountingUiLperties為例。當我們雙擊打開這個文件時，我們可以看到有些代碼顯示為藍色，這些代碼就是我們將要翻譯的對象。如圖2-1。圖2-1下面翻譯就是我們自己的事情了。翻譯好的對應(yīng)文本如圖2-2。圖2-2接下來我們的工作是進行校對，以確保準確性。我們可以通過類似于我們公司開發(fā)的這樣一個工具，進行校對工作。如圖2-3。圖2-3這個工具不僅可以中英對照，更可以支持多國文字對照翻譯。最后我們只需要將這些中文對應(yīng)的Unicode碼，轉(zhuǎn)換成Java可以識別的ASCII碼就好了。我們可以通過我們公司編的一個程序?qū)崿F(xiàn)這些。轉(zhuǎn)換好的如圖2-4所示。圖2-4就是這樣一個不算復(fù)雜，但是又工作量很大的過程，方便了廣大的中國用戶，我們公司也是中國為數(shù)不多的對OFBIZ進行漢化的公司之一，希望能夠給廣大的用戶們帶來方便。OFBIZ的模塊開發(fā)示例一 準備工作1 在Eclipse下用SVN在朗華公司的網(wǎng)站上下載已漢化的OFBIZ項目。2 如圖可以看到主要有4個大的主要的模塊：applications、framework、hot-deploy、specialpurpose，而有些模塊下又有許多小的具體的應(yīng)用模塊。 圖3-1二 實施階段下面我們將以我們公司的會議室預(yù)訂服務(wù)模塊為例，來具體講解如何用OFBIZ 來做二次開發(fā)。1.首先，建一個meetingroom模塊我們在specialpurpose模塊下模仿別的小模塊，建一個meetingroom模塊，具體的配置等我們做的時候，再詳細的介紹。圖3-22加載meetingroom模塊(1)在specialpurpose模塊下有一個component-load.xml的模塊加載配置文件，將這行代碼寫入其中相應(yīng)的位置 (2) 同時將specialpurpose模塊下的build.xml里的修改一下，將下面的紅色字加進去。這樣做只是保證了OFBIZ在運行的時候，加載meetingroom模塊而已，OFBIZ并不知道我們要它做什么，讓它具體做什么還要我們在meetingroom模塊內(nèi)進行配置。3meetingroom模塊內(nèi)的配置(1)ofbiz-component.xml:具體配置本模塊內(nèi)的應(yīng)用代碼如下： 以下代碼的作用如下圖：在頁面的模塊標題中顯示MeetingRoom 圖3-3(2)build.xml的配置參考一下別的模塊即可。這樣我們的模塊應(yīng)用環(huán)境就搭建得差不多了，剩下的就是如何實現(xiàn)功能了，以下圖為例，為了實現(xiàn)登陸之后就進入下面的頁面，還有一個“Main”超連接標題，當然，也是連接到本頁面的，下面具體的講解其開發(fā)過程：圖3-4(1) Main小標題的開發(fā)過程： 在component:/meetingroom/webapp/meetingroom/includes/目錄下建一個meetingroomappbar.ftl文件，其代碼如下： MeetingRoom a href=main Main 在meetingroom/widget/meetingroom/CommonScreens.xml里，有一個名為main-decorator的screen，紅色字即為Main的配置代碼。 (2) 主頁main跳轉(zhuǎn) controller.xml里的main配置： MeetingRoomScreens.xml里的findMeetingRoom配置： !-java 腳本語言配置 作用是為程序準備數(shù)據(jù)即下拉框中會議室組名 - !-FreeMarker配置 作用是頁面的內(nèi)容顯示 - (3)當你點擊“select”時，即帶參數(shù)的頁面跳轉(zhuǎn)，配置跟上一部差不多。(4）權(quán)限設(shè)置： OFBIZ的權(quán)限設(shè)置模式是按模塊劃分的，每一個模塊可以是單獨獨立的，它有自己的安全組和權(quán)限。一個安全組可以添加或刪除權(quán)限，組成一個權(quán)限更大的或更小的安全組。默認情況下，這些安全組和權(quán)限是在OFBIZ第一次初始化的時候就加載的，過程如下：圖3-5在specialpurpose下建一個data文件夾，在其下建一個MeetingRoomSecurityData.xml文件（如上圖），在其中配置meetingroom模塊的安全組和權(quán)限，主要有這些安全組和權(quán)限：MEETINGROOMADMIN meetingroom管理員安全組MEETINGROOM_CREATE meetingroom預(yù)訂安全組MEETINGROOM_UPDATE meetingroom編輯安全組MEETINGROOM_DELETE meetingroom取消安全組MEETINGROOM_VIEW meetingroom瀏覽安全組MEETINGROOM_ADMIN mee