泽西岛的RESTful Web服务

我已经讨论了有关体系结构注意事项<< link >>的早期文章,以成为可在我的系统/机器上使用的分布式环境上的RESTful系统。 本文我们将讨论如何基于REST体系结构考虑来构建Web服务。 本教程说明了如何使用Tomcat 6,Eclipse和Jersey JAX-RS(JSR 311)参考实现在Java中开发RESTful Web服务。

简而言之,RESTful Web服务是使用HTTP on REST原理的机器之间的通信,该通信具有以下要点:

  • 每个资源代表唯一的URI,以通过HTTP协议进行通信
  • HTTP方法支持的每个资​​源操作(POST,GET,PUT和DELETE)
  • JSON,XML和各种MIME类型(例如图像,字节流等)支持的请求和响应。

JAX-RS

JAX-RS是基于注释的API,用于在Java中基于HTTP实现RESTful Web服务。 本质上,类和方法用信息注释,这些信息使运行时可以将它们公开为资源。 在考虑到URI,请求和接受的内容类型以及HTTP方法的情况下,实现JAX-RS的运行时在HTTP协议和Java类之间进行中介。

Jersey框架实现了JSR-RS(JSR-311)参考API。 除了Jersey之外,还有其他各种实现,例如Retlet,JBOSS RESTeasy,Apache CXF等。

球衣:

泽西岛包含以下主要部分:

  • 核心服务器:要基于注释构建RESTful Web服务,请包含诸如jersey-core.jar,jersey-server.jar,jsr311-api.jar,asm.jar之类的关键库。
  • 核心客户端:Jersey客户端API可帮助您轻松与REST服务进行通信,包括libabry ersey-client.jar
  • JAXB支持:(在高级示例中使用)jaxb-impl.jar,jaxb-api.jar,activation.jar,stax-api.jar,wstx-asl.jar
  • JSON支持:(在高级示例中使用)jersey-json.jar
  • 集成:Jersey还提供了可以轻松与Spring,Guice,Apache Abdera等集成的库。

获取工具

软件 下载
Java JDK-6 http://www.oracle.com/
Eclipse –印度 http://www.eclipse.org/
Tomcat的Apache -6 http://tomcat.apache.org/
H2-数据库 http://www.h2database.com/

注意 :您可以在此处下载完整的演示应用程序,包括H2和Jersey库<link>

使用Jersey的RESTful Web服务实现

我们将为用户管理构建一个小型应用程序,以对用户进行CRUD操作。 然后,我们将使用列用户名和密码创建一个小的User表,并使用Jersey注释对Web服务使用POJO类公开操作进行CRUD操作。

在开始RESTful Web服务开发之前,以下是设计注意事项。

  • 资源:具有用户名和密码属性的用户
  • 资源类: UsersResource.java
  • URI: http:// localhost:8080 / UserManagement / users
  • 表示形式: XML

应用程序开发文件夹结构

我们的应用程序的目录结构如下所示:

重置ws文件夹结构

以下是所需的应用程序库列表:

reset-ws-folder-lib

应用配置:

在开始开发之前,我们需要将Jersey servlet添加到web.xml中,以将整个请求定向到jersey,以进行资源标识和操作过程(POST,GET,PUT和DELETE)。

包含jersey servlet之后,Web.xml将如下所示

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"><display-name>UserManagement</display-name><servlet><servlet-name>Jersey REST Service</servlet-name><servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class><init-param><param-name>com.sun.jersey.config.property.packages</param-name><param-value>resource.com.users.java</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>Jersey REST Service</servlet-name><url-pattern>/*</url-pattern></servlet-mapping>
</web-app>

资源资源

资源是指可通过网络寻址和操纵的任何东西。 Jersey资源是带有@Path注释的纯Java对象(PO​​JO),将由HTTP方法POST,GET,PUT和DELETE进行操纵。 资源还具有子资源。 在示例应用程序Users Users的UsersResource中,Java bean是Resources。 用户是具有属性名称和密码的简单POJO

