step-by-step构造Maven Jersey Web Application

使用maven创建Jersey Web应用

1. 使用maven创建jersey web应用框架

   $ mvn archetype:generate \

    -DarchetypeArtifactId=jersey-quickstart-webapp \

    -DarchetypeGroupId=org.glassfish.jersey.archetypes \

    -DinteractiveMode=false \

    -DgroupId=com.company.test \

    -DartifactId=jerseyproject \

    -Dpackage=com.company.test.jerseyproject \

    -DarchetypeVersion=2.25.1

2. 修改pom.xml，增加两个dependency

<!-- https://mvnrepository.com/artifact/org.glassfish.jersey.ext/jersey-mvc-jsp -->

<dependency>

       <groupId>org.glassfish.jersey.ext</groupId>

       <artifactId>jersey-mvc-jsp</artifactId>

</dependency>

<!-- https://mvnrepository.com/artifact/javax.servlet/jstl -->

<dependency>

       <groupId>javax.servlet</groupId>

       <artifactId>jstl</artifactId>

       <version>1.2</version>

</dependency>

    最后的pom.xml如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.company.test</groupId>
    <artifactId>jerseyproject</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>jerseyproject</name>

    <build>
        <finalName>jerseyproject</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>
                <inherited>true</inherited>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.glassfish.jersey</groupId>
                <artifactId>jersey-bom</artifactId>
                <version>${jersey.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.glassfish.jersey.containers</groupId>
            <artifactId>jersey-container-servlet-core</artifactId>
            <!-- use the following artifactId if you don't need servlet 2.x compatibility -->
            <!-- artifactId>jersey-container-servlet</artifactId -->
        </dependency>
        <!-- uncomment this to get JSON support
        <dependency>
            <groupId>org.glassfish.jersey.media</groupId>
            <artifactId>jersey-media-moxy</artifactId>
        </dependency>
        -->

		<!-- https://mvnrepository.com/artifact/org.glassfish.jersey.ext/jersey-mvc-jsp -->
		<dependency>
    		<groupId>org.glassfish.jersey.ext</groupId>
    		<artifactId>jersey-mvc-jsp</artifactId>
		</dependency>
		<!-- https://mvnrepository.com/artifact/javax.servlet/jstl -->
		<dependency>
    		<groupId>javax.servlet</groupId>
    		<artifactId>jstl</artifactId>
    		<version>1.2</version>
		</dependency>
    </dependencies>
    <properties>
        <jersey.version>2.25.1</jersey.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
</project>

3. 修改WEB-INF/web.xml增加JSP初始化参数

            <init-param>

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

         <param-value>org.glassfish.jersey.server.mvc.jsp.JspMvcFeature</param-value>

    </init-param>

    <init-param>

         <param-name>jersey.config.server.mvc.templateBasePath.jsp</param-name>

         <param-value>/WEB-INF/jsp</param-value>

    </init-param>

最后的web.xml如下：

<?xml version="1.0" encoding="UTF-8"?>
<!-- This web.xml file is not required when using Servlet 3.0 container,
     see implementation details http://jersey.java.net/nonav/documentation/latest/jax-rs.html -->
<web-app version="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 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <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>com.company.test.jerseyproject</param-value>
        </init-param>
		<init-param>
	        <param-name>jersey.config.server.provider.classnames</param-name>
        	<param-value>org.glassfish.jersey.server.mvc.jsp.JspMvcFeature</param-value>
	    </init-param>
		<init-param>
        	<param-name>jersey.config.server.mvc.templateBasePath.jsp</param-name>
        	<param-value>/WEB-INF/jsp</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>

4.  创建WEB-INF/jsp/hello.jsp页面

<%@page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>  
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<html>  
　　<head>    
　　</head>  
　　<body>  
	 Hello, <c:out value="${it.name}" />
　　</body>  
</html>

5. 修改java代码MyResource.java 

package com.company.test.jerseyproject;

import java.util.HashMap;

import javax.ws.rs.DefaultValue;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;

import org.glassfish.jersey.server.mvc.Viewable;

/**
 * Root resource (exposed at "myresource" path)
 */
@Path("myresource")
public class MyResource {

    /**
     * Method handling HTTP GET requests. The returned object will be sent
     * to the client as "text/plain" media type.
     *
     * @return String that will be returned as a text/plain response.
     */
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String getIt() {
        return "Got it!";
    }

	@GET  
	@Path("/hello")
	public Viewable sayHello(@QueryParam("name") @DefaultValue("World") String name) {  
        HashMap<String, Object> model = new HashMap<String, Object>();  
        model.put("name", name);
        return new Viewable("/hello", model);  
    }  

	@GET
	@Path("/hello1/{param}")
	public Response sayHelloToResponse(@PathParam("param") String msg) {
		String output = "Jersey say : " + msg;
		return Response.status(200).entity(output).build();
	}

    @GET    
    @Path("/hello2/{param}")      
    @Produces("text/plain;charset=UTF-8")    
    public String sayHelloToUTF8(@PathParam("param") String username) {    
        return "Hello " + username;  
    }
}

6. Build and Deploy 

http://localhost:8080/jerseyproject/webapi/myresource/hello
Hello, World 
http://localhost:8080/jerseyproject/webapi/myresource/hello?name=aaaa
Hello, aaaa 
http://localhost:8080/jerseyproject/webapi/myresource/hello1/bbb
Jersey say : bbb
http://localhost:8080/jerseyproject/webapi/myresource/hello2/cccc
Hello cccc