使用 Axis2 和 JiBX 将 Java 类转换成 Web 服务，第 1 部分: 使用 XML 通过 Java 类定义 Web 服务

简介

Web 服务在日常开发中重要性与日俱增，Axis2 也成为了倍受人们欢迎的开发 Web 服务的开放源码平台。Axis2 使用 Java 语言编写，它能利用了 JiBX（一种框架，用于将XML和Java绑定在一起）的自由性。假设您有一个含有大量 Java 类和数据结构的 Java 项目，而且不想打乱或者更改它们。JiBX 会帮助您实现这一切，它把在 Axis2 中使用的 XML 数据与 Java 类绑定在一起。这样做的好处是代码易于维护，因为 Web 服务只使用已经开发好、可靠、真正的 Java 类。

本文介绍了将在本系列中使用的 Java 类，并解释了如何生成能准确描述这些 Java 类的 Web 服务描述语言（Web Services Description Language，WSDL）和 JiBX 定义。本系列的第 2 部分将使用 WSDL 和 JiBX XML 文档创建一个 Web 服务的 Java 实现，该 Web 服务使用这个 Java 类作为数据绑定。

系统需求

要学习这个分为两部分的系列文章，需要如下软件：

• Axis2，binary and WAR 版，可从 Axis2 主页下载（请参阅 参考资料）。
• JiBX 1.1，可以从 JiBX SourceForge 页面下载（请参阅 参考资料）。
• Geronimo 1.1.1，可以从 Geronimo 主页下载（请参阅 参考资料）。

下载完上述所有软件后，解压 Geronimo 并键入：java -jar <geronimo-home>/bin/server.jar。

然后，为部署 axis2.war 文件，将 axis2 文件复制到 <geronimo-home>/deploy 目录。

解压 Axis2 二进制文件，将 AXIS2_HOME 环境变量设置为 Axis2 二进制文件解压的目录（本例中设置为 c:/apps/axis2-1.1）。然后解压 JiBX，并将 <jibx-home>/lib 目录的所有 JAR 文件（除了 stax-api.jar 文件之外，因为 Axis2 已经含有了 stax-api.jar 文件）复制到 <axis2-home>/lib 目录下。

这样就设置好了环境。

Java 类

这里提供了一些 Java 类，用于构成一个简单的 Web 服务 Java 项目。使用什么样的 Java 类并无大障，您也可以使用自己创建的 Java 类。本文使用的项目含有三个类：OneWayRequest 类、TwoWayRequest 类和 TwoWayResponse 类。按顺序看看每个类，我们先从 OneWayRequest 类开始（参见清单 1）。

清单 1. OneWayRequest Java 类

package  com.ibm.devWorks.xml.simpleService;

public   class  OneWayRequest  ... {
  protected String requestData;

  public String getRequestData() ...{
    return this.requestData;
  }

  public void setRequestData(String requestData) ...{
    this.requestData = requestData;
  }

}

上面的代码中只含有一个字段，即 requestData，它包含了请求的数据。该类有两个方法：一个用于设置字段值，另一个用于检索字段值。

接下来再看一看清单 2 中的 TwoWayRequest 类。

清单 2. TwoWayRequest Java 类

package  com.ibm.devWorks.xml.simpleService;

public   class  TwoWayRequest  ... {
  protected String echoString;
  protected boolean booolean;

  public boolean getBooolean() ...{
    return this.booolean;
  }

  public void setBooolean(boolean booolean) ...{
    this.booolean = booolean;
  }

  public String getEchoString() ...{
    return this.echoString;
  }

  public void setEchoString(String echoString) ...{
    this.echoString = echoString;
  }

}

这个类要稍长一点，它定义了两个字段：一个是 echoString，另一个是 booolean。与第一个类相同，该类为每个字段都定义了一个 getter 和一个 setter 方法。

清单 3 显示了最后一个类，即 TwoWayResponse 类。

清单 3. TwoWayResponse Java 类

package  com.ibm.devWorks.xml.simpleService;

public   class  TwoWayResponse  ... {
  protected String echoString;
  protected boolean invertedBoolean;

  public boolean getInvertedBoolean() ...{
    return this.invertedBoolean;
  }

  public void setInvertedBoolean(boolean invertedBoolean) ...{
    this.invertedBoolean = invertedBoolean;
  }

  public String getEchoString() ...{
    return this.echoString;
  }

  public void setEchoString(String echoString) ...{
    this.echoString = echoString;
  }

}

这个类与前一个 TwoWayRequest 类相当类似，不过这是没有必要的。响应类中可能会包含一项数据库记录中的一些数据项。这样，Java 类就完成了！ 接下来，我们将介绍用于将这些类作为 Web 服务公开的 WSDL。

通过 WSDL 将 Java 类作为服务公开。

