webservice restful一个小例子

需求
公司有一个产品，包括前台WEB界面和多个后台服务，各个服务都需要在前面界面中进行配置和控制，以调整服务的行为。以前，配置文件都存放在数据库中，界面上修改配置后入库，并发送消息（Socket）通知特定的服务重新加载配置。这样有些问题，一方面自己维护Socket带来很多麻烦，二来数据库重建的时候，需要备份/恢复这些配置数据。

所以，我们想把配置文件局部化到各个服务（比如用本地文件存储），然后在界面上修改的时候，实时向服务请求当前配置数据（XML格式），修改完毕后，再直接发给服务进行更新和存储。而在通信方式上，我们希望各个服务提供Web Service接口来实现配置的检索和更新。

但Web Service通常需要在Web Container（比如，tomcat, jboss）中实现，而我们不想把所有的服务都跑在tomcat里，于是想找到一种更加轻量级的方式。

今天偶然看到JSR311，进而发现在Java后台服务中内嵌grizzly（基于NIO的实现）和Jersey（Sun的JSR311参考实现）来提供Restful Web Service能力，是非常方便的。个人认为这种方式适用于后台Java程序的控制、配置和监视，其作用有些类似于JMX，但比实现JMX要简单的多（JSR311基于POJO）。

背景知识
Representational state transfer (REST) Web Service：
它是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。在目前三种主流的Web Service实现方案中，因为REST与SOAP和XML-RPC相比显的更加简洁，因此越来越多的Web Service开始采用REST风格设计和实现。

参考资料：http://en.wikipedia.org/wiki/Representational_State_Transfer

Jersey：
它是Sun对JSR311的官方参考实现，而JSR311是java中实现Restful Web Service的API规范（JSR311: JAX-RS: The Java API for RESTful Web Services）。JSR311有一个重要目标：使用注解（annotation）把POJO暴露成Web Service，这样就比较轻量级。

参考资料：https://jsr311.dev.java.net/nonav/releases/1.0/spec/index.html

Grizzly：
Grizzly于2004年诞生在GlassFish中，开始目的是要建构一个HTTP Web服务器，用来代替Tomcat的Coyote连接器和Sun WebServ er6.1。后来，Grizzly成为一种应用程序框架，专门解决编写成千上万用户访问服务器时候产生的各种问题。使用JAVA NIO作为基础，并隐藏其编程的复杂性。在本例中，我们将其用作内嵌的Servlet Container。

参考资料：https://grizzly.dev.java.net/

准备工作
首先，下载grizzly和jersey。其中，grizzly的下载地址为：http://download.java.net/maven/2/com/sun/grizzly/grizzly-servlet-webserver/1.9.18a/grizzly-servlet-webserver-1.9.18a.jar，jersey的下载地址为：http://download.java.net/maven/2/com/sun/jersey/jersey-archive/1.1.2-ea/jersey-archive-1.1.2-ea.zip

在Eclipse中建一个Java工程，名为jsr331，然后把下载的jersey-archive-1.1.2-ea.zip解压，将 jersey-archive-1.1.2-ea/contribs、jersey-archive-1.1.2-ea/lib两个目录下的jar包，连同下载的grizzly-http-webserver-1.9.18a.jar都拷贝到jsr331工程下的lib目录，并加入到该工程的Build Path。（实测中，发现还需要引入一个包，下载地址：http://repository.jboss.org/maven2/org/jvnet /mimepull/1.2/mimepull-1.2.jar）

编写最简单的服务
JSR331把准备提供Web Service的类称为Resource class。Resource class是一个普通类（POJO），但是按照规范要求增加了特定的注解（annotation）。我们首先实现最简单的hello world服务。

在jinxfei.test.jsr311.service下，建立HelloService类，内容如下：

[java] view plaincopy

package jinxfei.test.jsr311.service;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
@Path("/hello")
public class HelloService {
@GET
@Produces("text/plain")
public String helloWorld(){
return "Hello world!";
}
}

代码中的注解（annotation）决定了程序发布成Web Service后的行为和特性。其中，HelloService类前面的@PATH，表明该Service的URL路径，这种类名前面带@PATH注解的类被称为Root Resource Class，因为他们决定了访问Service时URI中的第一级路径；@GET表示访问该服务使用HTTP GET方法；@Produces规定该服务返回结果的类型，这里的”text/plain”表名返回纯文本。

发布服务
实现服务类后，我们要启动一个内嵌的grizzly servlet container，并把HelloService发布到该Container中，这样就能通过HTTP协议访问该服务。Jersey提供了两种发布方式，标准的做法需要在web.xml中做配置，所以比较适用于部署在独立的Web Container下的应用，本文不做深入介绍，可参见：http://docs.sun.com/app/docs/doc/820-4867/6nga7f5o4?l=en&a=view。本例与grizzly整合，所以使用grizzly的工具类，通过代码进行部署配置。

在jinxfei.test.jsr311包下创建ServiceDeployer类，内容如下：

[java] view plaincopy

