三、Stubs方式

这种实现方式是目前比较流行的方式，他将用于发布服务的提供商和用于引用服务的应用商有效的实现了分离，而且较之于前两种开发方法，Stubs不需要程序员关注WebService的返回类型，也就是不用我们去关心wsdl，因为他是axis自动生成的，例如webservice要返回一个Stirng[]类型，axis自动将其转化为Array，调用也简单。这种方式是在EJB基础上发展起来的，熟悉EJB的人应该很熟悉这种方式，所以stubs方式是这几种开发方式中最成熟的方法，下面是步骤：

1．在testaxis根目录下建立一个java2wsdl文件夹，在java2wsdl文件夹下新建一个名为build.xml的Ant构建，内容如下：

关于Ant构建的语法请参考相关文章，简单说一下一个是axis.dir，就是你下载的Axis-1.4的目录，一个是<target name="j2w-JavaBeanWS">，classname表示你的myService存放的路径，methods表示webservice中的方法，方法名称必须和myService中的方法一致，否则即使构建成功了也不能执行，output是输出的wsdl名称，locatlocation是myService的访问地址，用于客户调用，namespace是命名空间，有了命名空间你就可以通过namespace.webservice的方法来调用这个webservice，好了，关于Ant构建就介绍到这里。

2．运行Ant构建，在java2wsdl目录下会自动生成一个myService.wsdl的文件。

3．下面开始客户端的工作，客户端就是把服务端的wsdl文件转换为java文件以便于客户端的调用执行，理论上服务端和客户端是分离的，他们属于不同的系统和项目，两者毫无相干，唯一联系他们的是wsdl，但我们为了方便都放在AxisTest项目中，客户端的做法是将发布商发布的wsdl文件拷贝到自己的项目中，在这里我们已经有了这个wsdl就可以省去这一步，在testaxis新建一个源文件夹（Source Folder），注意是源文件夹不是文件夹，取名为wsdl2java，新建一个build.xml的Ant构建，内容如下：

4．运行Ant构建，运行结果如下：

这是在wsdl2java文件夹会自动生成几各类，别看Axis自动生成这么多类，其实都很简单，我们真正实际用到的就*ServiceLocator.java和*.java类，ServiceLocator是获得webservice的定位，*.java是具体实现类。

5． 编写客户端测试代码，在com.axistest新建一个myServiceTestorByStubs.java，内容如下：

运行结果：Hello 毛毛,this is an Axis Dynamic Proxy Web Service(当然这里的“Dynamic Proxy ”就不准确了。)

使用axis很easy，在apache网站上把axis下载了后（最新版本1.2.1)，把%AXIS_HOME%\webapps\axis整个目录copy到tomcat的webapps目录下面，启动tomcat，浏览器中输入http://localhost:8080/axis就可以了

上面说的只是axis运行起来了，要想布置自己的webservice，axis支持两种方法：一种是用JWS（Java Web Service)，好处是只要有源码比如说Hello.java,把他改成Hello.jws后放到%TOMCAT_HOME%\webapps\axis目录下面就搞定，浏览器里面输入http://localhost:8080/axis/Hello.jws就可以了，不足的地方是能配置的地方有限（比如说Hello.java里面的所有public非static方法都会暴露），很多东西没办法弄；第二种方法就是使用wsdd(web service deploy description)，这个就是在TOMCAT_HOME%\webapps\axis\WEB-INF目录下写一个deploy.wsdd和undeploy.wsdd文件，然后通过java org.apache.axis.client.AdminClient deploy.wsdd就搞定了，卸载这个webservice就用org.apache.axis.client.AdminClient undeploy.wsdd，客户端输入http://localhost:8080/axis/services/Hello就可以了

介绍了部署webservice的两种方法后，下面说说客户端的访问方式，也有两种，一种是通过axis实现的java里面的JAX-RPC进行动态调用，另外一种就是通过服务器端产生的wsdl文件利用WSDL2Java工具生成Client Stub后访问。通过JAX-RPC的比较简单，需要提供的有SOAP router URL，service namespace，operation name，operation parameter types，operation return types，看看下面这个例子就明白了：

