axis1.4集成和应用示例

axis1.4集成和应用示例

 

前言：网上很多有关axis1.4的应用示例，大部分是官方doc的翻译和example的翻译，helloword等等。

          最近有个需求是提供带参数的方法接口，返回自定义对象，刚好熟悉下axis1.4用法。

 

 

步骤:

 

1:下载axis1.4的包解压到本地，至于axis的环境变量看情况，想配就配，不想配也无所谓，就是使用axis的命令时候会麻烦点。

 

2:查看axis-1_4\docs\install.html下的 《

Advanced Installation: adding Axis to your own Webapp

》一项内容，这个是将axis1.4集成到自己的web应用里的方法，网上大部分教你的是直接将axis1.4包里的web应用放入tomcat里，然后在此基础上开发自己的webservice，其实是一样的道理，将该web里的web.xml里的内容copy到自己原有web应用的web.xml里，然后将axis1.4的lib里的相关依赖包加到自己的web里就可以在自己的应用里开发webservice了。

 

3：相关代码

    3.1:pojo类

 

package com.asiainfo.boss.channel.channelservices;

import java.io.Serializable;

public class MenuNodeInterface implements Serializable{
	/**
	 * serId
	 */
	private static final long serialVersionUID = 4859157035701539929L;
	/**
	 * 菜单名称
	 */
	private String S_Caption;

	public MenuNodeInterface(){
		this.S_Caption="陈超";
	}

	public String getS_Caption() {
		return S_Caption;
	}

	public void setS_Caption(String caption) {
		S_Caption = caption;
	}
	
	
}

 

   3.2:封装的结果类

package com.asiainfo.boss.channel.channelservices;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;

public class EsopResult1 implements Serializable{

	/**
	 * seriaId
	 */
	private static final long serialVersionUID = -1922115715606536898L;
	
	/**
	 * 0:成功
	   1:失败
	 */
	private Short returnCode=1;
	
	private List<MenuNodeInterface> sysMenuNodeList;
	
	private String errorMsg;
	
	public EsopResult1(){
		sysMenuNodeList=new ArrayList<MenuNodeInterface>();
		sysMenuNodeList.add(new MenuNodeInterface());
		
	}

	public Short getReturnCode() {
		return returnCode;
	}

	public void setReturnCode(Short returnCode) {
		this.returnCode = returnCode;
	}

	public List<MenuNodeInterface> getSysMenuNodeList() {
		return sysMenuNodeList;
	}

	public void setSysMenuNodeList(List<MenuNodeInterface> sysMenuNodeList) {
		this.sysMenuNodeList = sysMenuNodeList;
	}

	public String getErrorMsg() {
		return errorMsg;
	}

	public void setErrorMsg(String errorMsg) {
		this.errorMsg = errorMsg;
	}
	
	
	
	
}

  

   3.3:服务端类

package com.asiainfo.boss.channel.channelservices;

import com.asiainfo.boss.channel.channelservices.EsopResult1;

public class EsopWBService1 {
	
	public EsopResult1 qryMenuNodeInfoList(long opId,long orgId){
		EsopResult1 er1=new EsopResult1();
		er1.setReturnCode((short)0);
		er1.setErrorMsg("成功");
		return er1;
	}
}

  

   3.4：客户端类

package com.asiainfo.boss.channel.channelservices;

import java.util.List;

import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import org.apache.axis.encoding.ser.BeanDeserializerFactory;
import org.apache.axis.encoding.ser.BeanSerializerFactory;

public class EsopWBClient1 {
	
