Axis实践之Axis入门

第一部分： 安装Axis

第一步： 下载Axis
从Apache网站下载Axis发布包：
http://ws.apache.org/axis/

我下载的是
Axis 1.4 Final 版


第二步： 解压Axis压缩包
把下载的axis-bin-1_4.zip包解压缩到一个文件夹，可以是任意的，但如果文件夹包含中文名时，在中间有些过程需要对中文进行一些处理，否则可能出错；
我把axis-bin-1_4.zip解压到 F:/AXIS_Study，解压后的目录结构是这样的：
F:/AXIS_Study
??? |
??? |____axis-bin-1_4
??? |
??? |-----docs (文件夹)
??? |
??? |-----lib (文件夹)
??? |
??? |-----samples (文件夹)
??? |
??? |-----webapps (文件夹)
??? |
??? |-----xmls (文件夹)
??? |
??? |-----LICENSE
??? |
??? |-----NOTICES
??? |
??? |-----README
??? |
??? |-----release-notes.html

第三步：准备Web Server
准备一个Web Server，基本上所有主流的Web Server都可以，为了节省资源，我使用Tomcat5.5.23来讲解这个例子，大家可以自行到Apache网站上下载该版本的Tomcat。


第四步： 配置Tomcat
进入Tomcat目录，在conf/Catalina/localhost目录下新建一个XML文件，命名为axis.xml，然后在文件中输入如下内容：

<?xml version="1.0" encoding="gb2312"?> 
<!-- 
Axis学习工程 
--> 
<Context docBase="F:/AXIS_Study/axis-bin-1_4/webapps/axis" > 
</Context> 

?
这个文件是用来在Tomcat中配置一个Web应用的，这不在本次课程的范围，大家可以自行找相关资料来看。注意在文件中
docBase="F:/AXIS_Study/axis-bin-1_4/webapps/axis"
是指向Axis解压目录下面的webapps/axis目录，大家根据自己的目录结构自行修改


第五步：启动Tomcat
进入到Tomcat安装目录下的bin目录，找到startup.bat并执行之，在启动过程中，控制台窗口应该会出现以下信息：
2008-5-15 14:45:55 org.apache.catalina.core.AprLifecycleListener lifecycleEvent
信息: The Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: D:/JAVATools/jdk1.5.0
_05/bin;.;C:/windows/system32;C:/windows;D:/tools/系统/UnxUtils/bin;D:/tools/系统/UnxUtils/usr/local/wbin;D:/JAVATools/jdk1.5.0_05/bin;C:/oracle92/bin;C:/Progra
m Files/Oracle/jre/1.3.1/bin;C:/Program Files/Oracle/jre/1.1.8/bin;C:/windows/system32;C:/windows;C:/windows/System32/Wbem;D:/tools/系统;D:/JAVATools/ant-1.6.2/
bin
2008-5-15 14:45:55 org.apache.coyote.http11.Http11BaseProtocol init
信息: Initializing Coyote HTTP/1.1 on http-80
2008-5-15 14:45:55 org.apache.catalina.startup.Catalina load
信息: Initialization processed in 859 ms
2008-5-15 14:45:55 org.apache.catalina.core.StandardService start
信息: Starting service Catalina
2008-5-15 14:45:55 org.apache.catalina.core.StandardEngine start
信息: Starting Servlet Engine: Apache Tomcat/5.5.23
2008-5-15 14:45:55 org.apache.catalina.core.StandardHost start
信息: XML validation disabled
- Unable to find config file. Creating new servlet engine config file: /WEB-INF/server-config.wsdd
- Unable to find required classes (javax.activation.DataHandler and javax.mail.internet.MimeMultipart). Attachment support is disabled.

……

注意，最后面三行指示了Axis 的web app已经启动了，因为在我的Tomcat中发布的应用中，没有其他应用有使用Web Service，现在出现 .wsdd 文件，肯定就是Axis的应用启动了。
我们到
F:/AXIS_Study/axis-bin-1_4/webapps/axis/WEB-INF
目录下查看，发现系统自动生成了一个attachments目录，这与启动日志中的Attachment support is disabled.是对应的。



