看一個(gè)簡(jiǎn)單的Web Service
java 代碼
- package org.jivaro.sq;
-
- import java.util.HashMap;
-
- public class StockQuoteService {
- private HashMap map = new HashMap();
-
- public double getPrice(String symbol) {
- System.out.println("Parameter Symbole : " + symbol);
- Double price = (Double) map.get(symbol);
- if(price != null) {
- return price.doubleValue();
- }
- return 42.00;
- }
-
- public void update(String symbol, double price) {
- map.put(symbol, price);
- }
- }
這是一個(gè)簡(jiǎn)單的web service，和寫(xiě)一個(gè)類(lèi)沒(méi)有任何不同。持有一個(gè)map對(duì)象，getPrice方法，通過(guò)傳入字符串，得到對(duì)應(yīng)的金額，update方法則是添加了一個(gè)字符串-金額的組合，它對(duì)應(yīng)的services.xml如下：
xml 代碼
- <service name="StockQuoteService" scope="application">
- <description>
- Stock Quote Sample Service
- description>
- <messageReceivers>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
- messageReceivers>
- <parameter name="ServiceClass">
- org.jivaro.sq.StockQuoteService
- parameter>
- service>
這個(gè)服務(wù)很好理解。注意RPCInOnlyMessageReceiver和RPCMessageRecevier，前者是“只進(jìn)”的方法，后者是“可進(jìn)可出”的方法，分別對(duì)應(yīng)了getPrice（有參數(shù)，有返回）和update（有參數(shù)，無(wú)返回）方法。
從現(xiàn)在開(kāi)始就要了解AXIOM了
1、將上面的服務(wù)類(lèi)轉(zhuǎn)成用AXIOM來(lái)實(shí)現(xiàn)，看看發(fā)生了什么
java 代碼
- package org.jivaro.sq;
-
- import javax.xml.stream.XMLStreamException;
- import org.apache.axiom.om.OMAbstractFactory;
- import org.apache.axiom.om.OMElement;
- import org.apache.axiom.om.OMFactory;
- import org.apache.axiom.om.OMNamespace;
-
- import java.util.HashMap;
-
- public class StockQuoteAxiomService {
- private HashMap map = new HashMap();
-
- public OMElement getPrice(OMElement element) throws XMLStreamException {
- element.build();
- element.detach();
-
- OMElement symboleElement = element.getFirstElement();
- String symbol = symboleElement.getText();
-
- String returnText = "42";
- Double price = (Double) map.get(symbol);
-
- if(price != null) {
- returnText = "" + price.doubleValue();
- }
-
- OMFactory fac = OMAbstractFactory.getOMFactory();
- OMNamespace omNs = fac.createOMNamespace("http://sq.jivaro.org", "tns");
- OMElement method = fac.createOMElement("getPriceResponse", omNs);
- OMElement value = fac.createOMElement("price", omNs);
- value.addChild(fac.createOMText(value, returnText));
- method.addChild(value);
-
- return method;
- }
-
- public void update(OMElement element) throws XMLStreamException {
- element.build();
- element.detach();
-
- OMElement symbolElement = element.getFirstElement();
- String symbol = symbolElement.getText();
-
- OMElement priceElement = (OMElement)symbolElement.getNextOMSibling();
- String price = priceElement.getText();
-
- map.put(symbol, new Double(price));
- }
- }
天！代碼瞬間被膨脹了，參數(shù)都被OMElement代替了，這究竟發(fā)生了什么（請(qǐng)參看2：services.xml發(fā)生了什么）,Axis2使用的是AXIOM(AXIs Object Model，一種基于StAX API的類(lèi)DOM結(jié)構(gòu))。使用了AXIOM，就規(guī)定了服務(wù)所定義的方法中的參數(shù)必須是OMElement類(lèi)型，所以我們看到參數(shù)的類(lèi)型都是OMElement了。而方法內(nèi)代碼膨脹也就不足為奇了。
2、看看services.xml又發(fā)生了什么變化
xml 代碼
- <service name="StockQuoteService" scope="application">
- <description>
- Stock Quote Service
- description>
- <operation name="getPrice">
- <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
- operation>
- <operation name="update">
- <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
- operation>
- <parameter name="ServiceClass">org.jivaro.sq.StockQuoteAxiomServiceparameter>
- service>
services.xml發(fā)生了變化，操作被明確地定義了出來(lái)，并定義了操作所對(duì)應(yīng)地MessageReceiver，如getPrice對(duì)應(yīng)的是RawXMLINOutMessageReceiver，而update方法對(duì)應(yīng)的成了RawXMLINOnlyMessageReceiver。
這就是使用AXIOM發(fā)布的方式。對(duì)于AXIOM的理解將繼續(xù)更新。接下來(lái)應(yīng)該是真正理解AXIOM，包括它的性能，以及客戶(hù)端如何調(diào)用了。