前提及资源准备
项目需要,做一个RESTful架构的web服务,结构为IntelliJ + Tomcat + Maven + Jersey
, 大家明白意思就好,IDE和web容器和依赖工具和库都混着交代了。
创建工程需要的资源如下:
- IntelliJ Ultimate版本 (请尽可能购买正版软件)
- Tomcat
- Maven
- JDK
工程模板选择
打开IntelliJ新建工程,选择Java Enterprise -> Web Application
,如图:
之所以没有选择
Java Enterprise -> RESTful Web Service
是因为我们要使用Maven做依赖去下载Jersey库,就不下载到本地了,以后部署起来也方便[其实也有原因是因为直接创建的RESTful Web Service跑起来总报错还找不到原因,但是用了Maven依赖库就没有问题,知道的小伙伴可以告诉留言我]; 同时也适合我们一步步前进,来验证环境搭建是否正确。
自动生成的工程结构如下:
让普通web服务先运行起来
-
首先创建一个运行配置,位置如图
-
在接下来的页面,添加一个Tomcat server,如图:
-
命名你的配置,添加tomcat home,然后fix deploy问题,如图:
- 修改index.jsp 在<body>中加入Hello REST字符串,然后运行
会看到浏览器自动打开http://localhost:8080/
并显示出你的Hello REST字符串
添加REST环境支持
- 在工程根目录下创建pom.xml,然后加入代码如下:
<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.yhzhou.test</groupId>
<artifactId>demo</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.glassfish.jersey.containers</groupId>
<artifactId>jersey-container-servlet</artifactId>
<version>2.22.2</version>
</dependency>
</dependencies>
</project>
- 右键pom.xml,在菜单中选择
Add as Maven Project
,然后你可以看到IntelliJ在帮我们下载依赖,完成后,工程窗口下就变成了下图的样子:
- 根据你上面填写的groupId来在src下创建目录
com/yhzhou/test
,并创建java类Hello
,内容如下:
package com.yhzhou.test;
/**
* Created by yhzhou on 4/11/16.
*/
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
@Path("/hello")
public class Hello {
// This method is called if TEXT_PLAIN is request
@GET
@Produces(MediaType.TEXT_PLAIN)
public String sayPlainTextHello() {
return "Hello Jersey";
}
// This method is called if XML is request
@GET
@Produces(MediaType.TEXT_XML)
public String sayXMLHello() {
return "<?xml version=\"1.0\"?>" + "<hello> Hello Jersey" + "</hello>";
}
// This method is called if HTML is request
@GET
@Produces(MediaType.TEXT_HTML)
public String sayHtmlHello() {
return "<html> " + "<title>" + "Hello Jersey" + "</title>"
+ "<body><h1>" + "Hello Jersey" + "</body></h1>" + "</html> ";
}
}
- 修改web/WEB-INFO/web.xml内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<servlet>
<servlet-name>JAX-RS Servlet</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.yhzhou.test</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>JAX-RS Servlet</servlet-name>
<url-pattern>/api/*</url-pattern>
</servlet-mapping>
</web-app>
注意上面的com.yhzhou.test
应该是你最终提供RESTful服务代码所在的包名。
- 选择菜单上File->Project Structure...,按照下图,把项目依赖的lib发布到WEB-INFO/lib下, 然后apply。
- 运行,访问
http://localhost:8080/api/hello
,看到Hello Jersey。
代码下载