翻譯者: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)
環境設置
本節將一步步的指導你完成AndroMDA開發環境的設置。我們假定你工作在Windows操作系統上。
通過此節,你將安裝多種程序。每種程序的推薦安裝路徑以及所需要的其他目錄已列在下面。你可以根據你的系統配置和個人喜好自由的修改這些目錄。比如,你可以選擇將程序安裝在D盤而不是C盤。無論如何,請注意一件事情,有些程序會因為你所設置的路徑名中包含空格而不能正常工作。所以,在安裝配置程序過程中盡可能復制粘貼下面推薦的路徑。
推薦安裝路徑 用途
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 運行引擎
C:\Program Files\MySQL\MySQL Server 5.0 MySQL數據庫服務器
C:\eclipse Eclipse集成開發環境(可選)
C:\jboss-4.0.5 JBoss應用服務器
你還需要設置一些相關的環境變量。在控制面板中可完成環境的設置(控制面板>系統>高級>環境變量)。注意:任何程序的安裝目錄被修改后,你必須確保將與之相關的環境變量的取值修改與之一致。
準備開發環境
請按照下面的步驟開始準備AndroMDA的開發環境。
安裝Java
請從這里下載JDK6安裝程序并執行安裝。此版本是AndroMDA推薦的JDK安裝版本。AndroMDA也支持JDK1.5.我們不再支持JDK1.4.
確保JAVA_HOME環境變量指向的目錄是JDK的安裝目錄。也許你已經設置了這個環境變量,但最好還是檢查一下:
1. 進入【控制面板】,雙擊【系統】。
2. 選擇【高級】選項卡,點擊【環境變量】。
3. 查看JAVA_HOME的值是否指向你的JDK安裝目錄。如果不是請編輯JAVA_HOME變量的值,讓他指向JDK的安裝目錄(比如:C:\Program Files\Java\jdk1.6.0_06)。
安裝Maven
Maven是AndroMDA的首選應用系統構建部署工具?;陧椖繉ο竽P停≒OM)的概念,Maven可以管理一個項目的構建,報告和文檔等。如果你熟悉Ant的話,Maven與之有不少相同之處,但Maven提供了更多的功能:
1. 可繼承的構建環境配置,在POM文件(pom.xml)中配置的參數可以傳遞給所有子項目的POM文件。
2. 標準化的構建任務(清除,構建,安裝,部署等)。
3. 能表達構建和部署任務所依賴的庫,不管是內部依賴庫還是外部依賴庫,都必須指明所依賴的具體版本號。
4. 提供一個包含所有項目所依賴的版本的庫文件的倉庫。在系統的構建和部署過程中會用到倉庫(有點類似于.net的全局匯編緩存的概念)。
按照下面的步驟安裝Maven2.0.8.
1. 點擊這里下載Maven2.0.8.
2. 將文件解壓到C:\Program Files\Apache Software Foundation這個目錄,一個名為maven-2.0.8的目錄將被創建,此目錄下面就是Maven2.0.8的程序。
注意:如果你使用代理服務器上網的話,你必須配置Maven使用代理。詳細的配置你可以在這里找到。
安裝JBoss應用服務器
JBoss應用服務器是一款應用很廣泛的開源應用服務器。按照下面的步驟安裝JBoss4.0.5.
1. 點擊這里轉到JBoss的下載頁面。
2. 在下載列表上選擇JBoss Application Server version 4.0.5的下載按鈕,系統將把你帶到SourceForge的下載頁面。
3. 點擊名為“jboss-4.0.5GA.zip”的下載鏈接,進行下載。
4. 下載完畢,將下載的文件解壓到C盤,一個名為jboss-4.0.4GA的目錄將被創建。此目錄下包含JBoss應用服務器的程序文件。
5. 如果你打算在你的機器上也安裝Oracle數據庫的話,你必須將JBoss的 http端口8080修改成其他端口。Oracle也默認使用此端口,而且Oracle的配置不容易修改。如果你要修改JBoss的http端口的話,請打開C:\jboss-4.0.5\server\default\deploy\jbossweb-tomcat55.sar這個目錄下的名為server.xml的文件,將文件中所有8080數字修改為其他的值,比如9090.這樣即可解決Oracle和JBoss之間的沖突。如果你將8080端口修改成了9090,那么手冊中所有使用到8080端口的地方,對于你來說都是9090端口。
設置環境變量
前面我們已經通過設置環境變量JAVA_HOME講解了怎樣設置環境變量。強烈推薦先設置完下面列出的環境變量后在繼續后面的學習。為了保持文章的完整性,我們將環境變量JAVA_HOME也列在了下面。
環境變量名 環境變量值 是否必須
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 運行Maven的JVM參數(推薦:-XX:MaxPermSize=128m -Xmx512m,構建大型項目最好設置) 可選
PATH 將%JAVA_HOME%\bin;%M2_HOME%\bin添加到PATH值中 必須
測試Maven并創建本地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庫存在你的電腦上,在庫中存儲著很多項目需要使用的第三方庫和你自己創建的庫。當你創建一個新項目時,你必須創建一個名為pom.xml用于描述項目對象信息的文件。在這個文件中,你告訴maven你的應用會依賴哪些第三方庫以及他們的具體版本。當Maven開始構建應用的時候,他會首先從遠程庫(通過網絡)中獲取項目所依賴的這些庫,并把從遠程庫獲取的庫復制到本地庫。因為這樣你以后就可以完全通過本地庫完成構建應用。默認情況下,你的本地庫在“C:\Documents and Settings\{你的用戶名}\.m2\repository”這個目錄下(其中,你的用戶名是只你登錄系統的用戶名)。到目前為止,我們只安裝了Maven程序,還沒有創建本地庫。按照下面的步驟測試你是否已經正確安裝了Maven和創建你的本地庫。我們將使用Maven的標準插件創建一個臨時項目進行測試,測試完可以刪除臨時項目。
1. 開啟命名提示窗口,將當前路徑切換到任何一個臨時文件目錄下,比如c:\temp
2. 執行下面的命令檢查你是否正確安裝配置了Mavne:
Mvn --version
3. 窗口中出現如下信息,則標示你安裝配置正確。
Maven version:2.0.2
4. 執行下面的命令創建一個臨時項目:
mvn archetype:create -DgroupId=testapp -DartifactId=testapp
必須確保在此命令執行完畢,你得到的反饋信息是“Build Successful”.有時候會因為網絡問題導致maven不能下載所有所依賴的庫文件而失敗。如果你也是遇到這個問題的話,你不妨多執行幾次上面的命令,直到成功執行此命令為止。
5. 到當前目錄中去核實一下,看是否有個名為testapp的臨時項目被創建,同時到上面提到的倉庫路徑目錄去核實一下本地倉庫是否被創建了。如果這兩項工作都成功地完成,那么你可以刪除剛才測試時所產生的臨時項目了。
安裝AndroMDA插件
下面我們將下載并安裝AndroMDA的maven插件到你的本地maven庫。此插件是Java調用AndroMDA的入口程序。這事唯一一個需要安裝的AndroMDA文件。其他的文件(比如代碼生成器)將根據構建工作的需要自動下載。按照下面的步驟進行安裝:
1. 點擊這里下載AndroMDA插件安裝程序。
2. 在安裝文件在你的本地maven庫的目錄下(C:\Documents and Settings\{你的用戶名}\.m2\repository)進行解壓縮。
3. 請確認下面的目錄是否存在,存在則繼續
C:\Documents and Settings\你的用戶名 \.m2\repository\org\andromda\maven\plugins\andromdapp-maven-plugin
4. 創建一個臨時文件夾,比如:c:\andromda-temp
5. 在臨時文件夾中創建一個pom.xml文件,并將下面的內容拷貝到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窗口,并將當強目錄切換為剛才創建的pom.xml文件所在的目錄,輸入 mvn (不需要帶參數)回車。確保命令執行完后,屏幕上顯示的信息是“BUILD SUCCESSFUL”(有時候會因為網絡的原因不能下載完畢所有需要的庫文件,故不能執行成功,如果遇到這種問題,請多執行幾次這個命令,直到成功執行為止)。
7. 可以將剛才創建的臨時目錄刪除了。
安裝一款UML工具
安裝一款UML建模工具,你能使用他進行應用系統的建模,并能將創建的模型導成AndroMDA能識別的格式的文檔。AndroMDA目前支持UML1.4/XMI1.2和UML2/EMF幾種格式的文檔。下面列出了推薦使用的UML建模工具大安裝配置鏈接,你可以根據自己選擇的UML工具參考對應的安裝配置鏈接。如果你已經安裝了下面推薦的某款UML工具,你也最好看看其相應的配置頁面。
ArgoUML(支持UML1.4/XMI1.2)
MagicDraw9.x(支持UML1.4/XMI1.2)
MagicDraw15.5(支持UML2/EMF)
RSM6(Rational Software Modeler/Architect 支持UML2/EMF)
安裝數據庫服務器
安裝任一款Hibernate支持的數據庫。點擊這里查看Hibernate所支持的所有數據庫的列表。此手冊中我們使用MySQL5.0(一款應用非常廣泛的開源數據庫)。如果你安裝是Hibernate支持的其他的數據庫,請對JBoss和Hibernate的配置做相應的調整。按照下面的步驟安裝配置MySQL.
1. 點擊這里到MySQL的下載頁面。
2. 下載Windows版的安裝程序(確切的說是“Windows(X86)”,不是“Essentials”)。將MySQL安裝在C:\Program Files\MySQL\MySQL Server 5.0目錄下。請記住所使用的端口(port),用戶賬號和密碼。每次你通過控制臺連接數據庫都需要用到,在應用程序中數據庫連接配置中也要用到。
3. 下載安裝MySQL GUI Tool Bundle(MySQL數據庫圖形化的管理查詢工具)。
4. 下載MySQL Connector/J version 5.0.4,MySQL的JDBC驅動程序。解壓到C:\Program Files\MySQL目錄。
5. 將MySQL的JDBC驅動程序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的規范。有了JDBC驅動程序,JBoss就可以訪問你的數據庫了。
安裝Eclipse(可選)
Eclipse是一款非常流程的開源的JAVA應用集成開發環境(IDE).AndroMDA并不需要他,但是我們推薦你使用他以提高你的開發效率。Eclipse用戶應該非常高興,因為AndroMDA可以為你們生成項目的.project和.classpath文件。你們只需要簡單地將項目導入Eclipse即可進行代碼的編寫了。
你可從這里下載Eclipse.我們推薦下載Eclipse IDE for Java EE Developers這個版本。按照下面的步驟安裝配置Eclipse.
1. 將下載的文件解壓到你的硬盤上,推薦C:\eclipse
2. 編輯C:\eclipse目錄下的eclipse.ini文件以增加分配給Eclipse的內存。下面是推薦你向文件中添加的內容:
-vmargs
-Xms256m
-Xmx512m
-XX:PermSize=64m
-XX:MaxPermSize=128m
3. 雙擊Eclipse.exe開啟Eclipse.
4. Eclipse會要求你設置一個存放項目的文件夾。這個文件夾被成為Eclipse的工作區。將這個目錄設置為你通常用來保存創建項目的目錄,比如c:\projects目錄。
5. 從【Window】菜單中選擇【參數設置】(Preferences)菜單項。
6. 在出現的面板的左邊依次選擇Java>Build Path>Classpath Variables.
7. 點【新建】(New)。
8. 將“M2_REPO”填寫在名稱文本框(Name),將你本機的maven庫的路徑(C:\Documents and Settings\{你的用戶名}\.m2\repository,前面所設置的)填寫在路徑文本框(Path)。當導入AndroMDA產生的項目時,項目會根據此變量查找所引用的Maven庫中的庫文件。
9. 點擊2次【確定】(ok)關閉所有對話框。
好的,現在我們已經將AndroMDA開發環境搭建好,我們已經準備好拿日志跟蹤系統來試驗AndroMDA了。下節我們將在講解具體怎樣開發日志跟蹤系統之前先帶大家體驗一下我們已經開發完畢的系統,讓你在學習過程中也好做到心中有數。