原文: https://howtodoinjava.com/jersey/jax-rs-jersey-hello-world-example/

我已经写了很多关于 JAX-RS RESTEasy 概念以及原理的文章。 现在,我开始探索 Jersey,这是另一个制作 RESTFul 应用的流行框架。 首先,我将在本文中编写我的 HelloWorld 应用,在下一篇文章中将对其进行修改,以显示 Jersey 提供的其他功能的演示。

步骤 1)使用 Maven 创建一个 Eclipse Web 项目

在此处学习制作 Eclipse Maven 项目

步骤 2)更新pom.xml文件中的 Jersey 依赖项

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  2. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  3. <modelVersion>4.0.0</modelVersion>
  4. <groupId>com.howtodoinjava</groupId>
  5. <artifactId>JerseyHelloWorld</artifactId>
  6. <packaging>war</packaging>
  7. <version>1.0-SNAPSHOT</version>
  8. <name>JerseyHelloWorld Maven Webapp</name>
  9. <url>http://maven.apache.org</url>
  10. <repositories>
  11. <repository>
  12. <id>maven2-repository.java.net</id>
  13. <name>Java.net Repository for Maven</name>
  14. <url>http://download.java.net/maven/2/</url>
  15. <layout>default</layout>
  16. </repository>
  17. </repositories>
  18. <dependencies>
  19. <dependency>
  20. <groupId>junit</groupId>
  21. <artifactId>junit</artifactId>
  22. <version>4.11</version>
  23. <scope>test</scope>
  24. </dependency>
  25. <dependency>
  26. <groupId>com.sun.jersey</groupId>
  27. <artifactId>jersey-server</artifactId>
  28. <version>1.17.1</version>
  29. </dependency>
  30. <dependency>
  31. <groupId>com.sun.jersey</groupId>
  32. <artifactId>jersey-core</artifactId>
  33. <version>1.17.1</version>
  34. </dependency>
  35. <dependency>
  36. <groupId>com.sun.jersey</groupId>
  37. <artifactId>jersey-servlet</artifactId>
  38. <version>1.17.1</version>
  39. </dependency>
  40. </dependencies>
  41. <build>
  42. <finalName>JerseyHelloWorld</finalName>
  43. <plugins>
  44. <plugin>
  45. <artifactId>maven-compiler-plugin</artifactId>
  46. <configuration>
  47. <source>1.6</source>
  48. <target>1.6</target>
  49. </configuration>
  50. </plugin>
  51. </plugins>
  52. </build>
  53. </project>

步骤 3)更新web.xml文件。将 servlet 映射到com.sun.jersey.spi.container.servlet.ServletContainer

  1. <!DOCTYPE web-app PUBLIC
  2. "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  3. "http://java.sun.com/dtd/web-app_2_3.dtd" >
  4. <web-app>
  5. <display-name>Archetype Created Web Application</display-name>
  6. <servlet>
  7. <servlet-name>jersey-serlvet</servlet-name>
  8. <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
  9. <init-param>
  10. <param-name>com.sun.jersey.config.property.packages</param-name>
  11. <param-value>com.howtodoinjava.rest</param-value>
  12. </init-param>
  13. <load-on-startup>1</load-on-startup>
  14. </servlet>
  15. <servlet-mapping>
  16. <servlet-name>jersey-serlvet</servlet-name>
  17. <url-pattern>/rest-points/*</url-pattern>
  18. </servlet-mapping>
  19. </web-app>

步骤 4)编写第一个 REST 服务类

由于 JAX-RS 使用了通用注解,因此服务类看起来与 RESTEasy 完全一样。

  1. package com.howtodoinjava.rest;
  2. import javax.ws.rs.GET;
  3. import javax.ws.rs.Path;
  4. import javax.ws.rs.PathParam;
  5. import javax.ws.rs.core.Response;
  6. @Path("/show-on-screen")
  7. public class JerseyHelloWorldService
  8. {
  9. @GET
  10. @Path("/{message}")
  11. public Response getMsg(@PathParam("message") String msg)
  12. {
  13. String output = "Message requested : " + msg;
  14. //Simply return the parameter passed as message
  15. return Response.status(200).entity(output).build();
  16. }
  17. }

测试应用

要在浏览器中的 URL 下面测试应用类型:http://localhost:8080/JerseyHelloWorld/rest-points/show-on-screen/HowToDoInJava_Dot_Com

这将在服务类中调用 REST API 方法,并打印作为路径参数传递的消息。

Jersey HelloWorld 例子 - 图1

Jersey HelloWorld 消息

要下载以上文章的来源,请单击下面的链接。

祝您学习愉快!