为了帮助我们的程序能快速调用目标Webservice服务，BDF2-WEBSERVICE-CLIENT模块提供了一个调用Webservice服务的客户端，利用这个客户端，通过几行简单的代码，就可以实现对目标Webservice服务的调用。在使用空上客户端时，它既可以调用那些不需要任何安全性验证的Webservice，也可以调用那些使用WS-Security进行认证的Webservice，同时对于一些采用Http Basic进行认证的Webservice，我们的Webservice调用客户端也提供了支持。
为了演示这个客户端的具体用法，接下来我们用这个客户端来尝试调用在BDF2-WEBSERVICE模块当中介绍的示例Webservice，看看它能不能调用成功并为我们返回正确的结果。具体调用代码如下：
package ws;
import com.bstek.bdf2.webservice.client.WebServiceClient;
public class WebserviceInvokeTest {
public static void main(String[] args) throws Exception{
String uri="http://localhost:8080/bdf2-test/dorado/webservice/requestUserWebService";
//设置Webservice客户端要调用的目标Webservice的地址
WebServiceClient client=new WebServiceClient(uri);
//设置要调用的目标Webservice的WS-Security认证所需要的username及password，以及是否对用户名及密码进行加密传输
client.setUsernameToken("admin", "81c1206f28f2738cdf714b4e10428c66f58eee10", true);
/**
* 设置要调用的目标Webservice的Http Basic认证所需要的username及password，
* Http Basic认证当中所使用的密码为加密之前的密码，而非被加密之后的密码
* */
//client.setHttpAuthenticationCredentials("admin", "admin");
UserRequest request= new UserRequest();
request.setTargetCompany("bstek");
request.setUserCount(2);
//设置在调用目标Webservice过程当中，需要将Javabean与XML进行相互序列化的Javabean类的class
client.setMarshallerClasses(new Class[]{UserRequest.class,UserResponse.class});
//发送调用请求并返回调用结果
UserResponse response=(UserResponse)client.sendAndReceive(request);
//输出返回结果
for(User user:response.getUsers()){
System.out.println("username:"+user.getUsername() +" company:"+user.getCompanyId());
}
}
}
在这个测试代码当中，我们来看看其中要调用的目标Webserivce的uri，这个uri的值为“http://localhost:8080/bdf2-test/dorado/webservice/requestUserWebService”，实际上这个值是从我们之前生成的WSDL中获取的，再来看看我们的UserService.wsdl中最后那个service部分，如下图所示：
可以看到，这个uri的值源自我们的wsdl，实际上在编写Webservice调用客户端时，我们需要好好研究目标Webservice产生的WSDL文件，要通过这个文件知道目标Webservice的调用地址是什么（uri），需要传递的入参是什么，出参又是什么等，只有了解这些信息之后，才能确定该如何编写我们的Webservice调用客户端，所以，对于使用Webservice的广大程序员来说，了解并能读懂WSDL是何其重要。
因为Webservice是标准的，所以除了可以采用BDF2提供的WebserviceClient实现调用外，还可以采用其它工具实现，比如之前介绍的SoapUI就是一例。下面我们就以XFire的Dynamic Client为例，演示下如何使用XFire的Dynamic Client来调用我们的这个UserService，其代码如下：
package test;
import java.net.URL;
import org.apache.xerces.dom.DocumentImpl;
import org.codehaus.xfire.client.Client;
import org.jdom.Element;
import org.jdom.Text;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
public class SimpleTest {
public static void main(String[] args) throws Exception{
URL url=new URL("http://localhost:8080/bdf2-test/dorado/webservice/UserService.wsdl");
Client client=new Client(url);
Element root=new Element("UserRequest");
Element company=new Element("targetCompany");
company.setContent(new Text("bstek"));
root.addContent(company);
Element userCount=new Element("userCount");
userCount.setContent(new Text("2"));
root.addContent(userCount);
Object[] obj=client.invoke("User",new Object[]{root});
DocumentImpl doc=(DocumentImpl)obj[0];
Node node=doc.getFirstChild().getFirstChild();
NodeList list=node.getChildNodes();
for(int i=0;i<list.getLength();i++){
Node userNode=list.item(i);
System.out.println("username:"+userNode.getFirstChild().getTextContent());
}
}
}
关于XFire的Dynamic Client大家可以到其官网了解，这里需要指出的是在调用client的invoke时，它的第二个参数可以接受一个jdom的DOM对象，利用这个特性我们创建一个基于JDOM的UserRequest的DOM对象，并将需要的信息填充到这个XML的DOM当中，最后作为参数提交给XFire的Dynamic Client去处理，XFire的Dynamic Client将给出的参数构建为SOAP消息传递给服务器处理。