在本系统文章的第 2 部分中，我们将使用 Axis2 读取在本节中创建的 WSDL，用以创建 Web 服务的一个 Java 实现。

在深入学习之前，我们需要先了解一些关于 Web 服务的知识。OneWayRequest 类表示一个单向的 Web 服务操作，它只有一个请求，用于发送字段中的请求数据 requestData。TwoWayRequest 类和 TwoWayResponse 类表示一个双向的 Web 服务操作，它有一个请求和一个响应，响应中的 echoString 字段与请求中的 echoString 字段有着相同的值。响应中的 invertedBoolean 字段值与请求中的 invertedBoolean 字段值相反（如果请求中的 invertedBoolean 字段值为假，则响应中发送的 invertedBoolean 字段值为真）。

接下来回到 WSDL，我们首先需要建立名称空间，如清单 4 如示。

清单 4. 定义 WSDL 的名称空间。

<? xml version="1.0" encoding="UTF-8" ?>
< wsdl:definitions
    xmlns:apachesoap ="http://xml.apache.org/xml-soap"
   xmlns:impl ="http://ibm.com/developerWorks/xml/SimpleService"
   xmlns:intf ="http://ibm.com/developerWorks/xml/SimpleService"
   xmlns:wsdl ="http://schemas.xmlsoap.org/wsdl/"
   xmlns:wsdlsoap ="http://schemas.xmlsoap.org/wsdl/soap/"
   xmlns:xsd ="http://www.w3.org/2001/XMLSchema"
   targetNamespace ="http://ibm.com/developerWorks/xml/SimpleService" >
...

这基本上准备好了 WSDL，稍后我们将在 WSDL 中引用名称空间。当 Axis2 读取 WSDL 文件时，它需要知道我们引用的名称空间的值。

接下来，定义模式，如清单 5 所示。

清单 5. 定义模式

targetNamespace="http://ibm.com/developerWorks/xml/SimpleService">
   < wsdl:types >
     < schema
        elementFormDefault ="qualified"
       targetNamespace ="http://ibm.com/developerWorks/xml/SimpleService"
       xmlns ="http://www.w3.org/2001/XMLSchema" >
      
       <!--  ELEMENTS  -->
      
       < element  name ="OneWayRequest" >
         < complexType >
           < sequence >
             < element  name ="requestData"  type ="xsd:string" />
           </ sequence >
         </ complexType >
       </ element >
      
       < element  name ="TwoWayRequest" >
         < complexType >
           < sequence >
             < element  name ="echoString"  type ="xsd:string" />
             < element  name ="booolean"  type ="xsd:boolean" />
           </ sequence >
         </ complexType >
       </ element >
       < element  name ="TwoWayResponse" >
         < complexType >
           < sequence >
             < element  name ="echoString"  type ="xsd:string" />
             < element  name ="invertedBoolean"  type ="xsd:boolean" />
           </ sequence >
         </ complexType >
       </ element >

     </ schema >
   </ wsdl:types >
...

您应该对此代码比较熟悉。这在本质上是通过模式定义的 Java 类。请注意，Java 类中的字段匹配上述模式元素中子元素。还需注意，名称空间为 http://ibm.com/developerWorks/xml/SimpleService，在您创建了 JiBX 定义描述之后将发现它的重要性。

此时再定义消息、端口类型、绑定和 WSDL 服务（如清单 6 所示）。

清单 6. 完成 WSDL 定义

...
   </ wsdl:types >

   <!--  MESSAGES  -->

   < wsdl:message  name ="OneWayRequestMessage" >
     < wsdl:part  name ="input"  element ="impl:OneWayRequest" />
   </ wsdl:message >

   < wsdl:message  name ="TwoWayRequestMessage" >
     < wsdl:part  name ="input"  element ="impl:TwoWayRequest" />
   </ wsdl:message >
   < wsdl:message  name ="TwoWayResponseMessage" >
     < wsdl:part  name ="output"  element ="impl:TwoWayResponse" />
   </ wsdl:message >

   <!--  Port type (operations)  -->

   < wsdl:portType  name ="SimpleServicePortType" >

     < wsdl:operation  name ="OneWay"  parameterOrder ="input" >
       < wsdl:input  name ="OneWayRequestMessage"
                  message ="impl:OneWayRequestMessage" />
     </ wsdl:operation >

     < wsdl:operation  name ="TwoWay"  parameterOrder ="input" >
       < wsdl:input  name ="TwoWayRequestMessage"
                  message ="impl:TwoWayRequestMessage" />
       < wsdl:output  name ="TwoWayResponseMessage"
                   message ="impl:TwoWayResponseMessage" />
     </ wsdl:operation >

   </ wsdl:portType >

   <!--  BINDING (bind operations)  -->

   < wsdl:binding
      name ="SimpleServiceSoapBinding"
     type ="impl:SimpleServicePortType" >
     < wsdlsoap:binding  style ="document"  
