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