翻譯者:Jason S.H.Chen
(英文地址:
http://www.andromda.org/index.php?option=com_content&view=article&id=105:environment-setup&catid=42:getting-started-java&Itemid=89)
環(huán)境設(shè)置
本節(jié)將一步步的指導(dǎo)你完成AndroMDA開發(fā)環(huán)境的設(shè)置。我們假定你工作在Windows操作系統(tǒng)上。
通過此節(jié),你將安裝多種程序。每種程序的推薦安裝路徑以及所需要的其他目錄已列在下面。你可以根據(jù)你的系統(tǒng)配置和個人喜好自由的修改這些目錄。比如,你可以選擇將程序安裝在D盤而不是C盤。無論如何,請注意一件事情,有些程序會因?yàn)槟闼O(shè)置的路徑名中包含空格而不能正常工作。所以,在安裝配置程序過程中盡可能復(fù)制粘貼下面推薦的路徑。
推薦安裝路徑 用途
C:\Documents and Settings\你的用戶名\.m2\repository Maven本地庫
C:\Program Files\Apache Software Foundation\maven-2.0.8 Maven安裝路徑
C:\Program Files\Java\jdk1.6.0_xx JDK
C:\Program Files\Java\jre1.6.0_xx JRE,Java 運(yùn)行引擎
C:\Program Files\MySQL\MySQL Server 5.0 MySQL數(shù)據(jù)庫服務(wù)器
C:\eclipse Eclipse集成開發(fā)環(huán)境(可選)
C:\jboss-4.0.5 JBoss應(yīng)用服務(wù)器
你還需要設(shè)置一些相關(guān)的環(huán)境變量。在控制面板中可完成環(huán)境的設(shè)置(控制面板>系統(tǒng)>高級>環(huán)境變量)。注意:任何程序的安裝目錄被修改后,你必須確保將與之相關(guān)的環(huán)境變量的取值修改與之一致。
準(zhǔn)備開發(fā)環(huán)境
請按照下面的步驟開始準(zhǔn)備AndroMDA的開發(fā)環(huán)境。
安裝Java
請從這里下載JDK6安裝程序并執(zhí)行安裝。此版本是AndroMDA推薦的JDK安裝版本。AndroMDA也支持JDK1.5.我們不再支持JDK1.4.
確保JAVA_HOME環(huán)境變量指向的目錄是JDK的安裝目錄。也許你已經(jīng)設(shè)置了這個環(huán)境變量,但最好還是檢查一下:
1. 進(jìn)入【控制面板】,雙擊【系統(tǒng)】。
2. 選擇【高級】選項(xiàng)卡,點(diǎn)擊【環(huán)境變量】。
3. 查看JAVA_HOME的值是否指向你的JDK安裝目錄。如果不是請編輯JAVA_HOME變量的值,讓他指向JDK的安裝目錄(比如:C:\Program Files\Java\jdk1.6.0_06)。
安裝Maven
Maven是AndroMDA的首選應(yīng)用系統(tǒng)構(gòu)建部署工具。基于項(xiàng)目對象模型(POM)的概念,Maven可以管理一個項(xiàng)目的構(gòu)建,報告和文檔等。如果你熟悉Ant的話,Maven與之有不少相同之處,但Maven提供了更多的功能:
1. 可繼承的構(gòu)建環(huán)境配置,在POM文件(pom.xml)中配置的參數(shù)可以傳遞給所有子項(xiàng)目的POM文件。
2. 標(biāo)準(zhǔn)化的構(gòu)建任務(wù)(清除,構(gòu)建,安裝,部署等)。
3. 能表達(dá)構(gòu)建和部署任務(wù)所依賴的庫,不管是內(nèi)部依賴庫還是外部依賴庫,都必須指明所依賴的具體版本號。
4. 提供一個包含所有項(xiàng)目所依賴的版本的庫文件的倉庫。在系統(tǒng)的構(gòu)建和部署過程中會用到倉庫(有點(diǎn)類似于.net的全局匯編緩存的概念)。
按照下面的步驟安裝Maven2.0.8.
1. 點(diǎn)擊這里下載Maven2.0.8.
2. 將文件解壓到C:\Program Files\Apache Software Foundation這個目錄,一個名為maven-2.0.8的目錄將被創(chuàng)建,此目錄下面就是Maven2.0.8的程序。
注意:如果你使用代理服務(wù)器上網(wǎng)的話,你必須配置Maven使用代理。詳細(xì)的配置你可以在這里找到。
安裝JBoss應(yīng)用服務(wù)器
JBoss應(yīng)用服務(wù)器是一款應(yīng)用很廣泛的開源應(yīng)用服務(wù)器。按照下面的步驟安裝JBoss4.0.5.
1. 點(diǎn)擊這里轉(zhuǎn)到JBoss的下載頁面。
2. 在下載列表上選擇JBoss Application Server version 4.0.5的下載按鈕,系統(tǒng)將把你帶到SourceForge的下載頁面。
3. 點(diǎn)擊名為“jboss-4.0.5GA.zip”的下載鏈接,進(jìn)行下載。
4. 下載完畢,將下載的文件解壓到C盤,一個名為jboss-4.0.4GA的目錄將被創(chuàng)建。此目錄下包含JBoss應(yīng)用服務(wù)器的程序文件。
5. 如果你打算在你的機(jī)器上也安裝Oracle數(shù)據(jù)庫的話,你必須將JBoss的 http端口8080修改成其他端口。Oracle也默認(rèn)使用此端口,而且Oracle的配置不容易修改。如果你要修改JBoss的http端口的話,請打開C:\jboss-4.0.5\server\default\deploy\jbossweb-tomcat55.sar這個目錄下的名為server.xml的文件,將文件中所有8080數(shù)字修改為其他的值,比如9090.這樣即可解決Oracle和JBoss之間的沖突。如果你將8080端口修改成了9090,那么手冊中所有使用到8080端口的地方,對于你來說都是9090端口。
設(shè)置環(huán)境變量
前面我們已經(jīng)通過設(shè)置環(huán)境變量JAVA_HOME講解了怎樣設(shè)置環(huán)境變量。強(qiáng)烈推薦先設(shè)置完下面列出的環(huán)境變量后在繼續(xù)后面的學(xué)習(xí)。為了保持文章的完整性,我們將環(huán)境變量JAVA_HOME也列在了下面。
環(huán)境變量名 環(huán)境變量值 是否必須
JAVA_HOME JAVA安裝目錄,比如C:\Program Files\Java\jdk1.6.0_06 必須
JBOSS_HOME JBoss安裝目錄,比如C:\jboss-4.0.5 必須
M2_HOME Maven安裝目錄,比如C:\Program Files\Apache Software Foundation\maven-2.0.8 必須
M2_REPO Maven本地庫 必須
MAVEN_OPTS 運(yùn)行Maven的JVM參數(shù)(推薦:-XX:MaxPermSize=128m -Xmx512m,構(gòu)建大型項(xiàng)目最好設(shè)置) 可選
PATH 將%JAVA_HOME%\bin;%M2_HOME%\bin添加到PATH值中 必須
測試Maven并創(chuàng)建本地Maven庫
Maven is based on the concept of a central(這句不知道怎樣翻譯合理), local repository located on your machine, where it stores artifacts such as 3rd party libraries as well as components created by you.本地Maven庫存在你的電腦上,在庫中存儲著很多項(xiàng)目需要使用的第三方庫和你自己創(chuàng)建的庫。當(dāng)你創(chuàng)建一個新項(xiàng)目時,你必須創(chuàng)建一個名為pom.xml用于描述項(xiàng)目對象信息的文件。在這個文件中,你告訴maven你的應(yīng)用會依賴哪些第三方庫以及他們的具體版本。當(dāng)Maven開始構(gòu)建應(yīng)用的時候,他會首先從遠(yuǎn)程庫(通過網(wǎng)絡(luò))中獲取項(xiàng)目所依賴的這些庫,并把從遠(yuǎn)程庫獲取的庫復(fù)制到本地庫。因?yàn)檫@樣你以后就可以完全通過本地庫完成構(gòu)建應(yīng)用。默認(rèn)情況下,你的本地庫在“C:\Documents and Settings\{你的用戶名}\.m2\repository”這個目錄下(其中,你的用戶名是只你登錄系統(tǒng)的用戶名)。到目前為止,我們只安裝了Maven程序,還沒有創(chuàng)建本地庫。按照下面的步驟測試你是否已經(jīng)正確安裝了Maven和創(chuàng)建你的本地庫。我們將使用Maven的標(biāo)準(zhǔn)插件創(chuàng)建一個臨時項(xiàng)目進(jìn)行測試,測試完可以刪除臨時項(xiàng)目。
1. 開啟命名提示窗口,將當(dāng)前路徑切換到任何一個臨時文件目錄下,比如c:\temp
2. 執(zhí)行下面的命令檢查你是否正確安裝配置了Mavne:
Mvn --version
3. 窗口中出現(xiàn)如下信息,則標(biāo)示你安裝配置正確。
Maven version:2.0.2
4. 執(zhí)行下面的命令創(chuàng)建一個臨時項(xiàng)目:
mvn archetype:create -DgroupId=testapp -DartifactId=testapp
必須確保在此命令執(zhí)行完畢,你得到的反饋信息是“Build Successful”.有時候會因?yàn)榫W(wǎng)絡(luò)問題導(dǎo)致maven不能下載所有所依賴的庫文件而失敗。如果你也是遇到這個問題的話,你不妨多執(zhí)行幾次上面的命令,直到成功執(zhí)行此命令為止。
5. 到當(dāng)前目錄中去核實(shí)一下,看是否有個名為testapp的臨時項(xiàng)目被創(chuàng)建,同時到上面提到的倉庫路徑目錄去核實(shí)一下本地倉庫是否被創(chuàng)建了。如果這兩項(xiàng)工作都成功地完成,那么你可以刪除剛才測試時所產(chǎn)生的臨時項(xiàng)目了。
安裝AndroMDA插件
下面我們將下載并安裝AndroMDA的maven插件到你的本地maven庫。此插件是Java調(diào)用AndroMDA的入口程序。這事唯一一個需要安裝的AndroMDA文件。其他的文件(比如代碼生成器)將根據(jù)構(gòu)建工作的需要自動下載。按照下面的步驟進(jìn)行安裝:
1. 點(diǎn)擊這里下載AndroMDA插件安裝程序。
2. 在安裝文件在你的本地maven庫的目錄下(C:\Documents and Settings\{你的用戶名}\.m2\repository)進(jìn)行解壓縮。
3. 請確認(rèn)下面的目錄是否存在,存在則繼續(xù)
C:\Documents and Settings\你的用戶名 \.m2\repository\org\andromda\maven\plugins\andromdapp-maven-plugin
4. 創(chuàng)建一個臨時文件夾,比如:c:\andromda-temp
5. 在臨時文件夾中創(chuàng)建一個pom.xml文件,并將下面的內(nèi)容拷貝到pom.xml文件中并保存。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>samples.test</groupId>
<artifactId>test</artifactId>
<version>1.0</version>
<packaging>jar</packaging>
<name>test</name>
<build>
<defaultGoal>compile</defaultGoal>
<plugins>
<plugin>
<groupId>org.andromda.maven.plugins</groupId>
<artifactId>andromdapp-maven-plugin</artifactId>
<version>3.3</version>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<id>andromda</id>
<name>AndroMDA Repository</name>
<url>http://team.andromda.org/maven2</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>andromda</id>
<name>AndroMDA Repository</name>
<url>http://team.andromda.org/maven2</url>
</pluginRepository>
</pluginRepositories>
</project>
6. 打開dos窗口,并將當(dāng)強(qiáng)目錄切換為剛才創(chuàng)建的pom.xml文件所在的目錄,輸入 mvn (不需要帶參數(shù))回車。確保命令執(zhí)行完后,屏幕上顯示的信息是“BUILD SUCCESSFUL”(有時候會因?yàn)榫W(wǎng)絡(luò)的原因不能下載完畢所有需要的庫文件,故不能執(zhí)行成功,如果遇到這種問題,請多執(zhí)行幾次這個命令,直到成功執(zhí)行為止)。
7. 可以將剛才創(chuàng)建的臨時目錄刪除了。
安裝一款UML工具
安裝一款UML建模工具,你能使用他進(jìn)行應(yīng)用系統(tǒng)的建模,并能將創(chuàng)建的模型導(dǎo)成AndroMDA能識別的格式的文檔。AndroMDA目前支持UML1.4/XMI1.2和UML2/EMF幾種格式的文檔。下面列出了推薦使用的UML建模工具大安裝配置鏈接,你可以根據(jù)自己選擇的UML工具參考對應(yīng)的安裝配置鏈接。如果你已經(jīng)安裝了下面推薦的某款UML工具,你也最好看看其相應(yīng)的配置頁面。
ArgoUML(支持UML1.4/XMI1.2)
MagicDraw9.x(支持UML1.4/XMI1.2)
MagicDraw15.5(支持UML2/EMF)
RSM6(Rational Software Modeler/Architect 支持UML2/EMF)
安裝數(shù)據(jù)庫服務(wù)器
安裝任一款Hibernate支持的數(shù)據(jù)庫。點(diǎn)擊這里查看Hibernate所支持的所有數(shù)據(jù)庫的列表。此手冊中我們使用MySQL5.0(一款應(yīng)用非常廣泛的開源數(shù)據(jù)庫)。如果你安裝是Hibernate支持的其他的數(shù)據(jù)庫,請對JBoss和Hibernate的配置做相應(yīng)的調(diào)整。按照下面的步驟安裝配置MySQL.
1. 點(diǎn)擊這里到MySQL的下載頁面。
2. 下載Windows版的安裝程序(確切的說是“Windows(X86)”,不是“Essentials”)。將MySQL安裝在C:\Program Files\MySQL\MySQL Server 5.0目錄下。請記住所使用的端口(port),用戶賬號和密碼。每次你通過控制臺連接數(shù)據(jù)庫都需要用到,在應(yīng)用程序中數(shù)據(jù)庫連接配置中也要用到。
3. 下載安裝MySQL GUI Tool Bundle(MySQL數(shù)據(jù)庫圖形化的管理查詢工具)。
4. 下載MySQL Connector/J version 5.0.4,MySQL的JDBC驅(qū)動程序。解壓到C:\Program Files\MySQL目錄。
5. 將MySQL的JDBC驅(qū)動程序C:\Program Files\MySQL\mysql-connector-java-5.0.4\mysql-connector-java-5.0.4-bin.jar拷貝到JBoss的C:\jboss-4.0.5\server\default\lib目錄。請將mysql-connector-java-5.0.4-bin.jar的文件名改為mysql-connector-java-5.0.4.jar,這樣更符合maven的規(guī)范。有了JDBC驅(qū)動程序,JBoss就可以訪問你的數(shù)據(jù)庫了。
安裝Eclipse(可選)
Eclipse是一款非常流程的開源的JAVA應(yīng)用集成開發(fā)環(huán)境(IDE).AndroMDA并不需要他,但是我們推薦你使用他以提高你的開發(fā)效率。Eclipse用戶應(yīng)該非常高興,因?yàn)锳ndroMDA可以為你們生成項(xiàng)目的.project和.classpath文件。你們只需要簡單地將項(xiàng)目導(dǎo)入Eclipse即可進(jìn)行代碼的編寫了。
你可從這里下載Eclipse.我們推薦下載Eclipse IDE for Java EE Developers這個版本。按照下面的步驟安裝配置Eclipse.
1. 將下載的文件解壓到你的硬盤上,推薦C:\eclipse
2. 編輯C:\eclipse目錄下的eclipse.ini文件以增加分配給Eclipse的內(nèi)存。下面是推薦你向文件中添加的內(nèi)容:
-vmargs
-Xms256m
-Xmx512m
-XX:PermSize=64m
-XX:MaxPermSize=128m
3. 雙擊Eclipse.exe開啟Eclipse.
4. Eclipse會要求你設(shè)置一個存放項(xiàng)目的文件夾。這個文件夾被成為Eclipse的工作區(qū)。將這個目錄設(shè)置為你通常用來保存創(chuàng)建項(xiàng)目的目錄,比如c:\projects目錄。
5. 從【W(wǎng)indow】菜單中選擇【參數(shù)設(shè)置】(Preferences)菜單項(xiàng)。
6. 在出現(xiàn)的面板的左邊依次選擇Java>Build Path>Classpath Variables.
7. 點(diǎn)【新建】(New)。
8. 將“M2_REPO”填寫在名稱文本框(Name),將你本機(jī)的maven庫的路徑(C:\Documents and Settings\{你的用戶名}\.m2\repository,前面所設(shè)置的)填寫在路徑文本框(Path)。當(dāng)導(dǎo)入AndroMDA產(chǎn)生的項(xiàng)目時,項(xiàng)目會根據(jù)此變量查找所引用的Maven庫中的庫文件。
9. 點(diǎn)擊2次【確定】(ok)關(guān)閉所有對話框。
好的,現(xiàn)在我們已經(jīng)將AndroMDA開發(fā)環(huán)境搭建好,我們已經(jīng)準(zhǔn)備好拿日志跟蹤系統(tǒng)來試驗(yàn)AndroMDA了。下節(jié)我們將在講解具體怎樣開發(fā)日志跟蹤系統(tǒng)之前先帶大家體驗(yàn)一下我們已經(jīng)開發(fā)完畢的系統(tǒng),讓你在學(xué)習(xí)過程中也好做到心中有數(shù)。