创建Jersey REST 服务，基于Maven

• 基于JavaSE形式的REST服务

• 创建项目

  我们首选使用 archetypeGroupId 为 org.glassfish.jersey.archetypes 的原型，archetypeArtifactId为 jersey-quickstart-grizzly2 的原型，创建REST服务项目，使用IDEA创建项目如下：

  

  点击OK后，使用该原始模型创建项目。

• 运行服务

  项目创建好后，原始模型已经默认创建了一个REST服务，我们可以直接启动REST服务，进入项目的根目录，执行如下命令构建和启动服务：

  mvnpackage

  mvnexec：java

  会启动REST服务，可以随时通过回车键停止服务，输出如下：

  六月 19, 2017 11:12:23 下午 org.glassfish.grizzly.http.server.NetworkListener start

  信息: Started listener bound to [localhost:8080]

  六月 19, 2017 11:12:23 下午 org.glassfish.grizzly.http.server.HttpServer start

  信息: [HttpServer] Started.

  Jersey app started with WADL available at http://localhost:8080/myapp/application.wadl

  Hit enter to stop it…

  还提供了WADL，通过访问application.wadl可以获取当前REST服务公布的接口：

  <resourcesbase="http://localhost:8080/myapp/">

  <resourcepath="myresource">

  <methodid="getIt"name="GET">

  <response>

  <representationmediaType="text/plain"/>

  </response>

  </method>

  </resource>

  </resources>

• 访问服务

  可以直接访问http://localhost:8080/myapp/myresource就可以访问REST服务，直接访问REST服务，会输出 Got it! 。

• 项目说明

  启动服务的命令mvnexec：java，该命令实际调用了exec-maven-plugin 插件定义的一个值为 java 的 goal ，用以触发mainClass中的main函数，插件配置如下：

  <plugin>

  <groupId>org.codehaus.mojo</groupId>

  <artifactId>exec-maven-plugin</artifactId>

  <version>1.2.1</version>

  <executions>

  <execution>

  <goals>

  <goal>java</goal>

  </goals>

  </execution>

  </executions>

  <configuration>

  <mainClass>org.drsoft.rest.Main</mainClass>

  </configuration>

  </plugin>

  REST服务类为MyResource，其@Path 中定义了资源路径，@GET中定义了GET方法getIt（），@Produces中定义了响应的类型为普通字符串，示例代码如下：

  @Path("myresource")

  public class MyResource {

  @GET

  @Produces(MediaType.TEXT_PLAIN)

  public String getIt() {

  return"Got it!";

  }

  }

  REST服务的单元测试类MyResourceTest，在单元测试类中，在执行单元测试前需要启动服务，并使用JerseyClient中定义的方法来调用REST服务，示例代码如下：

  public class MyResourceTest {

  private HttpServer server;

  private WebTarget target;

  @Before

  publicvoidsetUp() throws Exception {

  // start the server

  server = Main.startServer();

  // create the client

  Client c = ClientBuilder.newClient();

  // uncomment the following line if you want to enable

  // support for JSON in the client (you also have to uncomment

  // dependency on jersey-media-json module in pom.xml and Main.startServer())

  // --

  // c.configuration().enable(new org.glassfish.jersey.media.json.JsonJaxbFeature());

  target = c.target(Main.BASE_URI);

  }

  @After

  publicvoidtearDown() throws Exception {

  server.stop();

  }

  @Test

  publicvoidtestGetIt() {

  String responseMsg = target.path("myresource").request().get(String.class);

  assertEquals("Got it!", responseMsg);

  }

  }

• 基于Servlet容器服务

• 创建项目

  我们首选使用 archetypeGroupId 为 org.glassfish.jersey.archetypes 的原型，archetypeArtifactId为 jersey-quickstart-webapp的原型，创建REST服务项目，使用IDEA创建项目如下：

  

• 运行服务

  由于这个是Web项目，没有main函数，因此必须部署到Servlet容器中，才能将其运行，我们需要配置Tomcat，IDEA的配置如下：

• 点击Run菜单的EditConfiguration，在打开的窗体中增加Tomcat服务配置，指定Tomcat的安装目录，并设置当前站点的部署的虚拟目录名称，如下：

  

  

  点击OK后，就配置好Servlet容器，可以运行服务了

• 访问服务

  服务启动后，我们可以访问http://localhost:8080/RESTWebAPP/webapi/myresource来调用REST服务，会输出Got it!

• 项目说明

  Web根目录的名称为webapp，默认的Servlet容器版本为2.5，并且配置了WEB-INF/web.xml文件来配置REST服务，web.xml配置如下：

  <?xmlversion="1.0"encoding="UTF-8"?>

  <!-- This web.xml file is not required when using Servlet 3.0 container,

  see implementation details -->

  <web-appversion="2.5"xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee ">

  <servlet>

  <servlet-name>Jersey Web Application</servlet-name>

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

  <init-param>

  <param-name>jersey.config.server.provider.packages</param-name>

  <param-value>org.drsoft.rest</param-value>

  </init-param>

  <load-on-startup>1</load-on-startup>

  </servlet>

  <servlet-mapping>

  <servlet-name>Jersey Web Application</servlet-name>

  <url-pattern>/webapi/*</url-pattern>

  </servlet-mapping>

  </web-app>

以上就是创建Jersey REST 服务，基于Maven的详细内容，更多请关注其它相关文章！