从今天开始我将学习axis的经验以笔记的形式共享给大家希望能对大家的工作有所帮助。
相信大家对webservice有一定的了解我在这里就不再复述webservice的一些基本概念。
axis1.3是soap1.2协议的一个实现框架。在工作中我们可以方便的通过axis进行webservice的开发。
废话少说,我们开始安装axis.
我们可以从axis的官方网站上下载(http://ws.apache.org/axis/).解压缩axis-bin-1_3.zip。在lib中包含axis必须使用的jar包。docs中包含axis的文档,通常使用用户指南就可以解决大部分问题。samples中包含很多webservice的例子,以后会对这些例子进行进一步讲解。webapps文件夹中包含了一个axis web application你可以直接把他部署到tomcat中,然后在这个axis应用上发布你的webservice,发布成功后就可以调用了。build文件夹用来存放用ant编译的axis安装包的classes文件。
第一个步骤:安装axis.( Axis 1.3,tomcat 5.028, jdk 1.42)
copy axis-bin-1_3安装包下webapps文件夹中的axis目录到tomcat的webapps下发布你的axis应用。重新启动tomcat.访问http://localhost:8080/axis 。这时就会出现axis的欢迎画面.进入Validation链接以检查axis所使用的jar包是否全都存在。如果不存在就会显示一下画面:
我们可以根据链接下载axis缺少的jar文件,下载之后copy到tomcat\webapps\myaxis\WEB-INF\lib下即可。一般情况下还会有一些warning消息,里面列出的的选项不是必须存在的jar包。当所有必须的jar文件全部安装完毕,则会出现以下画面。
表示axis已经具备所有需要的jar文件!
第二步骤:测试axis。
在测试axis之前我们需要一些准备工作。我们首先要把axis用到的jar包添加到CLASSPATH环境变量中去。如下:
C:\tomcat5\webapps\axis\WEB-INF\lib\axis.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\jaxrpc.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\saaj.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\commons-discovery-0.2.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\commons-logging-1.0.4.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\wsdl4j-1.5.1.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\activation.jar;
C:\tomcat5\webapps\axis\WEB-INF\lib\mail.jar
注意路径是根据自己部属情况而定,上面的只是参考。
我们通过JWS (Java Web Service)文件的方式来发布一个webservice。首先在安装包的axis-bin-1_3\axis-1_3\samples\userguide\example2目录下找到Calculator .java文件,将其改名为Calculator .jws然后copy到tomcat的webapps/axis/下。发布这个webservice。这个webservice提供了两个功能即加减功能。
Webservice code:
public class Calculator {
public int add(int i1, int i2)
{
return i1 + i2;
}
public int subtract(int i1, int i2)
{
return i1 - i2;
}
}
Client code:
package samples.userguide.example2 ;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import org.apache.axis.utils.Options;
import javax.xml.rpc.ParameterMode;
public class CalcClient
{
public static void main(String [] args) throws Exception {
Options options = new Options(args);
String endpoint = "http://localhost:" + options.getPort() +
"/axis/Calculator.jws";
args = options.getRemainingArgs();
if (args == null || args.length != 3) {
System.err.println("Usage: CalcClient arg1 arg2");
return;
}
String method = args[0];
if (!(method.equals("add") || method.equals("subtract"))) {
System.err.println("Usage: CalcClient arg1 arg2");
return;
}
Integer i1 = new Integer(args[1]);
Integer i2 = new Integer(args[2]);
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress( new java.net.URL(endpoint) );
call.setOperationName( method );
call.addParameter( "op1", XMLType.XSD_INT, ParameterMode.IN );
call.addParameter( "op2", XMLType.XSD_INT, ParameterMode.IN );
call.setReturnType( XMLType.XSD_INT );
Integer ret = (Integer) call.invoke( new Object [] { i1, i2 });
System.out.println("Got result : " + ret);
}
}
下面我们来进行调用。首先进入客户端源代码所在位置,也可以将源代码所在目录添加到classpath中
(C:\Documents and Settings\y41yang\Desktop\software\axis-bin-1_3\axis-1_3;):
然后输入java samples.userguide.example2.CalcClient -p8080 add 2 5
这时如果结果为Got result : 7 则说明axis安装成功!如果失败了请检查classpath设置,
是否将所有用到的jar文件加入classpath中。到这里axis就已经安装成功了!
后面我会进一步详细讲解有关通过wsdd部署webservice的方式。
由于时间比较仓促有很多的解释不清地方,如果有什么不明白可以给我回复,我会尽快答复!