transport ="http://schemas.xmlsoap.org/soap/http" />

     < wsdl:operation  name ="OneWay" >
       < wsdlsoap:operation  soapAction ="OneWay" />
       < wsdl:input >
         < wsdlsoap:body  use ="literal" />
       </ wsdl:input >
     </ wsdl:operation >

     < wsdl:operation  name ="TwoWay" >
       < wsdlsoap:operation  soapAction ="TwoWay" />
       < wsdl:input >
         < wsdlsoap:body  use ="literal" />
       </ wsdl:input >
       < wsdl:output >
         < wsdlsoap:body  use ="literal" />
       </ wsdl:output >
     </ wsdl:operation >
   </ wsdl:binding >

   <!--  SERVICE  -->

   < wsdl:service  name ="SimpleService" >
     < wsdl:port  binding ="impl:SimpleServiceSoapBinding"
               name ="SimpleService" >
       < wsdlsoap:address  location ="http://localhost:8080/axis2/services/SimpleService" />
     </ wsdl:port >
   </ wsdl:service >
</ wsdl:definitions >

定义的消息映射到模式中的请求和响应元素，由端口类型定义使用，每项操作的输入和输出都映射一个消息。绑定部分在本质上映射一项 SOAP 操作，确切定义了绑定服务的协议和传输方法及其相关操作。最后，服务部分指定了可用服务，展示了每个服务的服务端点（可以访问到服务的 URL）。

这样便完成了该 Web 服务的定义。接下来，我们将把 XML 映射到 Java 类，以便在本系列的下一部分中使用 JiBX 进行数据绑定。

创建 JiBX 定义描述

JiBX 定义描述的主要目的是将 Java 类映射到名称空间，包括任何期望的字段。在看了本节创建的文件之后，您会将了解更多。首先，看一看 OneWayRequest 类是如何映射的（如清单 7 所示）。

清单 7. 映射 OneWayRequest Java 类

<? xml version="1.0" encoding="UTF-8" ?>
< binding >
   < mapping  name ="OneWayRequest"
           class ="com.ibm.devWorks.xml.simpleService.OneWayRequest" >
     < namespace  uri ="http://ibm.com/developerWorks/xml/SimpleService"
               default ="elements" />
     < value  name ="requestData"  field ="requestData"  usage ="required" />
   </ mapping >
...

mapping 标签中的 name 属性指定了与 OneWayRequest 元素（位于清单 5 中创建的 WSDL 模式中）直接相关联的元素的名称。class 属性将元素与 Java 类映射起来，Java 类如 清单 1 所示。namespace 标签中的 uri 属性映射的名称空间为 http://ibm.com/developerWorks/xml/SimpleService，与清单 5 中 OneWayRequest 元素的名称空间是一样的。最后，能看到 requestData 子元素（位于 清单 5 中的 WSDL）是如何映射到 Java 类中的 requestData 字段（位于 清单 1 中的 value 标签）中的。name 属性指定了 WSDL 中的子元素，field 属性指定了 Java 类中的字段名称。

接下来，我们将介绍其它两个 Java 类是如何映射的，如清单 8 所示。

清单 8. 映射 TwoWayRequest 和 TwoWayResponse Java 类

...
   < mapping  name ="TwoWayRequest"  
           class ="com.ibm.devWorks.xml.simpleService.TwoWayRequest" >
     < namespace  uri ="http://ibm.com/developerWorks/xml/SimpleService"  
               default ="elements" />
     < value  name ="echoString"  field ="echoString"  usage ="required" />
     < value  name ="booolean"  field ="booolean"  usage ="required" />
   </ mapping >
   < mapping  name ="TwoWayResponse"  
           class ="com.ibm.devWorks.xml.simpleService.TwoWayResponse" >
     < namespace  uri ="http://ibm.com/developerWorks/xml/SimpleService"  
               default ="elements" />
     < value  name ="echoString"  field ="echoString"  usage ="required" />
     < value  name ="invertedBoolean"  field ="invertedBoolean"  
           usage ="required" />
   </ mapping >
</ binding >

在清单 8中，我们能看到 OneWayRequest 类、TwoWayRequest 类和 TwoWayResponse 类映射的相似之处。但是，此处的名称、类和字段指向的是 TwoWayRequest 和 TwoWayResponse 元素的适当的数据。然而，不同之处之一就是这两个元素含有两个子元素或者字段。如果 mapping 标签没有子元素，则不会有 value 标签。如果 mapping 标签有多个子元素，那么 value 标签将相继列出，如清单 8 所示。

结束语

分享这篇文章......   将本文提交到 Digg 发布到 del.icio.us