目录
概念
创建基本web框架
修改pom依赖
使用Jersey创建rest服务
部署到tomcat
Demo下载地址
参考文献
概念
JAX-RS是JAVA EE6 引入的一个新技术。 JAX-RS即Java API for RESTful Web Services,是一个Java 编程语言的应用程序接口,支持按照表述性状态转移(REST)架构风格创建Web服务。JAX-RS使用了Java SE5引入的Java注解来简化Web服务的客户端和服务端的开发和部署。
基于JAX-RS实现的框架有Jersey,RESTEasy等,以下教程是使用Jersey框架
创建基本web框架
- maven创建
mvn archetype:generate -DgroupId=com.ash -DartifactId=test-jax-rs -DarchetypeArtifactId=maven-archetype-webapp
- 导入Eclipse
修改pom依赖
- servlet
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>
- Jersey的核心服务端实现
<dependency>
<groupId>org.glassfish.jersey.core</groupId>
<artifactId>jersey-server</artifactId>
<version>2.25.1</version>
</dependency>
- Jersey运行环境需要依赖的jar包,根据运行的环境的不同依赖的container不同。
<dependency>
<groupId>org.glassfish.jersey.containers</groupId>
<artifactId>jersey-container-servlet</artifactId>
<version>2.25.1</version>
</dependency>
添加以上依赖,环境算是搭建好了,下面创建一个简单的jersey实例
使用jersey创建rest服务
- 添加如下class
- 修改web.xml
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<servlet>
<servlet-name>jersey</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.ash
</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>jersey</servlet-name>
<url-pattern>/rest/*</url-pattern>
</servlet-mapping>
</web-app>
该修订的作用是注册org.glassfish.jersey.servlet.ServletContainer servlet,并通过init-param参数jersey.config.server.provider.packages指定rest服务所在文件夹com.ash,多个以逗号分隔。
当然也可以指定单独的类,通过jersey.config.server.provider.classnames参数
部署到tomcat
- 在浏览器输入http://localhost:8080/test-jax-rs/rest/hello/jersey,如下图所示:
其中的jersey可以任意替换