UsersResource.java
@Path("/users")
public class UsersResource implements IUsersResource{
@Context
UriInfo uriInfo;
@GET
@Produces ("application/xml")
public List<User> getUsersAll() {
List<User> als=null;
try {
als= UserService.getInstance().getUserAll();
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return als;
}@POST
@Consumes ("application/xml")
@Produces ("application/xml")
public User createUser(User user){
URI uri = uriInfo.getAbsolutePathBuilder().path(user.getUserName()).build();
Response res=Response.created(uri).build();
try {
UserService.getInstance().CreateUser(user);
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return user;
}@Path("/user/{username}")
@GET
@Produces ("application/xml")public List<User> getUser(@PathParam("username") String username) {
List<User> asl=null;
try {
asl= UserService.getInstance().getUser(username);
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (SQLException e) {
e.printStackTrace();
}
return asl;
}

以下是对JAX-RS注释的简要说明

  • @Path:与根路径结合的路径提供URI来标识资源。 例如,在给定的示例URI中将为http:// localhost:8080 / UserManagement / users
  • @Path(“ / user / {username}”):我们也可以在方法上使用子路径来公开子资源,此示例URI将为http:// localhost:8080 / UserManagement / users / user / john
  • @Context:上下文用于注入上下文对象,例如Request,Response,UriInfo,ServletContext等。
  • @PathParam:此批注与@Path一起使用,并与GET,POST,PUT和DELETE结合使用。 其他可用的注释是@ FormParam,@ QueryParam等。
  • @Produces(“ application / xml”):支持多种MIME类型的响应。 在这种情况下,application / xml将是默认的MIME类型。
  • @Consumes(“ application / xml”):输入请求有效负载将以xml格式发送。
  • @GET:由GET,POST,PUT和DELET方法之一操纵的资源通过HTTP标头传递

JAXB – Java POJO XML绑定

泽西岛支持JAXB,实习生将POJO转换为XML,反之亦然。 为了使POJO具备支持XML的资格,我们必须声明@XmlRootElement注释,如下所示:

不要忘记在转换过程中根据需要添加空的构造函数。

@XmlRootElement
public class User {
private String userName;
private String userPasswd;
public User(String userName, String userPasswd) {
this.userName = userName;
this.userPasswd = userPasswd;
}
public User() {
super();
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public String getUserPasswd() {
return userPasswd;
}
public void setUserPasswd(String userPasswd) {
this.userPasswd = userPasswd;
}
}

我们将在H2数据库的User表中创建执行CRUD操作的服务类。

UserService.javapublic class UserService{
public static UserService userService = new UserService();
public static final String GET_USER="SELECT * FROM USER";
public static final String INSERT_USER="Insert into user ";
public List<User> getUserAll() throws ClassNotFoundException, SQLException {
List<User> ls = new ArrayList();
ls=DataServiceHelper.getInstance().executeQuery(GET_USER);
return ls;
}public List<User> getUser(String name) throws ClassNotFoundException, SQLException{
String SQL_WHERE_CAS=" where name='"+name+"'";
List<User> als=DataServiceHelper.getInstance().executeQuery(GET_USER+SQL_WHERE_CAS);
return als;
}public void CreateUser(User user) throws SQLException, ClassNotFoundException {
String SQL_WHERE_CASE=" VALUES('" + user.getUserName() + "','" + user.getUserPasswd() + "')";
DataServiceHelper.getInstance().executeUpdateQuery(INSERT_USER+SQL_WHERE_CASE);
}
public static UserService getInstance() {
return userService;
}
}

助手类

我们必须创建更多的类来与DB(在本例中为H2)进行交互并执行CRUD操作。

DaraServiceHelper.javapublic class DataServiceHelper {
public static DataServiceHelper dataServiceHelper = null;
private Connection con = null;
DataSource dataSource = null;
InitialContext initialContext = null;
public static final String DB_URL = "jdbc:h2:tcp://localhost/~/test";
public static final String DRIVER_NAME = "org.h2.Driver";
/*** This method is used to create an object for the given DAO class name.
*/public Connection getConnection() throws ClassNotFoundException,
SQLException {
Class.forName(DRIVER_NAME);
con = DriverManager.getConnection(DB_URL, "sa", "");
return con;
}public void closeConnection() throws SQLException {
if (isConnectionOpen()) {
con.close();
con = null;
}
}
public boolean isConnectionOpen() {
return (con != null);
}public static DataServiceHelper getInstance() {
if (dataServiceHelper == null) {
dataServiceHelper = new DataServiceHelper();
}
return dataServiceHelper;
}public void executeUpdateQuery(String query) throws SQLException,
ClassNotFoundException {
Connection con = getConnection();
Statement stmt = con.createStatement();
stmt.execute(query);
closeConnection();
}public List<User> executeQuery(String query) throws ClassNotFoundException,
SQLException {
Connection con = getConnection();
Statement stmt = con.createStatement();
ResultSet rs = stmt.executeQuery(query);
List<User> als = convertPojoList(rs);
closeConnection();
return als;
}private List<User> convertPojoList(ResultSet rs) throws SQLException {
List<User> asl = new ArrayList<User>();
while (rs.next()) {
User user = new User(rs.getString("name"), rs.getString("password"));
asl.add(user);
}
return asl;
}public static void main(String[] args) throws ClassNotFoundException,
SQLException {
String query = "Select * from user where name='nitin'";
List<User> als = DataServiceHelper.getInstance().executeQuery(query);
System.out.println("List==>" + als);
}
}

注意:为简单起见,我将所有代码都包含在一个类中

泽西岛客户测试

泽西岛提供客户端来测试RESTful Web服务,它有助于与服务器进行通信并测试服务。 该库是一个通用实现,可以与任何基于HTTP / HTTPS的Web服务配合使用。

public class UserResourceSample {
public static final String USER_URI="http://localhost:8080/UserManagement/users";
public String testGetUsersAll() {
ClientConfig config = new DefaultClientConfig();
Client client = Client.create(config);
WebResource resource = client.resource(ForumConstant.USER_URI);
ClientResponse response = resource.type(MediaType.APPLICATION_XML).get(
ClientResponse.class);
String en = response.getEntity(String.class);
return en;
}public String testGetUsers() {
ClientConfig config = new DefaultClientConfig();
Client client = Client.create(config);
WebResource resource = client.resource(ForumConstant.USER_URI);
ClientResponse response = resource.type(MediaType.APPLICATION_XML).get(
ClientResponse.class);
String en = response.getEntity(String.class);
return en;
}public User testCreateUser() {
User user = new User("John", "john@");
Client client = Client.create();
WebResource r = client.resource(ForumConstant.USER_URI);
ClientResponse response = r.accept(MediaType.APPLICATION_XML).post(
ClientResponse.class, user);
return user;
}
}

使用浏览器运行

在Eclipse中运行Web应用程序,并在以下位置测试REST服务的可用性: http:// localhost:8080 / UserManagement / users&#8221;。 您应该看到用户项目的XML表示形式:

restful-web-services_testbrow1

对于子资源:

restful-web-services_testbrow2

注意 :在运行应用程序之前,请不要忘记运行H2数据库并将记录插入到User表中

结论:

此示例讨论了Apache Tomcat与Jersey的基本用法。 我们将在以后讨论一些JAX-RS的高级用法。 您也可以将完整的代码下载到此链接下面的<>

资源:

  • http://en.wikipedia.org/wiki/Representational_state_transfer
  • https://jersey.java.net/

参考: Tech My Talk博客上来自JCG合作伙伴 Nitin Kumar的新泽西RESTful Web服务 。

翻译自: https://www.javacodegeeks.com/2013/07/restful-webservices-with-jersey.html

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/368216.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

java swing是什么意思英语_swing是什么意思_swing翻译_读音_用法_翻译

vipkid提供swing是什么意思、swing英语单词推荐、swing英语解释、swing相关词、swing英语短语英音 [swɪŋ] 美音 [swɪŋ]【中文释义】vt.& vi. (使)摇摆;(使)摇荡;n. 摇摆&#xff0c;摆动;摆程&#xff0c;振幅;秋千;音律;vt. 使旋转;使做曲线运动;挥舞;悬吊;vi. 悬摆;迅…

css水平垂直居中(绝对定位居中)

使用绝对定位有个限制就是父集必须设置一个固定的高度。 首先HTML 1 <div id"box"> 2 <div class"child"></div> 3 </div> CSS 1 #box {2 position: relative;3 height: 500px;4 background: red;5 }6 .chil…

Servlet3.0的文件上传功能

在Servlet3.0之前&#xff0c;文件上传需要借助于第三方插件&#xff0c;在Servlet3.0之后&#xff0c;Servlet本身开始支持文件上传功能。 获取上传的文件可以通过HTTPServletRequest的getPart和getParts两个方法实现&#xff0c;前者接受一个表单名为参数&#xff0c;返回对应…

洛谷 2719 搞笑世界杯

洛谷 2719 搞笑世界杯 洛谷原题链接 这道难度只有普及-的题目却花了我一个多小时才搞出来。但做出来之后就会发现&#xff1a;其实这题确实挺水。。。 解题思路&#xff1a; 首先开二维数组 dp [ i ] [ j ] . 代表已售 i 张 A , j 张 B 时后两人买到的票相同的概率。 很显然&am…

Java FutureTask示例程序

有时我写了一篇有关Java Callable Future接口的文章&#xff0c;我们可以使用它来获得线程的并发处理优势&#xff0c;以及它们能够将值返回给调用程序。 FutureTask是Future接口的基础具体实现&#xff0c;并提供异步处理。 它包含启动和取消任务的方法&#xff0c;以及可以返…

java 日期类代码_java 日期时间处理类

import java.util.Calendar;import java.sql.Date;import java.text.SimpleDateFormat;import java.text.ParseException;/*** Utility to date time* version 0.1* author Super Zhao*/public class DateTimeUtil{/*** 由java.util.Date到java.sql.Date的类型转换* param date…

搭建SSH框架–使用篇

创建如下包&#xff1a; action用于响应请求 service则是提供请求的操作 dao用于操作数据库 entity用于映射数据库表 打开DB Browser –> personalCD&#xff08;创建篇的数据库连接&#xff09;–> SCOTT –> TABLE –> t_USER –> 右键Hibernate Reverse……

Hadoop HA集群的搭建

HA 集群搭建的难度主要在于配置文件的编写&#xff0c; 心细&#xff0c;心细&#xff0c;心细&#xff01; ha模式下&#xff0c;secondary namenode节点不存在... 集群部署节点角色的规划&#xff08;7节点&#xff09;------------------server01   namenode   zkfcserv…

3个简单步骤即可测试Java 8

即将发布的Java 8版本为Java开发人员带来了许多新功能&#xff0c;但是升级时始终存在代码破裂的风险。 我们都记得Java 7发行时有一系列非常严重的错误 。 当然&#xff0c;我们所有人都可以帮助避免在Java 8中出现相同的问题。我今天要介绍的方法是使用现有的Continuous Int…

php接收get参数false是字符串,php解析url (parse_url) 参数成数组 (parse_str)

php解析url (parse_url) 参数成数组 (parse_str)(1)parse_url (PHP 4, PHP 5) — 解析 URL&#xff0c;返回其组成部分&#xff0c;函数原型如下&#xff1a;mixed parse_url ( string $url [, int $component -1 ] )本函数解析一个 URL 并返回一个关联数组&#xff0c;包含在…

父类div高度适应子类div

父类div高度适应子类div 通常有许多div的高度由子类的高度决定父类的高度&#xff0c;所以需要父类div要适应子类div的高度&#xff0c;一般情况父类的高度可以直接设置成“auto”即可。 在有的情况下&#xff0c;子类div会撑破父类div. 所以需要走一些调整。通常有3种方法对…

Android - RecyclerView

0.添加引用 compile com.android.support:recyclerview-v7:23.4.0 命名空间&#xff1a; android.support.v7.widget.RecyclerView android.support.v7.widget.LinearLayoutManager 1.首先添加控件 <android.support.v7.widget.RecyclerViewandroid:id"id/activity_re…

jenkins jar包上传maven仓库

1 Jenkins 编译后部署至 Maven 仓库jenkins编译后构件&#xff08;如&#xff1a;jar包&#xff09;部署至maven仓库需修改以下内容&#xff1a;maven 仓库配置&#xff1b;项目 pom 文件&#xff1b;本地仓库的 settings.xml 内容&#xff1b;jenkins goals 修改1&#x…

Java文件合并变得语义化

与任何程序员交谈&#xff0c;并询问他应该如何进行合并&#xff1a;“它应该理解代码&#xff0c;对其进行解析&#xff0c;然后根据结构进行合并” –他很可能会说。 而这恰恰是SemanticMerge for Java所做的&#xff1a;它解析要合并的文件&#xff08;加上祖先或“文件在更…

eval函数

#! /usr/bin/env python# -*- coding: utf-8 -*-# __author__ "Deakin"# Email: 469792427qq.com# Date: 2018/1/14#1. 运行程序输出第一级菜单#2. 选择一级菜单某项&#xff0c;输出二级菜单&#xff0c;同理输出三级菜单#3. 菜单数据保存在文件中#4. 让用户选择是…

KnockoutJS-快速入门

虽然在WPF中接触过MVVM模式&#xff0c;可是刚开始在Web中接触到Knockout.JS让我大吃一惊&#xff0c;简化了好多工作量&#xff0c;原来可能需要一大堆的JS脚本完成的工作量&#xff0c;被释放许多。接触KnockoutJS一年多了&#xff0c;在好多个项目中也用到过&#xff0c;虽然…

几道web前端练习题目

在 HTML 语言中&#xff0c;以下哪个属性不是通用属性&#xff1f;A]<class>B]<title>C]<href>D]<style> 在线练习&#xff1a;http://hovertree.com/tiku/bjaf/qi1g37nf.htm 在 CSS 样式定义中&#xff0c;以下哪种 RGB 颜色值是 Web 安全色&#xf…

php如何导入数据,““php中如何将execl的数据导入到数据库中

php中如何将execl的数据导入到数据库中1.使用PHPExcel Parser Pro&#xff0c;但是这个软件为收费软件&#xff1b;2.可EXCEL表保存为CSV&#xff0c;然后通过phpmyadmin或者SQLyog导入&#xff0c;SQLyog导入的方法为&#xff1a;将EXCEL表另存为CSV形式&#xff1b;打开SQLyo…

Spring MVC错误处理流程

使用Spring MVC可以通过三种方式处理异常流&#xff0c;其目的是拦截任何应用程序异常&#xff0c;并向用户提供友好而信息丰富的视图。 1.在web.xml文件中使用error-page标记&#xff1a; 这是servlet规范驱动的方法&#xff0c;其中基于HTTP响应代码或异常类型来拦截从应用程…

Busybox下tftp命令使用详解

参数说明&#xff1a;-l 是local的缩写&#xff0c;后跟存在于Client的源文件名&#xff0c;或下载Client后 重命名的文件名。 -r 是remote的缩写&#xff0c;后跟Server即PC机tftp服务器根目录中的源文 件名&#xff0c;或上传Se…