Eclipse + Jersey 发布RESTful WebService（一）了解Maven和Jersey，创建一个WS项目（成功！）

一、下文中需要的资源地址汇总

Maven
- Apache Maven网站 http://maven.apache.org/
- Maven下载地址: http://maven.apache.org/download.cgi
Jersey
- Jersey（JAX-RS 2.1 / Jersey 2.26+）下载：https://jersey.github.io/download.html
  - Jersey JAX-RS 2.1 RI bundle bundle contains the JAX-RS 2.1 API jar, all the core Jersey module jars as well as all the required 3rd-party dependencies.
  - Jersey 2.26 Examples bundle provides convenient access to the Jersey 2 examples for off-line browsing.
- Jersey 2.26 API Documentation在线DOC：https://jersey.github.io/apidocs/latest/jersey/index.html
findJAR
- 如果需要其他Jar包，可以去findJAR网站下载：http://www.findjar.com/index.x

二、Jersey是什么？了解一下

Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范。

它扩展了JAX-RS 参考实现，提供了更多的特性和工具，可以进一步地简化 RESTful service 和 client 开发。

尽管相对年轻，它已经是一个产品级的 RESTful service 和 client 框架。与Struts类似，它同样可以和hibernate,spring框架整合。

由于Struts2+hibernate+spring整合在市场的占有率太高，所以很少一部分人去关注Jersey。

Jersey1.X的版本是sun公司提供的独立的jar包，在2.X版本中，已经将jersey放在glassfish下（开源）。

（上图原文地址：http://dyygusi.iteye.com/blog/2148029?utm_source=tuicool）

Jersey系列文章：

三、学Jersey前，先看看Maven

特别详细的配置Maven的文章，没什么可多说的，照做即可：原文地址：https://blog.csdn.net/java_2017_csdn/article/details/77450598/

【下面是我做的Step by Step截屏】

第一步、下载Maven，配置settings.xml文件

Maven下载地址: http://maven.apache.org/download.cgi

下载后放在C根目录下。打开settings.xml文件编辑。

编辑的目的是让我们的Maven项目能使用阿里云提供的Maven镜像库提升速度。

如果不做任何配置，默认Maven项目会自动连接使用maven中央库也是OK的。但是，由于中央库在国外, 受到中国防火墙等因素影响，其访问速度很慢, 只有连接到国内镜像库（例如阿里云）才能提高Maven运行速度。

settings.xml文件有2种修改方法：

（1）省事的，把下面“替换settings.xml内容”的内容替换到你本机的settings.xml文件即可，全部替换，原来的文件内容不留。

<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    
    <!--
    配置本地MAVEN仓库位置，默认在：C:\Users\机器名\.m2\repository
    <localRepository>D:\Program Files\mvn\</localRepository>  
    ** Eclipse->Windows->Preferences->java->Build Path->Classpath Variables 
    -->
    
    <pluginGroups>
    </pluginGroups>

    <proxies>
    </proxies>

    <servers>
    </servers>

    <mirrors>
        <mirror>
            <id>aliyun</id>
            <name>aliyun Maven</name>
            <mirrorOf>*</mirrorOf>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        </mirror>
    </mirrors>
    
    <profiles>
    </profiles>
    
    <activeProfiles>
    </activeProfiles>
</settings>

替换settings.xml内容

（2）不懂xml语言，想知道发生了什么的，往下看。啰嗦几句：

打开settings.xml文件，里面是一个带格式的xml标准文件。用括住的部分是注释。例如：

<!-- interactiveMode
   | This will determine whether maven prompts you when it needs input. If set to false,
   | maven will use a sensible default value, perhaps based on some other setting, for
   | the parameter in question.
   |
   | Default: true
  <interactiveMode>true</interactiveMode>
  -->

去掉注释，你会发现这个文件真正的内容就下面这么多，画圈的每个成对的<>标签中间是具体内容，目前里面都是空。

而我们修改的就是在<mirrors></mirrors>中间添加一段阿里云提供的Maven镜像服务器的配置说明：

<mirror> <id>aliyun</id> <name>aliyun Maven</name> <mirrorOf>*</mirrorOf> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> </mirror>

添加部分：

    <!--
    配置本地MAVEN仓库位置，默认在：C:\Users\机器名\.m2\repository
    <localRepository>D:\Program Files\mvn\</localRepository>  
    ** Eclipse->Windows->Preferences->java->Build Path->Classpath Variables 
    -->
    <mirrors>
        <mirror>
            <id>aliyun</id>
            <name>aliyun Maven</name>
            <mirrorOf>*</mirrorOf>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        </mirror>
    </mirrors>
    
    <profiles>
    </profiles>
    
    <activeProfiles>
    </activeProfiles>
</settings>

添加完毕，文件变成这个样子：

阿里云Maven镜像服务器URL: http://maven.aliyun.com/nexus/content/groups/public/，直接在浏览器打开，能看到下面类似的内容就是能连通。

Maven有多方便我还说不好，至少一个显而易见的好处是项目里用到的Jar包不用到处找了，配好Maven，直接从阿里云服务器关联到Project使用。具体本文稍后会介绍。

第二步、配置Eclipse的Maven环境

菜单：Windows→Preference（到现在还记不住这个菜单的面壁1分钟）

只修改Global Setting，指向本文第一步修改好的settings.xml文件，完成。

想检查一下是否配置OK了，打开Maven视图。菜单：Windows→Show View→Other…（到现在还记不住这个菜单的再面壁1分钟）

可以看见Global Repositories里有2项，central中央库就是官网（外网）镜像，aliyun阿里云就是我们在第一步配置的（国内网）镜像。

第三步、创建一个Maven Project

菜单：File→New→Other…（到现在还记不住这个菜单的怎么办？你说怎么办？）

选择：创建一个简单的项目

起名：MavenProj

创建成功。目录结构：

因为这个步骤必须连接到Maven服务器获取相关信息, 如果配置和网络有故障则这个步骤就会出现错误!如果出现错误请使用浏览器检测是否能够访问Maven服务器的URL.

阿里云Maven镜像服务器URL: http://maven.aliyun.com/nexus/content/groups/public/，直接在浏览器打开看看吧。

第四步、添加Jar包（依赖组件）

这一步原文是这样写的↓ 我点了一下Rebuild Index，画面没有任何变化。

暂时忽略上面的操作，开始添加Jar包（依赖组件），打开pom.xml文件（工程最下方），原始的文件长这样：

注意这里有2个Tab：Dependencies 和 pom.xml。其实就是2个视图，可视化视图Wizard和源代码视图。Eclipse基本在可以可视化的地方都提供了这种便利。

点开Dependencies视图，点Add，把要添加的jar包名称输入，例如：dom4j

注：如果没有上一步的Rebuild Index，我输入了dom4j，Search Results框中也没有同时出现任何内容。

当Rebuild Index了大概20分钟后，下面的一切才顺利。在输入dom4j的同时，下面的结果框会实时反映出内容。

当然，如果你不想白白浪费20分钟，基于进入下一步，没问题。往下看。

如果不想等20分钟，可以这样：

打开pom.xml文件，点开源文件视图，把下面的代码copy到对应的位置保存即可：

  <dependencies>
      <dependency>
          <groupId>dom4j</groupId>
          <artifactId>dom4j</artifactId>
          <version>1.6.1</version>
      </dependency>
  </dependencies>