	public static void main(String...args){
		getResult();
	}
	public static void getResult(){
		try {   
            String endpoint = "http://localhost:8091/bjchannel/services/EsopWBService1";   
            Long opId = new Long(1009);   
            Long orgId = new Long(1000);   
               
            Service service = new Service();   
            Call call = (Call) service.createCall();   
            QName qn = new QName("urn:EsopWBService1","EsopResult1"); 
            QName qn1 = new QName("urn:EsopWBService1","MenuNodeInterface"); 
            //注册 bean   
            call.registerTypeMapping(EsopResult1.class, qn,    
                    new BeanSerializerFactory(EsopResult1.class, qn),    
                    new BeanDeserializerFactory(EsopResult1.class, qn));  
            call.registerTypeMapping(MenuNodeInterface.class, qn1,    
                    new BeanSerializerFactory(MenuNodeInterface.class, qn1),    
                    new BeanDeserializerFactory(MenuNodeInterface.class, qn1));  
  
            call.setTargetEndpointAddress(new java.net.URL(endpoint));   
            call.setOperationName(new QName("EsopWBService1","qryMenuNodeInfoList"));
//            Object[] sss=new Object[2];
//            sss[0]=i1;
//            sss[1]=i2;
            //EsopResult1 ret = (EsopResult1) call.invoke("qryMenuNodeInfoList",new Object[]{i1,i2});
            //以下两个参数必须加，不然后报数组越界异常,因为源码里的operation为的params需要手动设置
            //invoke只负责往里传递数，不管原来方法参数的初始化,以下两句表明调用的方法需要初始化两个参数
            call.addParameter("opId", XMLType.XSD_LONG, ParameterMode.IN);
            call.addParameter("orgId", XMLType.XSD_LONG, ParameterMode.IN);
            EsopResult1 ret = (EsopResult1) call.invoke(new Object[]{opId,orgId});
            
  
            System.out.println("the operation result following:");   
            System.out.println("ErrorMsg = " + ret.getErrorMsg());   
            System.out.println("ReturnCode = " + ret.getReturnCode());   
            System.out.println("MenuNodeList().size() = " + ret.getSysMenuNodeList().size());
            
            List<MenuNodeInterface> reList=ret.getSysMenuNodeList();
            
            for(MenuNodeInterface mni : reList){
            	System.out.println("菜单名称:"+mni.getS_Caption());
            }
             
        } catch (Exception e) {   
            e.printStackTrace();   
        }   
    }   
	
}

 

注：以上类涉及到的包名和应用路径名称是我现在所在公司的应用名，大家自行修改，比如bjchannel等等，根据自己情况修改。还要注意客户端类里的参数add一定要加，我开始没加就一直报数组越界异常，不知道是axis1.4相关包的问题，还是什么，我看网上和官方的ORDER示例都没有加也没事，不过加了反正没坏处。

 

4:我直接使用定制方式发布了，即时发布的方式大家参看附件文档

 

    4.1：新建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="GlobalConfiguration1" type="" regenerateElement="false">
        <requestFlow name="RequestFlow1" type="" regenerateElement="false">
            <handler name="Handler1"
                type="java:org.apache.axis.handlers.JWSHandler" regenerateElement="false">
                <parameter name="scope" value="session" regenerateElement="false"/>
            </handler>
            <handler name="Handler2"
                type="java:org.apache.axis.handlers.JWSHandler" regenerateElement="false">
                <parameter name="scope" value="request" regenerateElement="false"/>
                <parameter name="extension" value=".jwr" regenerateElement="false"/>
            </handler>
        </requestFlow>
    </globalConfiguration>
    <handler name="URLMapper"
        type="java:org.apache.axis.handlers.http.URLMapper" regenerateElement="false"/>
    <handler name="LocalResponder"
        type="java:org.apache.axis.transport.local.LocalResponder" regenerateElement="false"/>
    <handler name="Authenticate"
        type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" regenerateElement="false"/>
    <transport name="http" type="" regenerateElement="false">
        <requestFlow name="RequestFlow1" type="" regenerateElement="false">
            <handler name="Handler1" type="URLMapper" regenerateElement="false"/>
            <handler name="Handler2"
                type="java:org.apache.axis.handlers.http.HTTPAuthHandler" regenerateElement="false"/>
        </requestFlow>
    </transport>
    <transport name="local" type="" regenerateElement="false">
        <responseFlow name="ResponseFlow1" type="" regenerateElement="false">
            <handler name="Handler1" type="LocalResponder" regenerateElement="false"/>
        </responseFlow>
    </transport>
    <service name="AdminService" type="" regenerateElement="false" provider="java:MSG">
        <parameter name="allowedMethods" value="AdminService" regenerateElement="false"/>
        <parameter name="enableRemoteAdmin" value="false" regenerateElement="false"/>
        <parameter name="className" value="org.apache.axis.utils.Admin" regenerateElement="false"/>
        <namespace>http://xml.apache.org/axis/wsdd/</namespace>
    </service>
    <service name="Version" type="" regenerateElement="false" provider="java:RPC">
        <parameter name="allowedMethods" value="getVersion" regenerateElement="false"/>
        <parameter name="className" value="org.apache.axis.Version" regenerateElement="false"/>
    </service>

          
		<service name="com.asiainfo.boss.channel.channelbj.mobileplat.MobilePlatform" type="" regenerateElement="false" provider="java:AIRPC">
		  <parameter name="scope" value="session" regenerateElement="false"></parameter>
		  <parameter name="className" value="com.asiainfo.boss.channel.channelbj.mobileplat.IMobilePlatform" regenerateElement="false"></parameter>
		  <parameter name="allowedMethods" value="*" regenerateElement="false"></parameter>
		</service>
		
	<!-- 商机处理 提供给crm接口 -->
	<service name="com.asiainfo.boss.channel.channelbj.channelcomp2.webservice.busiinfo.BusiInfoDeal" provider="java:AIRPC">
	   <parameter name="scope" value="session" regenerateElement="false"></parameter>
	   <parameter name="className" value="com.asiainfo.boss.channel.channelbj.channelcomp2.webservice.busiinfo.IBusiInfoDeal" regenerateElement="false"></parameter>
	   <parameter name="allowedMethods" value="*" regenerateElement="false"></parameter>
	</service>
	