程序中的Call和Service是对JAX-RPC中Call和Service的具体实现：org.apache.axis.client.Call implements javax.xml.rpc.Call，org.apache.axis.client.Service implements javax.xml.rpc.Service

第二种客户端的方法就是利用WSDL2Java产生Client stub后通过stub调用，WSDL2Java的操作对象是service所对应的wsdl文件，这个文件怎么产生呢？一种方法前面是由axis自动产生，如前面服务器端的配置所说，无论通过jws或是wsdd的方式，axis都会产生相应的wsdl；还有一种方式就是利用Java2WSDL对java源文件进行操作也可以产生相应的wsdl文件。

    WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL XML模式的XML文档。WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用：消息，指对交换数据的抽象描述；而端 口类型，指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联，可以定义一 个端口，而端口的集合则定义为服务。

   一个WSDL文档通常包含7个重要的元素，即types、import、message、portType、operation、binding、 service元素。这些元素嵌套在definitions元素中，definitions是WSDL文档的根元素。文章的下一部分将会详细介绍WSDL 的基本结构。

二：WSDL的基本结构--概述

如第一部分最后描述的那样，一个基本的WSDL文档包含7个重要的元素。下面将分别介绍这几个元素以及他们的作用。

WSDL 文档在Web服务的定义中使用下列元素：

• Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
• Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
• Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
• PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
• Binding - 特定端口类型的具体协议和数据格式规范的绑定。
• Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
• Service- 相关服务访问点的集合。

  可以参考下图来理解一下WSDL的文档结构图：

WSDL的xml schema可以参照如下网址：http://schemas.xmlsoap.org/wsdl/

三：WSDL的基本结构--详述

本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容，该文档的产生可以参见我的另外一篇文章：xfire开发实例--HelloWorld篇 。

一个简单的Web Service的WSDL文档，该服务支持名为sayHello的唯一操作，该操作通过在http上运行SOAP协议来实现的。该请求接受一个字符串name，经过处理后返回一个简单的字符串。文档如下：

♦ types元素使用XML模式语言声明在WSDL文档中的其他位置使用的复杂数据类型与元素；

♦ import元素类似于XML模式文档中的import元素，用于从其他WSDL文档中导入WSDL定义；

♦ message元素使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载；

♦ portType元素和operation元素描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于 java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载；

♦ Binding元素将portType元素和operation元素赋给一个特殊的协议和编码样式；

♦ service元素负责将Internet地址赋给一个具体的绑定；

1、definitions元素

所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档，同时通过其name提供了一个WSDL文档。除了提供一个命名空间外，该元素没有其他作用，故不作详细描述。

下面的代码是一个definitions元素的结构：

2、types元素

 WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载 时，消息定义使用了在types元素中定义的数据类型和元素。在本文的WSDL文档中的types定义：

上面是数据定义部分，该部分定义了两个元素，一个是sayHello，一个是sayHelloResponse：

sayHello：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的参入传入部分；

sayHelloResponse：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的返回值；

3、import元素

import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候，该功能是非常有效果的。

import的格式如下：

<wsdl:import namespace="http://xxx.xxx.xxx/xxx/xxx" location="http://xxx.xxx.xxx/xxx/xxx.wsdl"/>

必须有namespace属性和location属性：

namespace属性：值必须与正导入的WSDL文档中声明的targetNamespace相匹配；

location属性：必须指向一个实际的WSDL文档，并且该文档不能为空。

4、message元素

message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载；还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。在本文中的message元素的定义，本文档使用了采用文档样式的消息传递：

该部分是消息格式的抽象定义：定义了两个消息sayHelloResponse和sayHelloRequest：

sayHelloRequest：sayHello操作的请求消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；

sayHelloResponse：sayHello操作的响应消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；

 如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。

5、portType元素

portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口，都是定义了一个抽象类型和方法，没有定义实现。在WSDL 中，portType元素是由binding和service元素来实现的，这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及 Internet地址。

一个portType中可以定义多个operation，一个operation可以看作是一个方法，本文中WSDL文档的定义：

    <wsdl:portType name="HelloServicePortType">
        <wsdl:operation name="sayHello">
            <wsdl:input name="sayHelloRequest"
                message="tns:sayHelloRequest" />
            <wsdl:output name="sayHelloResponse"
                message="tns:sayHelloResponse" />
        wsdl:operation>
    wsdl:portType>

