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,你改成别的也行
?