package jinxfei.test.jsr311;
import java.io.IOException;
import java.net.URI;
import java.util.HashMap;
import java.util.Map;
import javax.ws.rs.core.UriBuilder;
import com.sun.grizzly.http.SelectorThread;
import com.sun.jersey.api.container.grizzly.GrizzlyWebContainerFactory;
public class ServiceDeployer {
public static void main(String[] args) throws IOException {
URI ServerURI=UriBuilder.fromUri("http://localhost/").port(9876).build();
startServer(ServerURI);
System.out.println("服务已启动，请访问："+ServerURI);
}
protected static SelectorThread startServer(URI serverURI) throws IOException {
final Map<String, String> initParams = new HashMap<String, String>();
initParams.put("com.sun.jersey.config.property.packages","jinxfei.test.jsr311.service");
System.out.println("Grizzly 启动中...");
SelectorThread threadSelector = GrizzlyWebContainerFactory.create(serverURI, initParams);
return threadSelector;
}
}

代码很简单，其中：initParams.put("com.sun.jersey.config.property.packages" , "jinxfei.test.jsr311.service"); 这一行的第二个参数表明服务实现类所在的包名，系统会自动搜索做了注解的类并将其发布成服务。

在Eclipse中运行该类，控制台上打印“服务已启动”字样，表示系统启动成功，打开浏览器，输入：http://localhost:9876/hello，即可看到效果，如下图所示：

让功能再强一点点
接下来，我们要让服务能够接受参数，并根据参数打印不同的信息，最简单的就是回显（Echo）。为了实现这一功能，我们给HelloService类增加一个方法：

[java] view plaincopy

@POST @Path("echo")
@Consumes("application/x-www-form-urlencoded")
public String echo(@FormParam("msg") String message){
return "Are you saying:"+message;
}

@POST表明该方法要用HTTP Post来访问，@Path表明访问该方法的相对路径是echo，@Consumes表明该方法处理HTTP Post请求中何种类型的数据。该方法参数中的注解@FormParam("msg")说明后面的“String message”参数取自表单提交数据中的msg。

由于该方法需要Post访问，且需要通过表单提交数据，所以我们创建一个test.htm，在其中写一个简单的Form：

[xhtml] view plaincopy

<form action="http://localhost:9876/hello/echo" method="post">
<input type="text" name="msg">
<input type="submit" value="submit">
</form>

重启ServiceDeployer，然后在浏览器中打开test.htm，表单中输入任意信息：

然后点提交按钮，可以看到如下信息：

这说明HelloService已经提取了表单参数，并回显给用户。

转载于:https://www.cnblogs.com/xiaoliu66007/p/3277795.html

webservice restful一个小例子相关推荐

MVVM模式的一个小例子
使用SilverLight.WPF也有很长时间了,但是知道Binding.Command的基本用法,对于原理性的东西,一直没有深究.如果让我自己建一个MVVM模式的项目,感觉还是无从下手,最近写了一个 ...
飞鸽传书举一个小例子
飞鸽传书举一个小例子,每个程序窗口右上角都有三个按钮,如最小化.关闭等.乔布斯觉得不好看,不易用,他提出改用红绿蓝的交通灯.这样修改后,果然 Mac OS 漂亮和易用了很多. 目前互联网和手机上的应用 ...
C# 实现 rtc_通过Xlua实现unity热更新的一个小例子
通过Xlua实现unity热更新的一个小例子一.介绍热更新是指在更新游戏资源或者逻辑的时候不需要开发者将游戏再打包.发布.玩家重新下载安装包,而是可以通过将需要更新的资源打包成AssetBun ...
puppet运行慢的一个小例子
一个小例子来看下怎么debug puppet运行慢的问题. 一个小例子来看下怎么debug puppet运行慢的问题. 发现一台机器的agent运行比较缓慢,首先看下puppet server的整体性 ...
unity案例 mysql lua_通过Xlua实现unity热更新的一个小例子
通过Xlua实现unity热更新的一个小例子一.介绍热更新是指在更新游戏资源或者逻辑的时候不需要开发者将游戏再打包.发布.玩家重新下载安装包,而是可以通过将需要更新的资源打包成AssetBun ...
html5 websocket插件,html5实现的WebSocket一个小例子（附代码）
本篇文章给大家带来的内容是关于html5实现的WebSocket一个小例子(附代码),有一定的参考价值,有需要的朋友可以参考一下,希望对你有所帮助. 客户端代码: var socket; if (&q ...
网站制作---asp操作数据库的一个小例子
qq交流群:创梦技术交流群:251572072 教程下载,在线交流:创梦IT社区:www.credream.com 一般用在asp网站中比较常见: asp操作数据库的一个小例子: id=reques ...
mysql存储过程的一个小例子
目录标题 mysql存储过程的一个小例子 mysql存储过程的一个小例子 1.首先创建一张表来供我们学习存储过程三个字段,分别为:id.name.age 其中 id为自增字段,name与age不能为 ...
CapsuleNet的一个小例子
引用YouTube上一个up主的视频,讲解一个capsulenet的一个小例子识别的过程假设我们要识别右面的"船",经过卷积得到2个识别矩形和三角形的胶囊(即向量,之前一篇博客 ...

webservice restful一个小例子

webservice restful一个小例子相关推荐

最新文章

热门文章