第六步：查看一下当前Axis中布署了哪些Web Service
打开浏览器，在地址栏输入：
http://localhost/axis/servlet/AxisServlet

浏览器显示结果：
And now... Some Services

? AdminService (wsdl)
????? AdminService
? Version (wsdl)
???? getVersion
这说明在Axis中已经布署了两个WebService，只不过这两个WebService都是Axis自带的，第一个是管理用的WebService，第二个是查看当前Axis版本信息的WebService。
大家可以点击相应的链接“wsdl”来看一下这两个WebService的 wsdl 文件。


结语：
至此，我们已经成功地把Axis 1.4 安装到Tomcat Web 服务器上了，接下来的目标是使用Axis来发布Web Service。



第二部分： 使用Axis发布Web Service
Axis提供两种方式将Java类发布成Web Services，这两种方式分别是：即时快速自动发布 和 通过配置文件进行发布，下面我们按顺序来讲如何使用这两种方式来发布WebService

即时快速自动发布：
第一步： 编写业务类
为了发布一个Web Service,首先必须要有业务类，为了节约时间，我写一个最简单的业务类：

public class SayHello{ 
  private String name; 
  public String hello(){ 
    return "Hello,axis Ver1.4 talking to you."; 
  } 
} 

?
注意，采用快速自动发布的Web Service的业务类不能带 package，也不能实现任何接口（Interface），因为Axis自动发布时不支持Package。


第二步：把SayHello发布为Web Service
把SayHello.java复制到 axis目录下的webapps/axis目录下，然后把文件扩展名改为：jws


第三步：访问刚发布的Web Service
打开浏览器，在地址栏里输入：
http://localhost/axis/SayHello.jws

浏览器显示结果如下：
There is a Web Service here

Click to see the WSDL

这表示Web Service已经发布成功了。我们可以点击连接“Click to see the WSDL ”来看看生成的wsdl文件：

<?xml version="1.0" encoding="UTF-8"?> 
<wsdl:definitions targetNamespace="http://localhost/axis/SayHello.jws" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost/axis/SayHello.jws" xmlns:intf="http://localhost/axis/SayHello.jws" 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 created by Apache Axis version: 1.4 
Built on Apr 22,2006 (06:55:48 PDT)--> 
  <wsdl:message name="helloResponse"> 
    <wsdl:part name="helloReturn" type="xsd:string"/> 
  </wsdl:message> 
  <wsdl:message name="helloRequest"> 
  </wsdl:message> 
  <wsdl:portType name="SayHello"> 
    <wsdl:operation name="hello"> 
      <wsdl:input message="impl:helloRequest" name="helloRequest"/> 
      <wsdl:output message="impl:helloResponse" name="helloResponse"/> 
    </wsdl:operation> 
  </wsdl:portType> 

<wsdl:binding name="SayHelloSoapBinding" type="impl:SayHello"> 
  <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> 
  <wsdl:operation name="hello"> 
    <wsdlsoap:operation soapAction=""/> 
    <wsdl:input name="helloRequest"> 
        <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://DefaultNamespace" use="encoded"/> 
    </wsdl:input> 
    <wsdl:output name="helloResponse"> 
      <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost/axis/SayHello.jws" use="encoded"/> 
    </wsdl:output> 
  </wsdl:operation> 
</wsdl:binding> 

  <wsdl:service name="SayHelloService"> 
    <wsdl:port binding="impl:SayHelloSoapBinding" name="SayHello"> 
      <wsdlsoap:address location="http://localhost/axis/SayHello.jws"/> 
    </wsdl:port> 
  </wsdl:service> 
</wsdl:definitions> 

?这个文件结构跟我们以前用IDE生成的没什么两样。

我们再访问一下这个Web Service，看看结果对不对，在浏览器地址栏输入：
http://localhost/axis/SayHello.jws?method=hello

浏览器显示服务器返回的结果：

