CSDN博客

img lcl101

WebServices入门

发表于2003/7/18 7:05:00  1430人阅读

WebServices入门

                                               ——实践篇

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

事前

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

项目如图一:

图一

事中

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

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

如图二:

 

图二

 

2、      配置WebServices

如图三,其中EARwebApp分别是我们项目里面的earwar,当然你也可以新建这两个东西;Toolket可以选Apache AxisApache Soap 2,这两个都是ApacheWebservices,我们选用Apache Axes

图三

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

图四

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

如图五:

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

Location URLWebServices的请求地址;

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

图五

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>

   MessagesayHello()响应的消息,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与某一种具体的网络传输协议或消息传输协议相绑定,从这一层次开始,描述的内容就与具体服务的部署相关了。比如可以将PortTypeSOAP/HTTP绑定,也可以将PortTypeMIME/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请求或响应的文档。

0 0

相关博文

我的热门文章

img
取 消
img