在Axis中处理复杂的自定义的数据类型

什么是Axis
Axis本质上是一个SOAP引擎,但Axis也不仅仅是一个SOAP引擎,可以称作是一个web services。由于本文重点不在于些,请您参考《Axis用户指南
您必需了解的知识

如果您是一个javaservletSOAP的新手,那您可能会遇到很多关于Axis的麻烦,所以这时不建议您编写Axis的客户和服务程序。当您基本了解了如下知识时,您就可以开始Axis之旅了。

  1. Java的数据类型,类和编程概念的核心。
  2. 什么是线程(threads),竞态条件(race conditions,线程安全(thread safety)和同步(sychronization
  3. 什么是classloader,什么是多等级classloader,和"ClassNotFoundException"异常的共同原因。
  4. 怎么样诊断来自己异常跟踪到的问题,NullPointerExceptionNPE)和其它共同异常是什么,并且知道怎么修改他们。
  5. 什么是web 应用;什么是servlet,类,类库和数据放在Web应用中的什么位置。
  6. 怎么启动您的应用服务,怎么发布一个web应用到应用服务上。
  7. 什么是网络,IP协议概念的核心和那些sockets API。特别是,什么是TCP/IP
  8. 什么是HTTP。核心协议和错误代码,Http头和大部分的验证细节。
  9. 什么是XML。尽管您不需要了解怎么样解释她或是其它的技术,但要知道怎么制定好的样式并且正确的XML
Axis的安装
由于我们在本文中使用Jbuilder 8开发,所以如何安装Axis并不重要。如果您想了解Axis的安装,请您参考《Axis安装说明
开始Jbuider 8Axis之旅
1、打开Jbuider 8,建一个新工程Axistour,再建一个Web应用tour,这里使用tomcat-4.0.6-LE-jdk14
2、建一个Web Services,选择web services configurationOK后按向导的缺省操作进行;
3、 检验Axis工程。编译Axisour工程,选择tour/Root directory/index.html,右键菜单中选择:Web run using “Web Services Server”,其中引号中的Web Services Serverweb services的名字,如果您在前面的向导第二步输入了其它的名字,这里应显示您输入的那个名字;
4、点击index.html中的链接,如果全部正常执行,表示您的Axis已正常工作。特别注意的是”Validate”链接:
5、检验完成开始编写Axis的服务端程序,建一个自己定义的复杂数据类型Data(Data.java),这个类必需是遵循java bean规范。代码如下:
 
package com.neusoft.axistour;
 
import java.util.HashMap;
 
public class Data {
  private String author=null;
  private String address=null;
  private HashMap hmap=null;
  public Data() {
  }
 
  public String getAddress(){
    return address;
  }
  public void setAddress(String address){
    this.address=address;
  }
 
  public String getAouthor(){
    return author;
  }
  public void setAouthor(String author){
    this.author=author;
  }
 
  public HashMap getHMap(){
    return hmap;
  }
  public void setHMap(HashMap map){
    this.hmap=map;
  }
}
6、创建Axis 服务类,DataServices.java
package com.neusoft.axistour;
 
import java.util.HashMap;
public class DataServices {
 
  public Data buildData(String address,String aouthor ){
    Data data=new Data();
    data.setAddress(address) ;
    data.setAouthor(aouthor) ;
    HashMap map=new HashMap();
    map.put("key1","value1") ;
    map.put("key2","value2") ;
    map.put("key3","value3") ;
    data.setMap(map);
    return data;
  }
}
 
7、选择DataServices.java,右键菜单中选择Export as a web services,按缺省的向导,完成Axis的导出,生成deploy.wsddwsdl,其中deploy.wsdd至关重要,而wsdl文件在这里并不重要;
8、到此您已完成Axis的服务程序,编译整个工程,启动web services
9、测试wsdl,如果您的Http端口是8080(如果您本机的web服务不是8080,请改为您本机相应的端号,请访问如下URLhttp://localhost:8080/tour/services/DataServices?wsdl
10、            Java客户端代码您可以参考向导产生的Junit测试类,所以这里不再说明。您可以运行Junit测试类:com.neusoft.axistour.generated. DataServicesServiceTestCase,如果正确,则测试成功。
11、            VB客户端代码,由于使用了自定义的数据类型,所以只能使用microsoft soap开发包的低端API,这里使用SOAP Toolkit 2.0,代码如下:
Option Explicit
 
Private Sub Command1_Click()
On Error GoTo ErrorHandler
   
    Dim Serializer As SoapSerializer
    Dim Reader As SoapReader
    Dim Connector As SoapConnector
    Dim Method As String
   
    Dim Dom As MSXML2.DOMDocument30
    Dim Elm As IXMLDOMElement
   
    Method = Trim(Text2.Text)
    If Method = "" Then
      MsgBox "请输入方法名!"
      Exit Sub
    End If
    Set Connector = New HttpConnector
    Connector.Property("EndPointURL") = Text1.Text
    'Connector.Property("SoapAction") = BASE_SOAP_ACTION_URI & Method
    Connector.BeginMessage
   
    Set Serializer = New SoapSerializer
    Serializer.Init Connector.InputStream
   
    Serializer.startEnvelope
    Serializer.startBody
    Serializer.startElement Method, "", "", ""
 
'方法的参数
Serializer.startElement "address"
    Serializer.writeString "dalian"
    Serializer.endElement
Serializer.startElement "aouthor"
    Serializer.writeString "neusoft"
    Serializer.endElement
   
    Serializer.endElement
    Serializer.endBody
    Serializer.endEnvelope
   
    Connector.EndMessage
   
    Set Reader = New SoapReader
    Reader.Load Connector.OutputStream
   
    If Not Reader.Fault Is Nothing Then
        MsgBox Reader.faultstring.Text, vbExclamation
    Else
        Text3.Text = Reader.Dom.xml
    End If
 
    Exit Sub
   
ErrorHandler:
 
    MsgBox "ERROR: " & Err.Description, vbExclamation
    Err.Clear
    Exit Sub
 
End Sub
 
Private Sub Form_Load()
Text1.Text = "http://localhost:8080/tour/services/DataServices?wsdl"
Text2.Text = ""
Text3.Text = ""
End Sub
12、            VC代码,建一个Win32 Console Application

#include "stdafx.h"

#include <stdio.h>

#import "msxml3.dll"

using namespace MSXML2;

//根据自己机器的情况修改下面语句中指定的路径

#import "C:/Program Files/Common Files/MSSoap/Binaries/mssoap1.dll" /

        exclude("IStream", "ISequentialStream", "_LARGE_INTEGER", /

        "_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME")

 

using namespace MSSOAPLib;

 

void axisTourClient(){   

       ISoapSerializerPtr Serializer;

       ISoapReaderPtr Reader;

       ISoapConnectorPtr Connector;

       // 联接services    

       Connector.CreateInstance(__uuidof(HttpConnector));

       Connector->Property["EndPointURL"] = "http://localhost:8080/tour/services/DataServices?wsdl";

       Connector->Connect(); 

       // Begin message

       Connector->BeginMessage();

       // Create the SoapSerializer   

       Serializer.CreateInstance(__uuidof(SoapSerializer));   

       // Connect the serializer to the input stream of the connector

       Serializer->Init(_variant_t((IUnknown*)Connector->InputStream));  

 

       // Build the SOAP Message   

       Serializer->startEnvelope("","","");

       Serializer->startBody("");      

       Serializer->startElement("buildData","","","");

//参数

Serializer->startElement("address","","","");
Serializer->writeString( "dalian");
Serializer->endElement();
Serializer->startElement("aouthor","","","");
Serializer->writeString ("neusoft");
Serializer->endElement();

 

       Serializer->endElement();

       Serializer->endBody();  

       Serializer->endEnvelope();           

      

       Connector->EndMessage();       

      

       Reader.CreateInstance(__uuidof(SoapReader));  

       Reader->Load(_variant_t((IUnknown*)Connector->OutputStream), "");   

 

       // 显示结果

       printf("Response: %s/n", (const char*)Reader->DOM->xml ); 

}

 

int main(int argc, char* argv[])

{

       CoInitialize(NULL);

       axisTourClient();   

       CoUninitialize();     

      

       return 0;

}

13、            到现在为止可以说您走出Axis之旅的第一步。
最后说明:
1、Axis中,将自定义的复杂数据类型序列化成xml有两种方法,一种方法是前面使用的JavaBean方法,使用Axis提供的Bean序列化工厂(BeanSerializerFactory)来实现序列化;另一种方法是自己编写序列化工厂和反序列化工厂,这种方法这里将不做说明。另外其它web service产品也应提供这两种方法;
2、虽然前面曾说到wsdl不重要,这只是说在这里不重要,Axis会利用web-inf下的server-config.wsdd web服务发布描述文件(Web Service Deployment Descriptor生成wsdl,其实wsdl依然是web services的核心描述;
3、如果生成的war包在某些版本的tomcat或其它web引擎中不能运行,请参考Axis的安装说明;

如果您的程序没有正常运行,请您通过msn和我联系:jlzzb@hotmial.com

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值