WebServices入门

WebServices入门

                                               ——实践篇

上一篇我们简要的说了一些关于webservices的一些理论，在这一篇中我们来写一个简单的例子。我们知道现在webserices规范都只是一个框架，具体用java实现有好几个版本（如apache，bea，ibm，sun都有其实现版本），我们在这里用apache的axis，所以我们的环境是：JB8＋weblogic6.1或者更高版本，因为在JB8中已经集成了axis。下面就让我们开始吧。

事前

在JB8中我们已经建立一个项目HELLOWORLD，在这个项目中已经建立了一个名字为helloworld的war、一个名字为HELLOWORLD的ear以及一个名为BeanHelloworld的Class。在这个Web Services里面我们将把BeanHelloworld类里面的sayHelloworld()方法和sayHello()方法都发布为Web Services的方法。

项目如图一：

图一

事中

下面我们开始来发布这个Webservices：

1、右键单击BeanHelloworld.java => Export as a web service菜单。

如图二：

 

图二

 

2、      配置WebServices，

如图三，其中EAR、webApp分别是我们项目里面的ear、war，当然你也可以新建这两个东西；Toolket可以选Apache Axis和Apache Soap 2，这两个都是Apache对Webservices，我们选用Apache Axes。

图三

3、  按照向导完成这两步以后会出现下面的界面。这个界面主要是导出我们服务的描述文件(WSDL)，其中Interface or class是选择要发布那个Interface、class，如果我们是发布Interface，需要给他指定实现类，也就是Implementation class将不会是灰色；Generate client stub是否要求产生客户端的测试代码。如图四

图四

4、在这一步里主要是设置服务描述文件(WSDL)的一些属性，

如图五：

Deploy scope ：有三种，分别是Request、Application、Session，Request：表明这个对象在SOAP请求/响应周期内存在；Application：表明只创建一个对象实例，这个对象将会处理后面所有的请求；Session：表明容器会为每个客户创建一个对象实例，并在多个请求/响应会话中保存这个对象。顺便说一句，在axis中的session是用web服务器的session来实现的。

Location URL是WebServices的请求地址；

其他属性按照默认值就可以。

图五

5、这一步中主要是选择要发布的方法，如图六：

    在Selection mode中如果是Allow selected methods：会把BeanHelloworld.java中的所有public方法发布出去；Allow selected mothods：会把选择的方法发布出去；而Desallow selected methods ：正好与Allow selected mothods相反。

图六

我们把sayHello()、sayHelloworld()两个方法都发布成为Web Services 的方法

图七

6、这一步中我们主要设置SOAP版本，如图八：

把Type vesion设为 SOAP1.1。然后按照向导完成发布，重新打包就可以部署到WebLogic中啦！

 

 

图八

7、这一步中可以用Axis说生成的测试用例来测试我们的WebServices;

事后

     让我们来看看生成的WSDL文档,客户有了这个文档就可以调用刚才发布的Web Services的方法。

 

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions

   上面这一句是wsdl文档的开头

targetNamespace="http://bean.helloworld.test.com"

xmlns="http://schemas.xmlsoap.org/wsdl/"

xmlns:apachesoap="http://xml.apache.org/xml-soap"

xmlns:impl="http://bean.helloworld.test.com-impl"

xmlns:intf="http://bean.helloworld.test.com" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

上面这一段描述的是这个文档的所要用到的命名空间。

<wsdl:types/>

上面这句是定义wsdl文档要用到复合数据类型，它是符合XML Schema(XSD)定义了一套标准的数据类型，而在我们这个文档中我们只用了简单的数据类型，所以它是个控值。

   <wsdl:message name="sayHelloRequest">

      <wsdl:part name="name" type="xsd:string"/>

   </wsdl:message>

   <wsdl:message name="sayHelloworldResponse">

      <wsdl:part name="sayHelloworldReturn" type="xsd:string"/>

   </wsdl:message>

   <wsdl:message name="sayHelloResponse">

      <wsdl:part name="sayHelloReturn" type="xsd:string"/>

   </wsdl:message>

   <wsdl:message name="sayHelloworldRequest">

   </wsdl:message>

上面这一段定义了四个Message，在理论篇中介绍过Message是通信消息的数据结构的抽象类型化定义。有人会说上面为什么是四个而不是三个或五个，因为我们发布了两个方法,而每一个方法都有请求/响应消息，这个