portType定义了服务的调用模式的类型，这里包含一个操作sayHello方法，同时包含input和output表明该操作是一个请求／响 应模式，请求消息是前面定义的sayHelloRequest，响应消息是前面定义的sayHelloResponse。input表示传递到Web服务 的有效负载，output消息表示传递给客户的有效负载。

６、binding

binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用，本文中的例子：

这部分将服务访问点的抽象定义与SOAP HTTP绑定，描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时，应当使用的soapAction是""。

具体的使用需要参考特定协议定义的元素。

７、service元素和port元素

service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。文档中的例子：

这部分是具体的Web服务的定义，在这个名为HelloService的Web服务中，提供了一个服务访问入口，访问地址是http://localhost:8080/xfire/services/HelloService，使用的消息模式是由前面的binding所定义的。

　　本文简单介绍了WSDL规范的用途，基本结构和使用方法，希望对大家学习WSDL有帮助。

AXIS VS CXF
在SOA领域，我们认为Web Service是SOA体系的构建单元（building block）。对于作过WebService的开发人员来说，AXIS和CXF一定都不会陌生。这两个产品都是Apache孵化器下面的Web Service开源开发工具。 Axis2的最新版本是1.3，CXF现在已经到了2.0版本。

这两个框架 都是从已有的开源项目发展起来的。Axis2是从Axis1.x系列发展而来。CXF则是XFire和Celtix项目的结合产品。Axis2是从底层全 部重新实现，使用了新的扩展性更好模块架构。 CXF也重新的深化了XFire和Celtix这两个开发工具。

新产品的退出导致了几个问题。是不是现有的使用Axis 1.x，XFire和Celix的应用需要迁移的新的版本上。如果一个开发人员确定要迁移它的应用到新的框架上，那么他应该选择哪一个呢？相反的，如果一 个开发者决定从头开发一个新的Web Service，他应该使用哪个呢？ 这两个框架哪一个更好一些呢？

对于系统迁移来说，也许迁移到新的框架并不难。Axis和CXF都提供了迁移的指导。能够给开发者一些迁移的技巧和经验。但是对于这样迁移，这两个 开源项目都没有提供迁移的工具。对于这样的迁移工作，尽管很值得去寻找所有的可行方案。Axis2和CXF都有各自不同的WebService开发方法， 每个方法都有相当数量拥护者。

通过一个比较矩阵来比较Axis2和CXF变得有现实的意义。这两个项目都开发不够成熟，但是最主要的区别在以下几个方面：
1. CXF支持 WS-Addressing，WS-Policy， WS-RM， WS-Security和WS-I Basic Profile。Axis2不支持WS-Policy，但是承诺在下面的版本支持。
2. CXF可以很好支持Spring。Axis2不能
3. AXIS2支持更广泛的数据并对，如XMLBeans，JiBX，JaxMe和JaxBRI和它自定义的数据绑定ADB。注意JaxME和JaxBRI都还是试验性的。CXF只支持JAXB和Aegis。在CXF2.1
4. Axis2支持多语言-除了Java,他还支持C/C++版本。

比较这两个框架的Web Service开发方法与比较它们的特性同样重要。 从开发者的角度，两个框架的特性相当的不同。 Axis2的开发方式类似一个小型的应用服务器，Axis2的开发包要以WAR的形式部署到Servlet容器中，比如Tomcat，通过这些容器可以对 工作中的Web Service进行很好的监控和管理。Axis2 的Web administrion模块可以让我们动态的配置Axis2.一个新的服务可以上载，激活，使之失效，修改web服务的参数。管理UI也可以管理一个或 者多个处于运行状态的服务。这种界面化管理方式的一个弊端是所有在运行时修改的参数没有办法保存，因为在重启动之后，你所做的修改就会全部失效。

Axis2允许自己作为独立的应用来发布Web Service，并提供了大量的功能和一个很好的模型，这个模型可以通过它本身的架构（modular architecture）不断添加新的功能。有些开发人员认为这种方式对于他们的需求太过于繁琐。这些开发人员会更喜欢CXF。

