Ubuntu下Maven+Eclipse+Jersey开发配置

        本文主要参考了Oracle Java社区的《Apache Maven 入门篇》、许晓斌大大的《Maven实战》一书，再结合自己的实际操作。

一、Maven的安装与配置

（1）下载和安装

首先确保你的电脑里已经正确的安装了JDK，查看方法和运行结果如下。

eaton@eaton:~$ echo $JAVA_HOME/usr/java/jdk1.8.0_20eaton@eaton:~$ java -versionjava version "1.8.0_20"Java(TM) SE Runtime Environment (build 1.8.0_20-b26)Java HotSpot(TM) Server VM (build 25.20-b23, mixed mode)eaton@eaton:~$ 

若出现如上的结果，说明电脑里已经安装JDK成功。

然后去官网下载Maven的安装文件：http://maven.apache.org/download.cgi。（注：在该页的最后给出了Maven的安装指南）

将下载下来的安装包拷贝到/usr/local/apache-maven中，然后解压缩：

cp apache-maven-3.2.3-bin.tar.gz /usr/local/apache-maven/cd /usr/local/apache-maven/tar zxvf apache-maven-3.2.3-bin.tar.gz

现在已经创建好了一个Maven安装目录apache-maven-3.2.3，虽然直接使用该目录配置环境变量之后就能使用Maven了，但这里我更推荐做法是，在安装目录旁平行地创建一个符号链接，以方便日后的升级。

root@eaton:/usr/local/apache-maven# ln -s apache-maven-3.2.3 apache-mavenroot@eaton:/usr/local/apache-maven# ls -l总用量 4lrwxrwxrwx 1 root root   18 11月 16 18:15 apache-maven -> apache-maven-3.2.3drwxr-xr-x 6 root root 4096 11月 16 18:10 apache-maven-3.2.3

接下来配置环境变量。编辑/etc/profile文件，在文件的最后添加两行命令：

export M2_HOME=/usr/local/apache-maven/apache-mavenexport PATH=$PATH:$M2_HOME/bin

保存，然后执行一下

source /etc/profile

至此安装完成，我们可以测试一下，输入

mvn -version

若出现

Java version: 1.8.0_20, vendor: Oracle CorporationJava home: /usr/java/jdk1.8.0_20/jreDefault locale: zh_CN, platform encoding: UTF-8OS name: "linux", version: "3.13.0-32-generic", arch: "i386", family: "unix"

说明配置成功。

（2）编写HelloWorld

运行如下命令创建一个Maven项目

mvn archetype:create -DgroupId=com.ustc.helloworld -DartifactId=helloworld -DpackageName=com.ustc.helloworld

使用tree命令，查看该项目的目录结构：

接下来在本项目的根文件下构建并打包该程序：

cd /home/eaton/mycode/helloworldmvn package

成功后，再次使用tree命令查看项目的文件结构：

可以看到，maven 在 helloworld 下面建立了一个新的目录 target/ ，构建打包后的 jar 文件 helloworld-1.0-SNAPSHOT.jar 就存放在这个目录下。编译后的 class 文件放在 target/classes/ 目录下面，测试 class 文件放在 target/test-classes/ 目录下面。

为了验证我们的程序能运行，执行下面的命令：

java -cp target/helloworld-1.0-SNAPSHOT.jar com.mycompany.helloworld.App

执行如下:

出现Hello World！ 程序运行成功。

二、Eclipse下Maven开发环境搭建

（1）安装m2eclipse插件

要用Eclipse构建Maven项目，我们需要先安装meeclipse插件。

打开Eclipse，点击Help->Eclipse Marketplace搜索到插件Maven Integration for Eclipse 并点击安装即可，如下图所示：

（2）创建Maven web项目

点击Eclipse菜单栏File->New->Ohter->Maven得到如下图所示对话框：

选中Maven Project并点击Next，到下一个对话框继续点击Next得到如下对话框：

搜索并找到一个webapp，如上maven-archetype-webapp，选中并且下一步：