<?xml version="1.0" encoding="UTF-8" ?> 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
  <soapenv:Body> 
    <helloResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> 
      <helloReturn xsi:type="xsd:string">Hello,axis Ver1.4 talking to you.</helloReturn> 
    </helloResponse> 
  </soapenv:Body> 
</soapenv:Envelope> 

?这里返回的是整个SOAP数据包

接头我们用Jbuilder来生成该Web Service的客户端代码：
打开Jbuilder，新建一个工程，然后增加Axis Web Service Client支持：
菜单： New --> Web Service(J2EE1.3) --> Axis Web Service Client Configuration
然后在Web Service设计器中选择“Import from URL”，其中的wsdl文件路径就输入“http://localhost/axis/SayHello.jws?wsdl”
Jbuilder就自动帮我们生成了所有配置。然后再make这个web service，这时候JBuilder自动生成了所需要的全部代码，还包括一个JUnit测试类 SayHelloServiceTestCase，为了能更直观地看到结果，我们再写一个自己的测试类：

public class SayHelloTest { 
  public void test(){ 
    SayHelloSoapBindingStub binding; 
    try { 
      binding = (SayHelloSoapBindingStub) new SayHelloServiceLocator().getSayHello(); //取接口 

    binding.setTimeout(60000); //设置超时时间 

    String helloMsg = binding.hello(); //调用hello方法 
 
    System.out.println(">>>>>>>>>>>>>>>>服务器返回消息："); 
      System.out.println( helloMsg ); 
      System.out.println("<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<"); 
    }catch (javax.xml.rpc.ServiceException ex) { 
      if (ex.getLinkedCause() != null) 
        ex.getLinkedCause().printStackTrace(); 
      System.out.println("JAX-RPC调用出错："); 
      ex.printStackTrace(); 
    } catch (RemoteException ex) {   
      System.out.println("Web Service调用出错："); 
      ex.printStackTrace(); 
  } 

  } 
  
  public static void main(String[] args) { 
    SayHelloTest sayhellotest = new SayHelloTest(); 

    sayhellotest.test(); 
  } 
} ?

?
编译，然后执行该类，得到输出结果是：
>>>>>>>>>>>>>>>>服务器返回消息：
Hello,axis Ver1.4 talking to you.
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

至此，我们通过Axis自动发布的Web Service成功了。


＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
通过配置文件（WSDD）进行发布：

第一步：先写一个配置文件 server-config.wsdd

<?xml version="1.0" encoding="UTF-8"?> 
<deployment name="defaultClientConfig" 
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java" 
xmlns:handler="http://xml.apache.org/axis/wsdd/providers/handler" xmlns="http://xml.apache.org/axis/wsdd/"> 
  <globalConfiguration name="defaultClientConfig"> 
    <requestFlow name="RequestFlow1" type=""> 
        <handler name="Handler1" type="java:org.apache.axis.handlers.JWSHandler"> 
          <parameter name="scope" value="session"/> 
        </handler> 
        <handler name="Handler2" type="java:org.apache.axis.handlers.JWSHandler"> 
            <parameter name="scope" value="request"/> 
            <parameter name="extension" value=".jwr"/> 
        </handler> 
      </requestFlow> 
    </globalConfiguration> 
    <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/> 
    <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/> 
    <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/> 
    <transport name="http" type=""> 
        <requestFlow name="RequestFlow1" type=""> 
        <handler name="Handler1" type="URLMapper"/> 
        <handler name="Handler2" type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/> 
      </requestFlow> 
    </transport> 
    <transport name="local" type=""> 
        <responseFlow name="ResponseFlow1" type=""> 
            <handler name="Handler1" type="LocalResponder"/> 
        </responseFlow> 
    </transport> 

  <!--这里配置了一个Web Service，如果有多个Web Service，就按这种格式在下面增加即可--> 
  <service name="SayHello2" provider="java:RPC"> 
    <parameter name="scope" value="Request"/> 
    <parameter name="className" value="SayHello"/> 
    <parameter name="allowedMethods" value="*"/> 
  </service> 