CXF更注重开发人员的工效（ergonomics）和嵌入能力（embeddability）。大多数配置都可以API来完成，替代了比较繁琐的 XML配置文件， Spring的集成性经常的被提及，CXF支持Spring2.0和CXF's API和Spring的配置文件可以非常好的对应。CXF强调代码优先的设计方式（code-first design)，使用了简单的API使得从现有的应用开发服务变得方便。

不过你选择Axis2还是CXF，你都可以从开源社区得到大量的帮助。这两个框架都有商业公司提供服务，WSO2提供AXIS2的支持，Iona提 供CXF的支持。这两公司都有很活跃的开发者社区。 Axis2出现的时间较早，CXF的追赶速度快。我的建议是：如果你需要多语言的支持，你应该选择AXIS2。如果你需要把你的实现侧重JAVA并希望和 Spring集成，CXF就是更好的选择，特别是把你的Web Service嵌入其他的程序中。如果你觉得这两个框架的新特性对于你并没有太大的用处，你会觉得Axis1也是不错的选择，你应该继续使用它知道你有充 分的理由去更换它。

二、开始XFire的生火之旅：
1、配置XFire运行环境：
在Tomcat下新建一个Web Applications，命名为stove，然后在其WEB-INF目录下新建一个web.xml文件，文件中输入：

Xml代码