简单解释一下 Group Id、Artifact Id、Version 和 Package：
groupId：group 翻译成中文就是组、集团的意识，groupId就是这样一个组或集团的ID标识，就拿 Apache 来说好了，Apache 大家都不陌生吧，Apache 官网上有非常多的项目，每个项目里面肯定能找得到 org.apache.xxxx，而 org.apache 就是这里说的 groupId
artifactId：还是拿 Apache 来说，Apache 官网上有非常多的项目，而每个项目的名字就是这里的 artifactId，换句话说，artifactId 就是你的项目名
version：这个就没有什么好解释的了吧，是项目版本的意思
package：这个也没什么好说的，就是 groupId.artifactId，创建的时候会自动帮你补全，如果没有自动帮你补全就自己手动敲上去
好，下面来看创建出来的urlrewrite-maven-example的目录结构：

说明：
src/main/resources：用来存放资源文件(默认会帮你创建这个资源文件夹)
src/main/java：用来存放 java 源码文件(需要自己手动创建)
src/main/test：用来存放测试代码(需要自己手动创建，也有人习惯命名为：src/test)@
target：是用来存放 Maven 编译好的字节码的地方
Maven Dependencies：里面放的是 maven 管理的 jar 文件

编辑一下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>com.ustc</groupId>  <artifactId>maven-demo</artifactId>  <packaging>war</packaging>  <version>1.0</version>  <name>maven-demo Maven Webapp</name>  <url>http://maven.apache.org</url>  <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>      <version>3.8.1</version>      <scope>test</scope>    </dependency>  </dependencies>  <build>    <finalName>maven-demo</finalName>    <plugins>      <plugin>        <groupId>org.mortbay.jetty</groupId>        <artifactId>maven-jetty-plugin</artifactId>        <version>6.1.10</version>        <configuration>          <scanIntervalSeconds>2</scanIntervalSeconds>        </configuration>      </plugin>    </plugins>  </build></project>

这里使用了maven-jetty-plugin 插件，jetty服务器比Tomcat在这里更加的方便轻巧。

编辑完成之后，选中项目，右键Run As -> Maven build

选中项目，右键选择 Run As --> Maven build
Name：根据需要，自己取个名
Goals：输入要执行的 maven 命令
其余的不用管，直接点击 Run

控制台上显示：

......[INFO] Web defaults = org/mortbay/jetty/webapp/webdefault.xml[INFO] Web overrides =  none[INFO] Webapp directory = /home/eaton/java/workspace/maven-demo/src/main/webapp[INFO] Starting jetty 6.1.10 ...[INFO] jetty-6.1.10[INFO] No Transaction manager found - if your webapp requires one, please configure one.[INFO] Started SelectChannelConnector@0.0.0.0:8080[INFO] Started Jetty Server[INFO] Starting scanner at interval of 2 seconds.

jetty服务器启动成功，在浏览器中访问：http://localhost:8080/maven-demo/

运行成功。

点击控制台上的红色按钮即可关闭jetty服务器。

三、搭建简单的基于Jersey框架的项目

（1）新建Maven项目

打开Eclipse，[File]->[New]->[Other...]，在select a wizard页面中选择[Maven]->[Maven Project]，点击[Next]->[Next]

在接下来的New Maven Project中，[catalog]后面选择[All Catalogs]，[Filter]后面搜索:jersey，在下面选jersey-quickstart-grizzly，然后点击[Next]。如图所示：

注意：在这里搜索jersey的时候可能下面搜索不到如上图所示的jersey的archetypes，这就需要我们自己去手动添加，具体的过程请参见我的另一篇文章：Eclipse增加Maven Archetype Catalogs。

填写本项目的包、组信息：

点击Finish。

生成后的项目结构如下图，其中Main.java是grizzly web server启动的Java小应用程序, MyResource是自动生成第一个REST Resource类，包含了一个简单的GET请求的资源。

（2）运行jersey项目

选中项目，右键选择[Run as]->[Maven build...]

Name随便起一个，然后Goals填写exec:java，然后单击[Run]，控制台出现如下提示，说明启动成功。

访问http://localhost:9998/application.wadl，如下图所示，这是生成的REST资源描述语言：

访问生成的测试资源http:localhost:9998/myresource，如下图所示，看到“Got it”，说明你成功的体验了Jersey的第一个Hello World程序！

最后在控制台内输入Exter，服务器关闭。