Jersey2 + Maven + Tomcat + IntelliJ IDEA 搭建RESTful服务

小鱼儿 2022-06-18 10:57 226阅读 0赞

本文参考以下内容：

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

\[2\] [【Jersey】IntelliJ IDEA + Maven + Jetty + Jersey搭建RESTful服务][Jersey_IntelliJ IDEA _ Maven _ Jetty _ Jersey_RESTful]

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

## 0. 创建新项目 ##

在IntelliJ中创建新项目，选择Java Enterprise -> RESTful Web Service -> Setup libery later.

![742978-20161114102100623-464848694.png][]

## 1. 加入web框架和maven框架 ##

右键单击项目名-> Add Frameworks Support，分别勾选Web Application和Maven。

![742978-20161114103729013-1671495260.png][]

## 3. 在maven中加入jersey依赖 ##

在pom.xml中加入：

![复制代码][copycode.gif]

1 <dependency>
     2     <groupId>org.glassfish.jersey.containers</groupId>
     3     <artifactId>jersey-container-servlet</artifactId>
     4     <version>2.9</version>
     5 </dependency>
     6 <dependency>
     7     <groupId>org.glassfish.jersey.core</groupId>
     8     <artifactId>jersey-client</artifactId>
     9     <version>2.9</version>
    10 </dependency>
    11 <dependency>
    12     <groupId>org.glassfish.jersey.media</groupId>
    13     <artifactId>jersey-media-json-jackson</artifactId>
    14     <version>2.9</version>
    15 </dependency>

![复制代码][copycode.gif]

此时，整个pom.xml文档如下。另外使用maven默认的库下载源文件很慢，可以使用国内镜像，方法可见[maven国内镜像（maven下载慢的解决方法）][maven_maven]。

顺便一提，maven默认的java源值、目标值版本是1.5，可以自行修改成1.8，方法见下面代码。

![ContractedBlock.gif][]

4. 创建源文件

在src/java目录下新建包，如com.test.jersey，在包下新建类HelloWorld.java，写上代码：

![复制代码][copycode.gif]

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!";
        }
    }

![复制代码][copycode.gif]

## 5. 配置servlet ##

编辑web/WEB-INF/web.xml，加入代码：

![复制代码][copycode.gif]

<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>

![复制代码][copycode.gif]

6. 配置Tomcat

点击Run >Edit Configurations… > “\+” > Tomcat Server > Local，加入Tomcat，选择Deployment tab, 点击 “+”, 选择唯一的Artifact，点击"OK"即可。![742978-20161114105444529-1211136419.png][]

## 7. 在输出中加入库文件 ##

选择Project Structure，点击Artifacts，可以右侧Available Elements下面有很多库文件没有包含在输出中。依次双击各个文件即可。

![742978-20161114105816357-366507260.png][]

![742978-20161114110049576-1831543729.png][]

8. 运行Tomcat

运行Tomcat，在浏览器中输入http://localhost:8080/hello，即可看到以下输出：

![742978-20161114110218498-812458969.png][]

[Starting out with Jersey _ Apache Tomcat using_IntelliJ]: https://medium.com/@jamsesso/starting-out-with-jersey-apache-tomcat-using-intellij-6338d93ffd40#.e7f01y91x
[Jersey_IntelliJ IDEA _ Maven _ Jetty _ Jersey_RESTful]: http://blog.csdn.net/gaowenhui2008/article/details/69264309
[742978-20161114102100623-464848694.png]: /images/20220618/f39573a9b2cb4ef194c8d0191ada28d1.png
[742978-20161114103729013-1671495260.png]: /images/20220618/ff054c08e347482e8425129299e1a97c.png
[copycode.gif]: /images/20220618/46b8f313891842f7a72219dfd06c1399.png
[maven_maven]: http://www.cnblogs.com/xiongxx/p/6057558.html
[ContractedBlock.gif]: /images/20220618/64df51fb209543f3b22b5fb4559a78a3.png
[742978-20161114105444529-1211136419.png]: /images/20220618/7b2c9c7491dd4249bd33f578601cb93c.png
[742978-20161114105816357-366507260.png]: /images/20220618/49a826b2c3b148c3a9e9d80ec4eee1cb.png
[742978-20161114110049576-1831543729.png]: /images/20220618/d65145d6a87642f6aad5f1658489488c.png
[742978-20161114110218498-812458969.png]: /images/20220618/a645f8f8b8a04d4f9307cd2ac9124ed9.png