<!-- 本文示例接口 -->
	<service name="EsopWBService1" provider="java:RPC">
	   <parameter name="scope" value="session" ></parameter>
	   <parameter name="className" value="com.asiainfo.boss.channel.channelservices.EsopWBService1" ></parameter>
	   <parameter name="allowedMethods" value="*" ></parameter>
	   
	   <beanMapping languageSpecificType="java:com.asiainfo.boss.channel.channelservices.EsopResult1"  
         qname="ccs:EsopResult1" xmlns:ccs="urn:EsopWBService1"  
         />
       <beanMapping languageSpecificType="java:com.asiainfo.boss.channel.channelservices.MenuNodeInterface"  
         qname="ccs:MenuNodeInterface" xmlns:ccs="urn:EsopWBService1"  
         />
	</service>
	
</deployment>
 

    注:大家可能看到该配置文件里的前两个服务采用的provider="java:AIRPC"，而在axis-1_4\docs\apiDocs\index.html文档里的org.apache.axis.providers.java包下并没有个叫AIRPC的，这个不用管，因为这个是公司扩展的providers，主要是取service方便，按照公司自己的框架取service方式来取。大家看最后的示例接口，都采用provider="java:RPC"即可。自己跑示例将java:AIRPC的service都删除即可。

   另外该文件要放在你的web应用的WEB-INF目录下，例如：WEB-INF\server-config.wsdd

5:启动你的servlet容器，然后跑EsopWBClient1类看结果

OK,附件是相关代码，配置文件和文档,还有就是参看axis1.4的doc和apiDoc以及examples

另外以下是参考链接

http://log-cd.iteye.com/blog/469491

http://chenjumin.iteye.com/blog/240206

http://watching2008.iteye.com/blog/406102

http://topic.csdn.net/u/20080121/16/EE41AF56-CB1D-499E-8F4E-2BED110A74AA.html 我是看了这个才想到要在客户端代码里addParameter的

http://www.pusuo.net/2010-09-26/111294895.html

http://group.gimoo.net/review/116408

 

 

服务测试路径，我的是http://localhost:8091/bjchannel/services/EsopWBService1

wsdl是http://localhost:8091/bjchannel/services/EsopWBService1?wsdl

 

大家自己看情况修改吧，路径中的“services”是你的web.xml里axisServlet对应的urlMapping,你改成别的也行