WebService技术总结(三)：项目实战——使用XML，dom4j，Xpath实现远程调用

XML具有跨平台性，在企业webservice开发中， 经常将请求参数封装为XML，并且返回一个XML作为结果。

需求： 客户端将发票号码，发票代码作为条件，调用服务端，查询金额，税额信息

客户端请求参数xml形式：

<?xml version="1.1"  encoding="utf-8"?><invoice>    <code>4200161130</code>    <number>01140087</number></invoice>

服务端返回的XML结果：

<?xml version="1.0" encoding="UTF-8"?><result>    <invoice>        <amount precision="2">403.77</amount>        <tax precision="2">24.23</tax>    </invoice></result>

---

服务端代码：

1. POJO：Invoice

public class Invoice {    private String code;    private String num;    private double amount;    private double tax;    //省略getter和setter}

2.DAO实现类，省略DAO接口：使用oracle数据库做了一个简单的查询操作，结果封装为一个java bean集合

public class InvoiceDaoImp implements InvoiceDao {    @Override    public List<Invoice> query(String code, String num) throws Exception {        String url = "jdbc:oracle:thin:@10.101.238.173:1521:orcl";        String user = "gkzq";        String password = "gkzq";        Class.forName("oracle.jdbc.driver.OracleDriver");        Connection connection = DriverManager.getConnection(url, user, password);        String sql = "SELECT account, tax FROM bd_invoice WHERE code = ? and name = ?";        PreparedStatement stat = connection.prepareStatement(sql);        stat.setString(1, code);        stat.setString(2,num);        ResultSet results = stat.executeQuery();        List<Invoice> invoices = new ArrayList<Invoice>();        while(results.next()){            Invoice invoice = new Invoice();            double amount = results.getDouble(1);            double tax = results.getDouble(2);            invoice.setAmount(amount);            invoice.setTax(tax);            invoices.add(invoice);        }        return invoices;    }}

---

3.webservice部分：SEI及其实现类

注意这里抛出了Exception异常，为后面的一个bug埋下伏笔

public interface InvoiceService {    public String getInvoices(String clientXml) throws Exception;}

实现类：涉及到了dom4j和Xpath的相关知识，十分简单，都是见名知意的API，忘了的同学可以复习一下

• 方法parseXml解析从客户端传来的请求XML，并封装成一个Invoice对象；
• 方法create将服务端查询的List结果对象转换为一个XML，返回给客户端；

@WebService(targetNamespace="http://invoice.yonyou.com",serviceName="InvoiceService",name="InvoicePort")@SOAPBinding(style = SOAPBinding.Style.RPC)public class InvoiceServiceImp implements InvoiceService{    private InvoiceDao invoiceDao = new InvoiceDaoImp();     @Override    @WebMethod    public @WebResult(name="rspXml")String getInvoices(@WebParam(name="requestXml")String clientXml) throws Exception {        //客户端传过来的是一个xml，条件都在xml里        Invoice condition = parseXml(clientXml);        //查询结果        List<Invoice> invoices = invoiceDao.query(condition.getCode(), condition.getNum());        //把结果也要转换成一个xml，返回给客户端        return create(invoices);    }    private String create(List<Invoice> invoices) {        Document rspXml = DocumentHelper.createDocument();        Element root = DocumentHelper.createElement("result");        rspXml.setRootElement(root);        if(invoices != null && invoices.size() > 0){            for (Invoice temp : invoices) {                Element invoice = root.addElement("invoice");                Element amount = invoice.addElement("amount");                amount.addText(temp.getAmount() + "");                amount.addAttribute("precision", "2");                Element tax = invoice.addElement("tax");                tax.addText(temp.getTax() + "");                tax.addAttribute("precision", "2");            }        }        return rspXml.asXML();    }    private Invoice parseXml(String clientInfo) throws Exception{        Document doc = DocumentHelper.parseText(clientInfo);        String code = doc.selectSingleNode("/invoice/code").getText();        String num = doc.selectSingleNode("/invoice/number").getText();        Invoice temp = new Invoice();        temp.setCode(code);        temp.setNum(num);        return temp;    }}

服务端代码的编写到此结束了，可以发布服务了，编写发布服务的代码：

public class Publish {    public static void main(String[] args) {        String address = "http://10.101.238.173:20161/invoice";        Endpoint.publish(address, new InvoiceServiceImp());    }}

运行结果如下：

com.sun.xml.internal.ws.model.RuntimeModelerException: runtime modeler error: Wrapper class com.yonyou.service.imp.jaxws.ExceptionBean is not found. Have you run APT to generate them?

wtf？网上百度了一下这错误，无果，然后翻墙谷歌，任然无果，尝试用APT命令编译，百度出来的教程惨不忍睹，最后在csdn的一篇博客中看到解决方法：http://blog.csdn.net/rongbo_j/article/details/50967438

解决方法如下：

1.打开cmd，进入到服务端项目bin路径下
2.执行以下命令：wsgen -keep -cp . com.yonyou.service.imp.InvoiceServiceImp

3.打开生成的ExceptionBean.java,全选，复制到src目录下
4.运行发布程序即可

至此，服务端代码编写完成，可以输入http://10.101.238.173:20161/invoice?wsdl看一下生成的wsdl文件

---

生成客户端java文件

接下来都是很简单的操作了

1.cmd切换到客户端项目src下

2.运行wsdl2java命令：wsdl2java -d . -frontend jaxws21 http://10.101.238.173:201
61/invoice?wsdl

3.客户端生成的代码如下：

---

客户端调用

首先准备请求的XML文件

<?xml version="1.1"  encoding="utf-8"?><invoice>    <code>4200161130</code>    <number>01140087</number></invoice>

编写调用的代码：

public class Client {    public static String requestXml = "<?xml version=\"1.1\"  encoding=\"utf-8\"?>" +            "<invoice>" +            "<code>4200161130</code>" +            "<number>01140087</number>" +            "</invoice>";    public static void main(String[] args) throws Exception_Exception, MalformedURLException {        URL url = new URL("http://10.101.238.173:20161/invoice?wsdl");        String namespace = "http://invoice.yonyou.com";        String serviceName = "InvoiceService";        QName qName = new QName(namespace, serviceName);        Service service = Service.create(url,qName);        InvoicePort port = service.getPort(InvoicePort.class);        String rspXml = port.getInvoices(requestXml);        System.out.println(rspXml);    }}

返回结果：