Axis2快速开发指南.docx
《Axis2快速开发指南.docx》由会员分享,可在线阅读,更多相关《Axis2快速开发指南.docx(48页珍藏版)》请在冰豆网上搜索。
Axis2快速开发指南
Axis2快速上手指南
本指南的目的是让你尽可能快的创建使用Axis2的服务和客户端,我们将使用一个简单的StockQuote服务并显示给你一些创建和部署它的不同的方式,以及快速的看看Axis2自带的一些工具,然后我们将看看创建访问这些服务的客户端。
1.介绍
2.做好准备
3.Axis2服务
4.创建服务
5.部署POJOs
6.使用AXIOM构建服务
7.使用ADB生成服务
8.使用XMLBeans生成服务
9.使用JiBX生成服务
10.生成客户端
11.使用AXIOM创建一个客户端
12.使用ADB生成一个客户端
13.使用XMLBeans生成一个客户端
14.使用JiBX生成一个客户端
15.总结
16.进一步学习
介绍
做好准备
Axis2服务
创建服务
部署POJOs
使用AXIOM构建服务
使用ADB生成服务
使用XMLBeans生成服务
使用JiBX生成服务
生成客户端
使用AXIOM创建一个客户端
使用ADB生成一个客户端
使用XMLBeans生成一个客户端
使用JiBX生成一个客户端
总结
进一步学习
快速安装笔记:
文档的代码可以在解压的标准二进制发布[/url]找到,更明确的位于其中的Axis2_HOME/samples/目录-quickstart,quickstartdb,
quickstartaxiom,quickstartjibx和quickstartxmlbeans,如果你继续下去它将帮你掌握它。
它包含一个Ant构建文件(build.xml)
贯穿所有的例子我们将提到它来使得编译更容易。
介绍
让我们以服务本身开始。
我们将使它简单,所以你可以看到当我们构建并部署服务时会发生什么,一个StockQuoteService例子看起来
像这个,所以让我们使用下面的(参看CodeListing1)。
CodeListing1:
StockQuoteService类
Java代码
1.package samples.quickstart.service.pojo;
2.
3.import java.util.HashMap;
4.
5.public class StockQuoteService {
6. private HashMap map = new HashMap();
7.
8. public double getPrice(String symbol) {
9. Double price = (Double) map.get(symbol);
10. if(price !
= null){
11. return price.doubleValue();
12. }
13. return 42.00;
14. }
15.
16. public void update(String symbol, double price) {
17. map.put(symbol, new Double(price));
18. }
19.}
packagesamples.quickstart.service.pojo;
importjava.util.HashMap;
publicclassStockQuoteService{
privateHashMapmap=newHashMap();
publicdoublegetPrice(Stringsymbol){
Doubleprice=(Double)map.get(symbol);
if(price!
=null){
returnprice.doubleValue();
}
return42.00;
}
publicvoidupdate(Stringsymbol,doubleprice){
map.put(symbol,newDouble(price));
}
}
它将为一个具有两个可能的调用的简单服务,其中一个是一个in/out消息,另一个则为一个只能in的服务,最终我们将打包服务并用
四种不同的方式部署部署它。
首先,让我们看看这个简单的Java类怎样响应一个服务。
做好准备
在我们使用Axis2构建任何东西之前,我们将需要关注一些家务事。
现在你将需要准备好你使用Axis2的环境,幸运的是,它只包括一
些简单的步骤:
1,下载并安装Java(版本至少为JDK1.4)
2,下载Axis2并解压到一个目标目录
3,复制axis2.war文件到你的servlet引擎的webapps目录
4,设置AXIS2_HOME环境变量来指出目标目录,注意Axis2生成的所有脚本和构建文件依赖于这个值,所以不要遗漏了这个步骤。
大多数情况下,我们的服务也将需要一个WSDL文件,Axis2的Java2WSDL可以用来生成一个WSDL。
执行以下步骤来从一个Java类生成一
个WSDL文件:
1,创建并编译Java类
2,使用该命令生成WSDL:
%AXIS2_HOME%/bin/java2wsdl-cp.-cnsamples.quickstart.service.pojo.StockQuoteService-ofStockQuoteService.wsdl
移动你生成WSDL文件,你可以做你需要的任何更改。
例如,你可能添加自定义的过错或者改变生成的元素名。
例如,该StockQuoteSer
vice.wsdl位于%AXIS2_HOME%/samples/quickstartadb/resources/META-INF文件夹,我们将在本指南的其他部分使用它,代替生成过
程创建的一般参数。
Axis2服务
在我们构建任何东西之前,理解最终产品看起来像什么是有用的。
Axis2的服务器端可以被部署在任何Servlet引擎上,并且有如下的
CodeListing2显示的结构。
CodeListing2:
axis2.war的目录结构
Java代码
1.axis2-web
2.META-INF
3.WEB-INF
4. classes
5. conf
6. axis2.xml
7. lib
8. activation.jar
9. ...
10. xmlSchema.jar
11. modules
12. modules.list
13. addressing.mar
14. ...
15. soapmonitor.mar
16. services
17. services.list
18. aservice.aar
19. ...
20. version.aar
21. web.xml
axis2-web
META-INF
WEB-INF
classes
conf
axis2.xml
lib
activation.jar
...
xmlSchema.jar
modules
modules.list
addressing.mar
...
soapmonitor.mar
services
services.list
aservice.aar
...
version.aar
web.xml
从最上面开始,axis2-web是组成Axis2管理程序的一些JSPs,你可以通过它来执行任何需要的动作,例如添加服务,使用模块和禁止
模块。
WEB-INF包含了运行部署到服务目录的任何服务的实际上的java类和其他支持文件。
这里主要的文件是axis2.xml,它控制程序怎样与接收的消息打交道,决定Axis2是否需要使用模块目录里定义的任何模块。
这里你可以看到,服务可以被部署为*.aar文件,但是它们的内容必须以一个特殊的方式安排。
例如,服务的结构将为如下:
Java代码
1.- StockQuoteService
2. - META-INF
3. - services.xml
4. - samples
5. - quickstart
6. - service
7. - pojo
8. - StockQuoteService.class
-StockQuoteService
-META-INF
-services.xml
-samples
-quickstart
-service
-pojo
-StockQuoteService.class
这不是太复杂,服务的名字为StockQuoteService,它在services.xml中指定,并且根据包名把任何Java类放到合适的位置。
META-INF
目录包含关于Axis2需要来正确执行服务的额外信息。
services.xml文件定义了服务本身并把Java类链接到它(参看CodeListing3)。
CodeListing3:
服务定义文件
Java代码
1.
2.
3. Stock Quote Sample Service
4.
5.
6. 7. mep="http:
//www.w3.org/2004/08/wsdl/in-only"
8. class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
9. 10. mep="http:
//www.w3.org/2004/08/wsdl/in-out"
11. class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
12.
13.
14. samples.quickstart.service.pojo.StockQuoteService
15.
16.
StockQuoteSampleService
mep="http:
//www.w3.org/2004/08/wsdl/in-only"
class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
mep="http:
//www.w3.org/2004/08/wsdl/in-out"
class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
samples.quickstart.service.pojo.StockQuoteService
这里你看到服务本身被定义了,以及不同的消息交换模式相关的messageReceiver类型。
META-INF目录也是你打算包含在该程序中的自定义WSDL文件的位置。
你可以通过简单的采用该文件目录结构并复制到你的servlet引擎的webapps目录来部署一个服务,这是著名的"爆发"形式,但是你也
可以压缩你的文档到一个*.aar文件,类似于一个*.jar文件,并直接将*.aar文件放到servlet引擎的webapps目录。
既然你理解了我们在尝试完成什么,我们几乎准备好开始构建了。
首先,下载并解压合适版本的Axis2标准二进制发布。
确认你设置了AXIS2_HOME变量的值来匹配你解压该版本内容的位置。
让我们看看一些创建客户端和服务的不同方式。
创建服务
在这个部分,我们将看看根据StockQuoteService类创建服务的五种方式:
部署PlainOldJavaObjects(POJO),使用AXIOM的OMElement
构建服务,使用Axis2DatabindingFramework(ADB)生成服务,使用XMLBeans生成服务和使用JiBX生成服务。
部署POJOs
使用POJOs(PlainOldJavaObjects)来部署服务,执行下面的步骤。
注意包含在/samples/quickstart的目录结构(services.xml文件来自于该指南的第一个部分):
Java代码
1.- quickstart
2. - README.txt
3. - build.xml
4. - resources
5. - META-INF
6. - services.xml
7. - src
8. - samples
9. - quickstart
10. - service
11. - pojo
12. - StockQuoteService.java
-quickstart
-README.txt
-build.xml
-resources
-META-INF
-services.xml
-src
-samples
-quickstart
-service
-pojo
-StockQuoteService.java
注意你可以通过在quickstart目录键入antgenerate.wsdl来生成WSDL。
尽管如此,创建StockQuoteService.wsdl是可选的。
它可以是直接从Java类生成的版本,或者该文件的一个自定义版本,并且servi
ces.xml是本文档前面提到的同一文件。
现在通过在quickstart目录键入antgenerate.service来构建工程,该目录创建了以下目录结构:
Java代码
1.- quickstart/build/classes
2. - META-INF
3. - services.xml
4. - samples
5. - quickstart
6. - service
7. - pojo
8. - StockQuoteService.class
-quickstart/build/classes
-META-INF
-services.xml
-samples
-quickstart
-service
-pojo
-StockQuoteService.class
如果你想以爆发形式部署服务,重命名classes目录为StockQuoteService,并复制它到你的servlet引擎的webapps/axis2/WEB-INF/s
ervices目录。
否则,复制build/StockQuoteService.aar文件到你的servlet引擎的webapps/axis2/WEB-INF/services目录。
然后通过
视察以下服务列表来确认服务被正确部署:
http:
//localhost:
8080/axis2/services/listServices
你也可以检验以下WSDL:
http:
//localhost:
8080/axis2/services/StockQuoteService?
wsdl
以及以下结构:
http:
//localhost:
8080/axis2/services/StockQuoteService?
xsd
一旦这些urls工作,让我们快速测试一下服务。
让你的浏览器访问以下URL试试:
http:
//localhost:
8080/axis2/rest/StockQuoteService/getPrice?
symbol=IBM
你将得到如下应答:
Java代码
1.getPriceResponse xmlns:
ns="http:
//pojo.service.quickstart.samples/xsd">return>42
return>
getPriceResponse>
getPriceResponsexmlns:
ns="http:
//pojo.service.quickstart.samples/xsd">return>42
return>
getPriceResponse>
如果你像这样调用update方法:
http:
//localhost:
8080/axis2/rest/StockQuoteService/update?
symbol=IBM&price=100
然后调用第一个getPriceurl。
你可以看到price被更新了。
使用AXIOM构建服务
为了使用AXIOM"从零开始"构建一个服务,执行以下步骤。
注意包含在/samples/quickstartaxiom的目录结构:
Java代码
1.- quickstartaxiom
2. - README.txt
3. - build.xml
4. - resources
5. - META-INF
6. - services.xml
7. - StockQuoteService.wsdl
8. - src
9. - samples
10. - quickstart
11. - service
12. - axiom
13. - StockQuoteService.java
14. - clients
15. - AXIOMClient.java
-quickstartaxiom
-README.txt
-build.xml
-resources
-META-INF
-services.xml
-StockQuoteService.wsdl
-src
-samples
-quickstart
-service
-axiom
-StockQuoteService.java
-clients
-AXIOMClient.java
由于AXIOM有一点不同,你将需要一个与POJO所用不同的services.xml文件,在CodeListing4中显示了它的定义。
CodeListing4:
服务定义文件
Java代码
1.
2.
3. Stock Quote Service
4.
5.
6.
7.
8.
9.
10.
11. samples.quickstart.service.axiom.StockQuoteService
12.
StockQuoteService