AndroMDA开发环境搭建

翻译者：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的首选应用系统构建部署工具。基于项目对象模型（POM）的概念，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了。下节我们将在讲解具体怎样开发日志跟踪系统之前先带大家体验一下我们已经开发完毕的系统，让你在学习过程中也好做到心中有数。