</deployment> 

?
需要注意的通过配置文件来发布Web Service时，业务类是可以有package的，这里为了利用上面的业务类，所以就没有package

然后把该配置文件放置到WEB-INF目录下。

第二步：编译业务类
把上面写的业务编译成class文件，放到WEB-INF/classes目录下

第三步：重启Tomcat

第四步： 查看新发布的Web Service
打开浏览器，地址栏里输入： http://localhost/axis/servlet/AxisServlet
浏览器返回的结果如下：
And now... Some Services
SayHello2 (wsdl)
hello

这表明我们的新Web Service发布成功了，我们可以进一步看一下wsdl文件：

<?xml version="1.0" encoding="UTF-8"?> 
<wsdl:definitions targetNamespace="http://localhost/axis/services/SayHello2" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost/axis/services/SayHello2" xmlns:intf="http://localhost/axis/services/SayHello2" 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 created by Apache Axis version: 1.4 
Built on Apr 22,2006 (06:55:48 PDT) 
--> 
<wsdl:message name="helloRequest"> 
</wsdl:message> 
<wsdl:message name="helloResponse"> 
<wsdl:part name="helloReturn" type="soapenc:string"/> 
</wsdl:message> 
<wsdl:portType name="SayHello"> 
<wsdl:operation name="hello"> 
<wsdl:input message="impl:helloRequest" name="helloRequest"/> 
<wsdl:output message="impl:helloResponse" name="helloResponse"/> 
</wsdl:operation> 
</wsdl:portType> 
<wsdl:binding name="SayHello2SoapBinding" type="impl:SayHello"> 
<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> 
<wsdl:operation name="hello"> 
<wsdlsoap:operation soapAction=""/> 
<wsdl:input name="helloRequest"> 
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://DefaultNamespace" use="encoded"/> 
</wsdl:input> 
<wsdl:output name="helloResponse"> 
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost/axis/services/SayHello2" use="encoded"/> 
</wsdl:output> 
</wsdl:operation> 
</wsdl:binding> 

<wsdl:service name="SayHelloService"> 
<wsdl:port binding="impl:SayHello2SoapBinding" name="SayHello2"> 
<wsdlsoap:address location="http://localhost/axis/services/SayHello2"/> 
</wsdl:port> 
</wsdl:service> 
</wsdl:definitions> 

?
第五步：写测试客户端
在Jbuilder中，刚才的工程里增加一个Web Service客户端，还是在Web Service设计器中选择“Import from URL”，其中的wsdl文件路径就输入“http://localhost/axis/services/SayHello2?wsdl”，然后make这个web service module。同样的，我们也再写一个自己的测试类：

public class SayHello2Test { 
    public void test(){ 
        SayHello2SoapBindingStub binding; 
        try { 
            binding = (SayHello2SoapBindingStub) new SayHello2ServiceLocator().getSayHello(); //取接口 

            binding.setTimeout(60000); //设置超时时间 

            String helloMsg = binding.hello(); //调用hello方法 

            System.out.println(">>>>>>>>>>>>>>>>服务器返回消息："); 
            System.out.println( helloMsg ); 
            System.out.println("<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<"); 
        }catch (javax.xml.rpc.ServiceException ex) { 
            if (ex.getLinkedCause() != null) 
                ex.getLinkedCause().printStackTrace(); 
            System.out.println("JAX-RPC调用出错："); 
            ex.printStackTrace(); 
        } catch (RemoteException ex) { 
            System.out.println("Web Service调用出错："); 
            ex.printStackTrace(); 
        } 

    } 

    public static void main(String[] args) { 
        SayHello2Test sayhellotest = new SayHello2Test(); 

        sayhellotest.test(); 
    } 
} 

?运行这个测试类，得到的输出结果是： >>>>>>>>>>>>>>>>服务器返回消息： 你好，现在是 axis Ver1.4 在与你对话。 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< OK,一切尽在掌握中，哈哈！