<wsdl:message name="sayHelloRequest">

                 <wsdl:part name="name" type="xsd:string"/>

           </wsdl:message>

Message就只是去请求sayHello()的消息，该Message中包括调用sayHello()的参数，这个参数的名字是name,类型为String。

           这个

<wsdl:message name="sayHelloResponse">

               <wsdl:part name="sayHelloReturn" type="xsd:string"/>

        </wsdl:message>

   Message是sayHello()响应的消息,该Message中包括sayHello()返回值这个返回值的名字为sayHelloReturn,类型为String.其他两个是调用sayHelloWorld()方法的请求/响应的消息。

<wsdl:portType name="BeanHelloworld">

      <wsdl:operation name="sayHelloworld">

         <wsdl:input message="intf:sayHelloworldRequest" name="sayHelloworldRequest"/>

         <wsdl:output message="intf:sayHelloworldResponse" name="sayHelloworldResponse"/>

      </wsdl:operation>

      <wsdl:operation name="sayHello" parameterOrder="name">

         <wsdl:input message="intf:sayHelloRequest" name="sayHelloRequest"/>

         <wsdl:output message="intf:sayHelloResponse" name="sayHelloResponse"/>

      </wsdl:operation>

   </wsdl:portType>

   上面这段定义了一个portType，在理论篇中我们知道portType是： 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。

   在这个portType中包含了两个operation,我们知道operation是：对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。下面这个operation：

<wsdl:operation name="sayHello" parameterOrder="name">

         <wsdl:input message="intf:sayHelloRequest" name="sayHelloRequest"/>

         <wsdl:output message="intf:sayHelloResponse" name="sayHelloResponse"/>

      </wsdl:operation>

包含了前面定义的sayHelloRequest消息和sayHelloResponse消息。上面parameterOrder="name"调用方法sayHello()的参数序列。

   <wsdl:binding name="BeanHelloworldSoapBinding" type="intf:BeanHelloworld">

      <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>

      <wsdl:operation name="sayHelloworld">

         <wsdlsoap:operation soapAction=""/>

         <wsdl:input name="sayHelloworldRequest">

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://bean.helloworld.test.com" use="encoded"/>

         </wsdl:input>

         <wsdl:output name="sayHelloworldResponse">

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://bean.helloworld.test.com" use="encoded"/>

         </wsdl:output>

      </wsdl:operation>

      <wsdl:operation name="sayHello">

         <wsdlsoap:operation soapAction=""/>

         <wsdl:input name="sayHelloRequest">

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://bean.helloworld.test.com" use="encoded"/>

         </wsdl:input>

         <wsdl:output name="sayHelloResponse">

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://bean.helloworld.test.com" use="encoded"/>

         </wsdl:output>

      </wsdl:operation>

   </wsdl:binding>

   上面这一段定义了Binding,我们知道Binding ：特定端口类型的具体协议和数据格式规范的绑定。Binding结构定义了某个PortType与某一种具体的网络传输协议或消息传输协议相绑定，从这一层次开始，描述的内容就与具体服务的部署相关了。比如可以将PortType与SOAP/HTTP绑定，也可以将PortType与MIME/SMTP相绑定等。

   上面<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>描述了调用的方式style="rpc" (远程过程调用),具体的网络传输协议transport="http://schemas.xmlsoap.org/soap/http"， 也就是soap/http协议.其他的就是具体描述每个operation.

<wsdl:service name="BeanHelloworldService">

      <wsdl:port binding="intf:BeanHelloworldSoapBinding" name="BeanHelloworld">

         <wsdlsoap:address location="http://localhost:7001/helloworld/services/BeanHelloworld"/>

      </wsdl:port>

   </wsdl:service>

   上面这一段定义了service,我们知道Service ：描述的是一个具体的被部署的Web服务所提供的所有访问入口的部署细节，一个Service往往会包含多个服务访问入口，而每个访问入口都会使用一个Port元素来描述。

   <wsdl:port binding="intf:BeanHelloworldSoapBinding" name="BeanHelloworld">描述了上面定义的binding.

   <wsdlsoap:address location="http://localhost:7001/helloworld/services/BeanHelloworld"/>描述了具体的请求地址

</wsdl:definitions>

当然上面这句就是整个文档的结束标记啦。

 

 

以后有机会我们在看看soap请求或响应的文档。