1. <?xml version="1.0" encoding="GB2312">  
2. <!DOCTYPE web-app  
3.     PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"  
4.     "http://java.sun.com/dtd/web-app_2_3.dtd">  
5.       
6. <web-app>  
7.   
8.   <servlet>  
9.     <servlet-name>XFireServlet</servlet-name>  
10.     <display-name>XFire Servlet</display-name>  
11.     <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>  
12.   </servlet>  
13.   
14.   <servlet-mapping>  
15.     <servlet-name>XFireServlet</servlet-name>  
16.     <url-pattern>/servlet/XFireServlet/*</url-pattern>  
17.   </servlet-mapping>  
18.   
19.   <servlet-mapping>  
20.     <servlet-name>XFireServlet</servlet-name>  
21.     <url-pattern>/services/*</url-pattern>  
22.   </servlet-mapping>  
23.   
24. </web-app>  

<?xml version="1.0" encoding="GB2312">
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>XFireServlet</servlet-name>
<display-name>XFire Servlet</display-name>
<servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/servlet/XFireServlet/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>

其中主要就是引入了XFireServlet，用以处理Web Service请求，并且负责提供Web Service的WSDL，如果你发布了一个名为BookService的WebService，则可以通过网址：
http://<服务器>[:端口]/<webapp名>/services/BookService
来访问这个WebService，并且通过地址：
http://<服务器>[:端口]/<webapp名>/services/BookService?WSDL  来得到这个WebService的WSDL信息。

2、开发最简单的WebService
在WEB-INF目录下新建src文件夹，然后再建一个package:
cn.com.pansky.webservice.xfire.study
，在这个包下面新建一个接口：

Java代码

1. package cn.com.pansky.webservice.xfire.study;  
2.   
3. public interface SayHiService{  
4.   public String sayHi(String name);  
5. }  

package cn.com.pansky.webservice.xfire.study;
public interface SayHiService{
public String sayHi(String name);
}

这个接口是告诉服务器你的WebService哪些方法可以被用户调用的。下面我们再来写一个SayHiService的实现类，以完成业务逻辑：

Java代码

1. package cn.com.pansky.webservice.xfire.study;  
2.   
3. public class SayHiServiceImpl implements SayHiService{  
4.   public String sayHi(String name){  
5.     if(name==null){  
6.       return "连名字也不肯告诉我吗？";  
7.     }  
8.     return name+", 你吃了吗？没吃回家吃去吧。";  
9.   }  
10.   
11.   public String 不告诉你(){  
12.     return "我的名字不告诉你！";  
13.   }  
14. }  

package cn.com.pansky.webservice.xfire.study;
public class SayHiServiceImpl implements SayHiService{
public String sayHi(String name){
if(name==null){
return "连名字也不肯告诉我吗？";
}
return name+", 你吃了吗？没吃回家吃去吧。";
}
public String 不告诉你(){
return "我的名字不告诉你！";
}
}

 这个类实现了sayHi方法，该方法是可以通过WebService调用访问到的。另外还实现了一个方法“不告诉你”，该方法因为没有在接口SayHiService中定义，所以不能被WebService调用到。
   这个例子足够简单吧，就跟我们刚学Java时写的"Hello world"没什么两样。
到这里为止，我们做的跟平时的Java开发没啥区别，该如何来发布WebService呢？

3、把JAVA类发布为WebService：
在WEB-INF/classes目录下新建文件夹：META-INF/xfire，然后在该文件夹下新建一个XML文件：services.xml，文件内容如下：

Xml代码

1. <beans xmlns="http://xfire.codehaus.org/config/1.0">  
2.   <service>  
3.     <name>SayHiService</name>  
4.     <namespace>http://cn.com.pansky/SayHiService</namespace>  
5.     <serviceClass>cn.com.pansky.webservice.xfire.study.SayHiService</serviceClass>  
6.     <implementationClass>cn.com.pansky.webservice.xfire.study.SayHiServiceImpl</implementationClass>  
7.   </service>  
8. </beans>  

<beans xmlns="http://xfire.codehaus.org/config/1.0">
<service>
<name>SayHiService</name>
<namespace>http://cn.com.pansky/SayHiService</namespace>
<serviceClass>cn.com.pansky.webservice.xfire.study.SayHiService</serviceClass>
<implementationClass>cn.com.pansky.webservice.xfire.study.SayHiServiceImpl</implementationClass>
</service>
</beans>

 这个文件定义一个WebService: SayHiService，并同时定义了接口和实现类。
好了，该建的文件基本建完了，现在想办法把src下的java文件编译成class，并复制到WEB-INF/classes目录下

4、启动Tomcat，测试WebService
如果Tomcat还没配置好，抽两分钟再配一下。再把Tomcat启动起来。
再打开浏览器，输入：
http://localhost/stove/services
，服务器返回的结果如下：
Available Services:
    * SayHiService [wsdl]
     Generated by XFire ( http://xfire.codehaus.org )
我们看到我们的WebService已经布署成功了，我们再看看它的WSDL信息：

Xml代码

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <wsdl:definitions targetNamespace="http://cn.com.pansky/SayHiService" xmlns:tns="http://cn.com.pansky/SayHiService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">  
3.   <wsdl:types>  
4. <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://cn.com.pansky/SayHiService">  
5. <xsd:element name="sayHi">  
6. <xsd:complexType>  
7. <xsd:sequence>  
8. <xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string"/>  
9. </xsd:sequence>  
10. </xsd:complexType>  
11. </xsd:element>  
12. <xsd:element name="sayHiResponse">  
13. <xsd:complexType>  
14. <xsd:sequence>  
15. <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string"/>  
16. </xsd:sequence>  
17. </xsd:complexType>  
18. </xsd:element>  
19. </xsd:schema>  
20.   </wsdl:types>  
21.   <wsdl:message name="sayHiRequest">  
22.     <wsdl:part name="parameters" element="tns:sayHi">  
23.     </wsdl:part>  
24.   </wsdl:message>  
25.   <wsdl:message name="sayHiResponse">  
26.     <wsdl:part name="parameters" element="tns:sayHiResponse">  
27.     </wsdl:part>  
28.   </wsdl:message>  
29.   <wsdl:portType name="SayHiServicePortType">  
30.     <wsdl:operation name="sayHi">  
31.       <wsdl:input name="sayHiRequest" message="tns:sayHiRequest">  
32.     </wsdl:input>  
33.       <wsdl:output name="sayHiResponse" message="tns:sayHiResponse">  
34.     </wsdl:output>  
35.     </wsdl:operation>  
36.   </wsdl:portType>  
37.   <wsdl:binding name="SayHiServiceHttpBinding" type="tns:SayHiServicePortType">  
38.     <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>  
39.     <wsdl:operation name="sayHi">  
40.       <wsdlsoap:operation soapAction=""/>  
41.       <wsdl:input name="sayHiRequest">  
42.         <wsdlsoap:body use="literal"/>  
43.       </wsdl:input>  
44.       <wsdl:output name="sayHiResponse">  
45.         <wsdlsoap:body use="literal"/>  
46.       </wsdl:output>  
47.     </wsdl:operation>  
48.   </wsdl:binding>  
49.   <wsdl:service name="SayHiService">  
50.     <wsdl:port name="SayHiServiceHttpPort" binding="tns:SayHiServiceHttpBinding">  
51.       <wsdlsoap:address location="http://localhost/stove/services/SayHiService"/>  
52.     </wsdl:port>  
53.   </wsdl:service>  
54. </wsdl:definitions>  

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://cn.com.pansky/SayHiService" xmlns:tns="http://cn.com.pansky/SayHiService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
<wsdl:types>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://cn.com.pansky/SayHiService">
<xsd:element name="sayHi">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="sayHiResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part name="parameters" element="tns:sayHi">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part name="parameters" element="tns:sayHiResponse">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="SayHiServicePortType">
<wsdl:operation name="sayHi">
<wsdl:input name="sayHiRequest" message="tns:sayHiRequest">
</wsdl:input>
<wsdl:output name="sayHiResponse" message="tns:sayHiResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="SayHiServiceHttpBinding" type="tns:SayHiServicePortType">
<wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="sayHi">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="sayHiRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="SayHiService">
<wsdl:port name="SayHiServiceHttpPort" binding="tns:SayHiServiceHttpBinding">
<wsdlsoap:address location="http://localhost/stove/services/SayHiService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

 这个文件跟我们用Axis生成的基本是一样的。

5、享受美味的时刻
WebService这道大餐算是烹制好了，现在是享用美餐的时候了。
我们写一个客户端吃掉这道大餐：

Java代码

1. package cn.com.pansky.webservice.xfire.study;  
2.   
3. import java.net.MalformedURLException;  
4. import java.util.Map;  
5.   
6. import org.codehaus.xfire.client.Client;  
7. import org.codehaus.xfire.client.XFireProxyFactory;  
8. import org.codehaus.xfire.service.Service;  
9. import org.codehaus.xfire.service.binding.ObjectServiceFactory;  
10. import org.codehaus.xfire.transport.http.CommonsHttpMessageSender;  
11.   
12. public class SayHiClient{  
13.   public static void main(String args[]) {  
14.     String serviceURL = "http://localhost/stove/services/SayHiService";  
15.     Service serviceModel = new ObjectServiceFactory().create(SayHiService.class,null,"http://cn.com.pansky/SayHiService",null);  
16.   
17.     XFireProxyFactory serviceFactory = new XFireProxyFactory();  
18.   
19.     try{  
20.       SayHiService service = (SayHiService) serviceFactory.create(serviceModel, serviceURL);  
21.       Client client = Client.getInstance(service);  
22.       //client.addOutHandler(new OutHeaderHandler());  
23.   
24.       // disable timeout  
25.       client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT, "1");  
26.   
27.       String hello = service.sayHi("张山疯");  
28.       System.out.println("服务器对[张山疯] 的回答是：" + hello );  
29.   
30.       hello = service.sayHi(null);  
31.       System.out.println("服务器胡言乱语说：" + hello );  
32.   
33.     } catch (MalformedURLException e) {  
34.       e.printStackTrace();  
35.     }  
36.   }  
37. }  

package cn.com.pansky.webservice.xfire.study;
import java.net.MalformedURLException;
import java.util.Map;
import org.codehaus.xfire.client.Client;
import org.codehaus.xfire.client.XFireProxyFactory;
import org.codehaus.xfire.service.Service;
import org.codehaus.xfire.service.binding.ObjectServiceFactory;
import org.codehaus.xfire.transport.http.CommonsHttpMessageSender;
public class SayHiClient{
public static void main(String args[]) {
String serviceURL = "http://localhost/stove/services/SayHiService";
Service serviceModel = new ObjectServiceFactory().create(SayHiService.class,null,"http://cn.com.pansky/SayHiService",null);
XFireProxyFactory serviceFactory = new XFireProxyFactory();
try{
SayHiService service = (SayHiService) serviceFactory.create(serviceModel, serviceURL);
Client client = Client.getInstance(service);
//client.addOutHandler(new OutHeaderHandler());
// disable timeout
client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT, "1");
String hello = service.sayHi("张山疯");
System.out.println("服务器对[张山疯] 的回答是：" + hello );
hello = service.sayHi(null);
System.out.println("服务器胡言乱语说：" + hello );
} catch (MalformedURLException e) {
e.printStackTrace();
}
}
}

 编译这个类，再执行一下，服务器服务的结果是：

2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase writeRequest
信息: 100 (continue) read timeout. Resume sending the request
2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase readResponse
信息: Discarding unexpected response: HTTP/1.1 100 Continue
服务器对[张山疯] 的回答是：张山疯, 你吃了吗？没吃回家吃去吧。
2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase writeRequest
信息: 100 (continue) read timeout. Resume sending the request
2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase readResponse
信息: Discarding unexpected response: HTTP/1.1 100 Continue
服务器胡言乱语说：连名字也不肯告诉我吗？

好了，WebService布署成功。

下课！

　　有了一些对xml webservice的初步了解后,我们将切入正题,即是用一个具体的webservice事例的形式来讲解具体的webservice用法,用具体的事例来讲解一个概念我想怎么也要比单纯的说理能让人容易理解吧.

　　这里,我们将以一个简单的分布式课件搜索系统为例来讲解.使用VS2003为编译环境,C#为语言,SqlServcer2000为数据库.(这个例子来 源于一位网上朋友的文章的启发,觉得很能代表webservice的特点,就按那个想法做了这么个系统来示例了)

　　首先,明确我们要做什么.我们需要一个对客户的接口,也就是个站点,我们把它称做ServiceGatherSite,它是何种形式都无所谓, 甚至它本身 并不需要数据库,它只是提供给用户一个查询的接口,真正的服务,普通用户是不接触到的.然后,这里我们还需要若干个提供服务的站点,我们可以称它们为资源 站,这里为简单起见,假设有两个资源站,分别叫WebSiteA,WebSiteB,它们可以是不对外公布的,只是为了丰富查询数据而存在.最后,是我们 最需要关注的东西---资源站提供给ServiceGatherSite的服务.两个资源站,就有两个服务,我们称为SiteAService和 SiteBService.两个服务间没有任何关系,内部提供的方法也完全没关联,只是需要把方法如何使用告诉ServiceGatherSite,意思 是,服务只提供查询接口,返回的数据如何处理,服务本身并不管,全由使用服务的站点分配.

　　写了这么多,算是简要的介绍了下有关xml webservice的概念和我们这个例子的结构,下篇文章,我们将开始真正进入代码的设计阶段.

　　上篇文章介绍了些webservice的基本特性和我们例子的结构,这篇文章我们将开始具体的代码编写工作.

　　这个专题主要讲述的是webservice,因此这里我们的代码以Webservice相关为主,而其他工程,例如:ServiceGatherSite,WebSiteA等,只将简略介绍.

　　在VS2003中,开发一个webservice并不是件困难的事,首先,我们新建一个webservice项目(文件->新建->项目->C#->Web服务应用程序)

　　建完这个工程,我们将看到一个叫Service1.asmx的文件,这就是webservice的标准文件,它也有UI的概念,不过我们一般不 关注,因 此,我们查看其cs代码文件.如果你什么都还没做的话,将看见一个被注释掉的helloworld的WebMethod,把注释去掉,在运行,你就可以得 到最简单的webservice运行实例了.点击"helloworld"将执行其方法.显然,这个函数对我们的意义只在于宏观的了解了下web服务的写 法.

　　下面,我们将开始具体介绍webservice的写法.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须 在函数上面 添上一行代码[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.如:

　　以下是引用片段：

　　接上篇文章,我们先简单解释下GetSiteAData(string AssignName)函数.

　　函数功能很简单,只是要返回查询结果,其数据格式是XmlDataDocument.当查询失败时(无匹配查询结果),我们构造一个xml,返 回一个空记 录.否则,我们把查询后的dataset生成一个XmlDataDocument,接下来,由于该项目的需要,我加入了一个循环,添加dataset里所 没有的节点,站点名称.在这之后,算是完成了一个符合我们期望格式的xml数据文档,我们把它返回.

　　好了,webservice的方法函数介绍完了(这里还有个web服务方法,稍后介绍),接下来我们的任务是怎么调用它了.首先把 webservice的 项目编译完成,假定我们这个服务是针对资源站点A的,我们不妨称其为ServiceA.先单独运行asmx文件,执行GetSiteAData (string AssignName)方法,将提示你输入参数,你输入要搜索的内容,点确认,将返回给你一个xml数据,并在ie上显示出来,这就是你搜索到的内容拉.

　　这里对ServiceA的工作再做点介绍,在我们这个项目里,它是资源站点A提供的服务,意思是,它查询的数据将全来源于站点A,而站点A资源添加在本项目也有专门的工程实现.

　　好了,回到正题.这里我介绍vs调用webservice的方法,其实其他平台的调用方法也是大同小异.首先我们介绍web引用方式,这种方式 我强烈建议 调试时使用,非常方便.右击引用,点添加web引用,输入你的webservice地址,如:http: //localhost/aspxproject/WebServiceSolution/SiteBService/service1.asmx,你必 须保证你输入的webservice存在.然后引用即可,注意:web引用名将作为你加入的webservice的名字空间.比如你输入了:SiteA, 那服务的实例化将是这样:SiteA.Service1 serviceA=new SiteA.Service1();(Service1是服务的类名).

　　完成了这一步,service的调用似乎变的那么简单,我们已经实现了远程实例化,接下来的远程调用也是一样的容易.下面给出资源采集站ServiceGatherSite的绑定代码(只采集A站点的信息)

　　以下是引用片段：

　　public void BindData()

　　{

　　serviceA=new SiteA.Service1();

　　DataSet ds=new DataSet();

　　XmlNode xmlNode1;

　　XmlDataDocument xd=new XmlDataDocument();

　　StringBuilder xmlString1;

　　xmlNode1=serviceA.GetSiteAData(strSearch);

　　if(xmlNode1==null) //--存储过程执行失败

　　return;

　　xmlString1=new StringBuilder(xmlNode1.OuterXml);

　　if(xmlString1.ToString().Equals(""))

　　return ;

　　xd.LoadXml(xmlString1.ToString());

　　ds.ReadXml(new XmlNodeReader(xd));

　　DataGrid1.DataSource=ds.Tables["list"].DefaultView;

　　DataGrid1.DataBind();

　　}

此段代码给出了xml转化成dataset的解决方案,虽然这不是必须的,但毕竟在asp.net里,dataset占的作用之重,谁都知道的.其 他的请 朋友们先看(呵呵,个中高手就免了),在下篇文章中将会有对它的一些解释与及多服务分布调用的解决方案,写了三篇了,发现似乎还是有些朋友看的,那我就献 丑继续写下去好了,大家有什么意见也希望提出,在下的理解存在偏驳也再所难免,希望谅解:)

　　接上篇文章,我们先简单说明下绑定函数.首先实例化ServiceA,这个和一般类的实例化并没有不同..接下来用xmlNode1来接受函数的返回值,接下来是构造xml,并将其转化为dataset,这是通用的方法,如果是刚接触不久的朋友,最好能记下这种方法.

　　接下来给出异步调用两个服务的代码

　　以下是引用片段：

　　下面讲下通过dll来引用webservice的方法,我只把流程介绍下.

　　首先,在ie输入服务的地址,如:http://www.xxx.com/service.asmx

　　然后写输入http://www.xxx.com/service.asmx?wsdl

　　打开后,另存为xxx.wsdl

　　然后用vs的命令提示符来编译:wsdl /namespace:SiteA ServiceA.wsdl

　　生成名字空间为sitea的代理类

　　最后csc /out:ServiceA.dll /t:library Service1.cs ,其中service1.cs为代理类文件

　　最后引用dll就可以了.