Jersey 2 + Maven + Tomcat + IntelliJ IDEA 搭建RESTful服務

　　本文參考以下內容：

[1] Starting out with Jersey & Apache Tomcat using IntelliJ

[2] 【Jersey】IntelliJ IDEA + Maven + Jetty + Jersey搭建RESTful服務

 　　感謝兩位作者。

 　　網上很多文章都是用Jersey 1 搭建的，不能用Jersey 2的新特性，在此我分享一種Jersey 2的搭建方法。

0. 創建新項目

　　在IntelliJ中創建新項目，選擇Java Enterprise -> RESTful Web Service -> Setup libery later.

1. 加入web框架和maven框架

　　右鍵單擊項目名-> Add Frameworks Support，分別勾選Web Application和Maven。

3. 在maven中加入jersey依賴

　　在pom.xml中加入：

<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
    <version>2.9</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.core</groupId>
    <artifactId>jersey-client</artifactId>
    <version>2.9</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-json-jackson</artifactId>
    <version>2.9</version>
</dependency>

　　此時，整個pom.xml文檔如下。另外使用maven默認的庫下載源文件很慢，可以使用國內鏡像，方法可見maven國內鏡像（maven下載慢的解決方法）。

　　順便一提，maven默認的java源值、目標值版本是1.5，可以自行修改成1.8，方法見下面代碼。

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>cn.test</groupId>
    <artifactId>test</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>test</name>

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet</artifactId>
            <version>2.9</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.core</groupId>
            <artifactId>jersey-client</artifactId>
            <version>2.9</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.media</groupId>
            <artifactId>jersey-media-json-jackson</artifactId>
            <version>2.9</version>
        </dependency>
    </dependencies>
</project>

4. 創建源文件

　　在src/java目錄下新建包，如com.test.jersey，在包下新建類HelloWorld.java，寫上代碼：

package com.test.jersey;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;

@Path("/hello")
public class HelloWorld {
    //GET注解設置接受請求類型為GET
    @GET
    //Produces表明發送出去的數據類型為text/plain
    // 與Produces對應的是@Consumes，表示接受的數據類型為text/plain
    @Produces("text/plain")
    public String getMessage() {
        return "Hello world!";
    }
}

5. 配置servlet

　　編輯web/WEB-INF/web.xml，加入代碼：

<servlet>
    <servlet-name>test</servlet-name>
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>

    <init-param>
        <param-name>jersey.config.server.provider.packages</param-name>
        <param-value>com.test.jersey</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>test</servlet-name>
    <url-pattern>/*</url-pattern>
</servlet-mapping>

6. 配置Tomcat

　　點擊Run >Edit Configurations… > “+” > Tomcat Server > Local，加入Tomcat，選擇Deployment tab, 點擊 “+”, 選擇唯一的Artifact，點擊"OK"即可。

7. 在輸出中加入庫文件

　　選擇Project Structure，點擊Artifacts，可以右側Available Elements下面有很多庫文件沒有包含在輸出中。依次雙擊各個文件即可。

8. 運行Tomcat

　　運行Tomcat，在瀏覽器中輸入http://localhost:8080/hello，即可看到以下輸出：