JERSEY中文翻译（第一章、Getting Started、1.1.7）

最近发现jersey特别流行，但是中文资料非常少，深感没有资料的痛苦，所以分享一下看到的内容供他人快速入门。

今天翻译第一章、Getting Started。https://jersey.java.net/documentation/1.17/user-guide.html#getting-started

第一章、Getting Started、1.1.7

本章将会告诉你如何使用嵌入式的Grizzly server创建一个Jersey服务，在本章的最后一节也将展现如何使用一段程序来建立一个web应用。

首先它需要依赖jersey的jar包。使用Maven开发，需要设置：jersey-server 和 jersey-grizzly2 两个包，在pom.xml内添加：

<dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-server</artifactId>
    <version>1.17</version>
</dependency>
<dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-grizzly2</artifactId>
    <version>1.17</version>
</dependency>

如果你需要依赖于jersey的快照版本，那么在pom.xml添加：

<repository>
    <id>snapshot-repository.java.net</id>
    <name>Java.net Snapshot Repository for Maven</name>
    <url>https://maven.java.net/content/repositories/snapshots/</url>
    <layout>default</layout>
</repository>

1.1 创建一个资源

创建一个java文件

  1     // The Java class will be hosted at the URI path "/helloworld"
  2     @Path("/helloworld")
  3     public class HelloWorldResource {
  4
  5         // The Java method will process HTTP GET requests
  6         @GET
  7         // The Java method will produce content identified by the MIME Media
  8         // type "text/plain"
  9         @Produces("text/plain")
 10         public String getClichedMessage() {
 11             // Return some cliched textual content
 12             return "Hello World";
 13         }
 14     }

这个一个简单的web应用，URI路径是"/helloword"(第二行)；它支持HTTP的GET方式请求(第六行)；返回的相应头是"text/plain"(第九行)；返回内容是"Hello World"(第十二行)

1.2 部署一个WEB应用

这个程序部署在Grizzle容器内。在你的工程内创建一个java程序

  1 import com.sun.jersey.api.container.grizzly2.GrizzlyServerFactory;
  2 import com.sun.jersey.api.core.DefaultResourceConfig;
  3 import com.sun.jersey.api.core.PackagesResourceConfig;
  4 import com.sun.jersey.api.core.ResourceConfig;
  5 import org.glassfish.grizzly.http.server.HttpServer;
  6
  7 import javax.ws.rs.core.UriBuilder;
  8 import java.io.IOException;
  9 import java.net.URI;
 10 import java.util.HashMap;
 11 import java.util.Map;
 12 import java.util.Map.Entry;
 13
 14 public class Main {
 15
 16     private static URI getBaseURI() {
 17         return UriBuilder.fromUri("http://localhost/").port(9998).build();
 18     }
 19
 20     public static final URI BASE_URI = getBaseURI();
 21
 22     protected static HttpServer startServer() throws IOException {
 23         System.out.println("Starting grizzly...");
 24         ResourceConfig rc = new PackagesResourceConfig("com.sun.jersey.samples.helloworld.resources");
 25         return GrizzlyServerFactory.createHttpServer(BASE_URI, rc);
 26     }
 27
 28     public static void main(String[] args) throws IOException {
 29         HttpServer httpServer = startServer();
 30         System.out.println(String.format("Jersey app started with WADL available at "
 31                 + "%sapplication.wadl\nTry out %shelloworld\nHit enter to stop it...",
 32                 BASE_URI, BASE_URI));
 33         System.in.read();
 34         httpServer.stop();
 35     }
 36 }

用这个主函数，承接Grizzle容器，实现HelloWorldResource。

在24行，设置了当Jersey去哪里查找部署的资源class

在25行，设置了基本的路径和端口号"localhost:9998"，并且返回一个Grizzle的HttpServer。全部的Hello World资源路径是"http://localhost:9998/helloworld"

1.3 测试这个资源

直接访问"http://localhost:9998/helloworld"或者curl "localhost:9998/helloworld"

1.4 事例

创建一个java web程序，HelloWorld-WebApp