定义
我们经常会听到,xx项目中用到了Web Service。那么,什么是Web Service呢?
首先让我们来了解一下Web Service。Web Service技术,就是能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件, 就可相互交换数据或集成。依据Web Service规范实施的应用之间,无论它们所使用的语言、平台或内部协议是什么,都可以相互交换数据。Web Service是自描述、自包含的可用网络模块,可以执行具体的业务功能。
Web service是一个平*立的,低耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML(标准通用标记语言下的一个子集)标准来描述、发布、发现、协调和配置这些应用程序,用于开发分布式的互操作的应用程序。
准备
将EJB发布成Web服务,在EJB容器中不是困难的事情,只要容器实现了JavaEE的JAX-WS标准就行了,开发人员要做的就是增加一点点有关WebService的注解,打包发布到应用容器即可。
步骤
创建Web Service
- 建立一个POJO endpoint
服务端不用再强制规定WebService必须实现一个接口了,而一个普通的POJO+EJB注解的类就可以当做WebService服务器类。
HelloWorld服务端代码
package com.foshanshop.ws;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
@WebService(name="HelloWorld",
targetNamespace="http://com.foshanshop.ws",
serviceName="HelloWorldService")
@SOAPBinding(style=SOAPBinding.Style.RPC)
public class HelloWorldService {
@WebMethod
public String sayHello(String name) {
System.out.println("客户端调用了服务器端的代码");
return name + "说:这是一个简单的Web测试服务!";
}
}
@WebService 这个注释放置在 Java 类的前面,声明这个类的部分方法可以被发布为 Web 服务。
@WebService 的属性用于设置 Web 服务被发布时的一些配置信息,常用的属性说明如下
1. name
Web 服务的名字,WSDL中 wsdl:portType 元素的 name 属性和它保持一致,默认是 Java 类或者接口的名字。
2. serviceName
Web 服务的服务名,WSDL 中 wsdl:service 元素的 name 属性和它保持一致,默认是Java 类的名字+”Service” 。
3. targetNamespace
WSDL文件所使用的 namespace,该 Web 服务中所产生的其他 XML文档同样采用这个作为 namespace 。
@SOAPBinding()表示这个服务可以映射到一个 SOAP 消息中。 Style 用于指定SOAP 消息请求和回应的编码方式。
@WebMethod 这个注释放在需要被发布成 Web 服务的方法前面。
- 把endpoint定义成Servlet
Web.xml配置
<servlet>
<servlet-name>HelloWorldService</servlet-name>
<servlet-class>com.foshanshop.ws.HelloWorldService</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorldService</servlet-name>
<url-pattern>/HelloWorldService/*</url-pattern>
</servlet-mapping>
- 把endpoint打包成war包
定义好Servlet之后,将服务端的类打成war包,部署到JBoss容器中。
注意:POJO endpoint 文件及 web.xml都是必须的。
经过上面的步骤,完成了一个Web Service 的开发,下面我们通过Jboss管理平台查看刚才发布的 Web Service,打开链接 http://localhost:8080/jbossws,看到如下界面
点击“View a list of deployed services”后,就可以看到已经发布的Web Services了,如下图
在上图中你可以点击 ServiceEndpointAddress 下的路径 http://127.0.0.1:8080/ws_01/HelloWorldService?wsdl 访问他的 wsdl描述,wsdl描述文件在应用发布时由容器自动生成,输出如下
创建客户端
首先新建一个名为ws_01_client 的 java 项目,然后新建一个Web Service Client,然后在WSDL URL中输入:http://127.0.0.1:8080/ws_01/HelloWorldService?wsdl,一路下一步即可。
创建好客户端之后,写了一个测试类,代码如下
package com.foshanshop.ws;
import ws.foshanshop.com.HelloWorld;
import ws.foshanshop.com.HelloWorldService;
public class TestHelloWorld {
/**
* @param args
*/
public static void main(String[] args) {
HelloWorldService helloWorldService = new HelloWorldService();
HelloWorld helloWorld = helloWorldService.getHelloWorldPort();
System.out.println(helloWorld.sayHello("小星星"));
}
}
输出
- 客户端输出
小星星说:这是一个简单的Web测试服务!
- 服务端输出
16:46:26,474 INFO [STDOUT] 客户端调用了服务器端的代码
小结
其实,EJB发布Web Service还是比较简单的,我这里只是列出了一个用java语言调用Web Service的方法,其他也都是很类似的。
实际上,WebService的主要目标是跨平台的可互操作性。为了达到这一目标,WebService完全基于XML(可扩展标记语言)、XSD (XMLSchema)等独立于平台、独立于软件供应商的标准,是创建可互操作的、分布式应用程序的新平台。由此可以看出,在以下三种情况下,使用 WebService会带来极大的好处。
- 跨防火墙的通信
在一个用户界面和中间层有较多交互的应用程序中,使用 WebService这种结构,可以节省花在用户界面编程上20%的开发时间。另外,这样一个由WebService组成的中间层,完全可以在应用程序集 成或其它场合下重用。最后,通过WebService把应用程序的逻辑和数据“暴露”出来,还可以让其它平台上的客户重用这些应用程序。
- 应用程序集成
企业级的应用程序开发者都知道,企业里经常都要把用不同语言写成的、在不同平台上运行的各种程序集成起来,而这种集成将花费很大的开发力量。通过WebService,应用程序可以用标准的方法把功能和数据“暴露”出来,供其它应用程序使用。
- B2B的集成
用WebService来实现B2B集成的最大好处在于可以轻易实现互操作 性。只要把业务逻辑“暴露”出来,成为WebService,就可以让任何指定的合作伙伴调用这些业务逻辑,而不管他们的系统在什么平台上运行,使用什么 开发语言。这样就大大减少了花在B2B集成上的时间和成本,让许多原本无法承受EDI的中小企业也能实现B2B集成。
- 软件和数据重用
软件重用是一个很大的主题,重用的形式很多,重用的程度有大有小。最基本的形式是源代码模块或者类一级的重用,另一种形式是二进制形式的组件重用。
WebService在允许重用代码的同时,可以重用代码背后的数据。使用WebService,再也不必像以前那样,要先从第三方购买、安装软件组 件,再从应用程序中调用这些组件;只需要直接调用远端的WebService就可以了。
从以上论述可以看出,WebService在通过Web进行互操作或远程调用的时候是最有用的。不过,也有一些情况,WebService根本不能带来任何好处。
- 单机应用程序
目前,企业和个人还使用着很多桌面应用程序。其中一些只需要与本机上的其它程序通信。在这种情况下,最好就不要用WebService,只要用本地的 API就可以了。COM非常适合于在这种情况下工作,因为它既小又快。运行在同一台服务器上的服务器软件也是这样。最好直接用COM或其它本地的API来 进行应用程序间的调用。当然WebService也能用在这些场合,但那样不仅消耗太大,而且不会带来任何好处。
- 局域网的同构应用程序
在许多应用中,所有的程序都是用VB或VC开发的,都在Windows平台下使用COM,都运行在同一个局域网上。例如,有两个服务器应用程序需要相互通信,或者有一个Win32或WinForm的客户程序要连接局域网上另一个服务器的程序。在这些程序里,使用DCOM会比SOAP/HTTP有效得多。与此相类似,如果一个.NET程序要连接到局域网上的另一个.NET程序,应该使用.NETremoting。有趣的是,在.NETremoting 中,也可以指定使用SOAP/HTTP来进行WebService调用。不过最好还是直接通过TCP进行RPC调用,那样会有效得多。