JAX-RPC和客户端JAR文件
幸运的是,有一种Java API,它提供了所有你所需要的支持,它就是Java API for XML-based RPC (JAX-RPC)。JAX-RPC可用来基于Web服务的WSDL文件为该Web服务实现一个客户端。更幸运的是,WebLogic Server提供了clientgen工具,该工具能生成一个包含完整JAX-RPC基础的客户端JAR文件。你需要这些JAX-RPC基础来轻松调用目标Web服务的一个操作。WebLogic Workshop为你从WebLogic Workshop的测试视图中调用该clientgen工具,并为你返回一个需要和你的客户端一起使用的客户端JAR文件。每个客户端JAR文件都是针对它所创建的Web服务的。为了实现一个客户端,你不但需要客户端JAR文件,而且还需要存储在webserviceclient.jar文件中的一套通用Web服务客户端支持类。webserviceclient.jar文件在WebLogic Workshop的测试视图中也是可用的(通过Proxy Support Jar链接)。
编写基于JAX-RPC的客户端
既然所有概念和逻辑上的背景知识都讲清楚了,现在就可以为一个真正的Web服务创建客户端了。
Web服务和客户端的所有代码都可以在文件RegisterClient.zip中找到。也可以找到一个主机版本的Web服务RegisterPerson.jws。要将该示例安装到WebLogic Workshop中,需要将文件解压缩到BEA_HOME/weblogic700/samples/workshop/applications/samples/proxy目录中。关于该示例的使用说明,请参考readme.html文件。
我将用于这个演示的Web服务叫做RegisterPerson.jws,它接收一个叫做Person的记录。该记录中包含两个联系(地址)记录,一个家庭的和一个工作的。Web服务的其他操作允许查询或者更改当前的家庭或工作联系信息,或者允许查询整个Person记录。Person记录包含两个其他记录这一事实告诉你如何处理一个Web服务接口中的复杂数据类型。另外,RegisterPerson.jws是会话的。setPerson方法启动一个会话,除endSession之外的所有其他方法继续这个会话。endSession用来结束这个会话。本文稍后会解释Web服务会话的概念。
JAX-RPC客户端都遵循同一个样式。一旦创建了一些客户端并熟悉了它们的样式,只要看一下Web服务的文档(例如,WebLogic Workshop Web服务的测试视图)就可以猜出Web服务的JAX-RPC接口了。如果没有Web服务文档的话,可以通过检查那些生成客户端JAR文件的Java文件来找出接口。下面的部分描述了基本的JAX-RPC模式。
例示顶级代理类
你的客户端第一个例示的是一个名为_Impl的顶级类。顶级代理类名称的开始部分应该是Web服务的名称。例如,对于RegisterPerson.jws来说,该顶级代理类的名称就是RegisterPerson_Impl.。
在示例客户端RegisterClient.java中,顶级代理类是在第225行例示的。
m_proxyImpl = new RegisterPerson_Impl(
"http://localhost:7001/samples/proxy/register/RegisterPerson.jws?WSDL");
顶级代理类的构造器参数是URL或者Web服务WSDL文件的文件系统路径。如果在Web服务URL的末端加进一个"?WSDL",那么按照Web服务工具(WebLogic Workshop,.NET,Apache)上的约定,Web服务将返回它的WSDL文件。(你可能会问,"如果Web服务不可用怎么办?",那还用说,你的Web服务客户端就不能正常工作了呗,难道不是吗?)使用URL form是个好办法,因为这允许JAX-RPC客户端代码按照Web服务的当前WSDL来验证自己。如果指定了WSDL文件的本地副本,并且由于你获得了副本Web服务也更改了它的接口,那么Web服务客户端就可能出现故障,但原因不明。通过指定WSDL的URL,可以立即发现你的客户端代码是否过时。
获得一个协议类代理对象
JAX-RPC包括了每个协议的协议类代理类,这些协议可以被Web服务理解(特别是对于WSDL文件中定义的各个端口类型)。代理类都被起了个名字。在示例Web服务中,只支持SOAP协议,所以代理类被称为RegisterPersonSoap。在顶级代理类中通过调用一个accessor方法,就可以得到协议类代理类。所以在我们的例子中,RegisterPerson_Impl定义了方法getRegisterPersonSoap,该方法返回一个RegisterPersonSoap代理类的例子。
In RegisterClient.java, this happens on line 235:
在RegisterClient.java中,这出现在第235行。
m_proxy = m_proxyImpl.getRegisterPersonSoap();
