axis2快速发布服务(创建client)

四种方法创建client

一.Creating a Client with AXIOM

以quickstartaxiom为例

a) 启动服务器端

b)进入Axis2_HOME/samples/quickstartaxiom目录，输入ant run.client, 即可得到输出

done
Current price of WSO: 123.42

注：首先认清楚其目录结构为

- quickstartaxiom
   - README.txt
   - build.xml
   - resources
     - META-INF
       - services.xml
       - StockQuoteService.wsdl
   - src
     - samples
       - quickstart
         - service
           - axiom
             - StockQuoteService.java
         - clients
           - AXIOMClient.java

AXIOMClient.java类定义如下所示：

package samples.quickstart.clients;

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 org.apache.axis2.Constants;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.client.ServiceClient;

public class AXIOMClient {

    private static EndpointReference targetEPR = 
        new EndpointReference("http://localhost:8080/axis2/services/StockQuoteService");

    public static OMElement getPricePayload(String symbol) {
        OMFactory fac = OMAbstractFactory.getOMFactory();
        OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");

        OMElement method = fac.createOMElement("getPrice", omNs);
        OMElement value = fac.createOMElement("symbol", omNs);
        value.addChild(fac.createOMText(value, symbol));
        method.addChild(value);
        return method;
    }

    public static OMElement updatePayload(String symbol, double price) {
        OMFactory fac = OMAbstractFactory.getOMFactory();
        OMNamespace omNs = fac.createOMNamespace("http://axiom.service.quickstart.samples/xsd", "tns");

        OMElement method = fac.createOMElement("update", omNs);

        OMElement value1 = fac.createOMElement("symbol", omNs);
        value1.addChild(fac.createOMText(value1, symbol));
        method.addChild(value1);

        OMElement value2 = fac.createOMElement("price", omNs);
        value2.addChild(fac.createOMText(value2,
                                         Double.toString(price)));
        method.addChild(value2);
        return method;
    }

    public static void main(String[] args) {
        try {
            OMElement getPricePayload = getPricePayload("WSO");
            OMElement updatePayload = updatePayload("WSO", 123.42);
            Options options = new Options();
            options.setTo(targetEPR);
            options.setTransportInProtocol(Constants.TRANSPORT_HTTP);

            ServiceClient sender = new ServiceClient();
            sender.setOptions(options);

            sender.fireAndForget(updatePayload);
            System.err.println("price updated");
            OMElement result = sender.sendReceive(getPricePayload);

            String response = result.getFirstElement().getText();
            System.err.println("Current price of WSO: " + response);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
}

由以上类的定义可见，首先客户端得创建getPrice()和update()的载体（我理解的是：创建相应的节点结构），即将相应信息封装，创建option类和ServerClient以便和服务器通信， 设定以HTTP发送给服务端，调用Update方法更新，调用getPrice方法从服务端获得价格以显示。

二.Creating a Client Using ADB

以quickstartaxiom为例

a) 启动服务器端

b)进入Axis2_HOME/samples/quickstartadb目录，输入ant generate.client,

c)在Axis2_HOME/samples/quickstartadb目录下输入ant run.client，便可得到如下输出

42
price updated
42.35

注：ADBClient类定义如下：

package samples.quickstart.clients;

import samples.quickstart.service.adb.StockQuoteServiceStub;

public class ADBClient{
    public static void main(java.lang.String args[]){
        try{
            StockQuoteServiceStub stub =
                new StockQuoteServiceStub
                ("http://localhost:8080/axis2/services/StockQuoteService");

            getPrice(stub);
            update(stub);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* fire and forget */
    public static void update(StockQuoteServiceStub stub){
        try{
            StockQuoteServiceStub.Update req = new StockQuoteServiceStub.Update();
            req.setSymbol ("ABC");
            req.setPrice (42.35);

            stub.update(req);
            System.err.println("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* two way call/receive */
    public static void getPrice(StockQuoteServiceStub stub){
        try{
            StockQuoteServiceStub.GetPrice req = new StockQuoteServiceStub.GetPrice();

            req.setSymbol("ABC");

            StockQuoteServiceStub.GetPriceResponse res =
                stub.getPrice(req);

            System.err.println(res.get_return());
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

}

客户端使用Axis数据绑定方式创建客户端，要求进行getPrice()和Update()方法，getPrice()方法创建其载体并设置symbol为ABC,发送getPrice()请求，并显示结果。

This class creates a client stub using the Axis Data Bindings you created. Then it calls the getPrice and update operations on the Web service. The getPrice method operation creates the GetPricepayload and sets the symbol to ABC. It then sends the request anddisplays the current price. The update method creates an Updatepayload, setting the symbol to ABC and the price to 42.35.

三.Creating a Client Using XMLBeans

以quickstartaxmlbeans为例

a) 启动服务器端

b)进入Axis2_HOME/samples/quickstartxmlbeans目录，输入ant generate.client, 生成客户端代码

c)在Axis2_HOME/samples/quickstartxmlbean目录下输入ant run.client，便可得到如下输出

42
price updated
42.32

注：XMLBEANSClient.java如下所示：

package samples.quickstart.clients;

import samples.quickstart.service.xmlbeans.StockQuoteServiceStub;
import samples.quickstart.service.xmlbeans.xsd.GetPriceDocument;
import samples.quickstart.service.xmlbeans.xsd.GetPriceResponseDocument;
import samples.quickstart.service.xmlbeans.xsd.UpdateDocument;

public class XMLBEANSClient{

    public static void main(java.lang.String args[]){
        try{
            StockQuoteServiceStub stub =
                new StockQuoteServiceStub
                ("http://localhost:8080/axis2/services/StockQuoteService");

            getPrice(stub);
            update(stub);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* fire and forget */
    public static void update(StockQuoteServiceStub stub){
        try{
            UpdateDocument reqDoc = UpdateDocument.Factory.newInstance();
            UpdateDocument.Update req = reqDoc.addNewUpdate();
            req.setSymbol ("BCD");
            req.setPrice (42.32);

            stub.update(reqDoc);
            System.err.println("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* two way call/receive */
    public static void getPrice(StockQuoteServiceStub stub){
        try{
            GetPriceDocument reqDoc = GetPriceDocument.Factory.newInstance();
            GetPriceDocument.GetPrice req = reqDoc.addNewGetPrice();
            req.setSymbol("BCD");

            GetPriceResponseDocument res =
                stub.getPrice(reqDoc);

            System.err.println(res.getGetPriceResponse().getReturn());
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }
}

This class creates a client stub using the XML Beans databindings you created. Then it calls the getPrice and the updateoperations on the Web service. The getPrice method operation creates the GetPriceDocument, its inner GetPrice classes and sets the symbol to ABC. It then sends the request and retrieves aGetPriceResponseDocument and displays the current price. The updatemethod creates an UpdateDocument, updates and sets the symbol toABC and price to 42.32, displaying 'done' when complete.

该类使用XML Beans数据绑定的方式创建一个客户桩，向服务端请求getPrice()和update()服务，gerPrice()方法创建一个GetPriceDocument及其内部的getPrice类，设置其symbol为BCD; update()方法创建UpdateDocument ，update并设置symbol为ABC,价格为42.32, 并将成功结果done予以显示。

四.Creating a Client Using JiBX

以quickstartaxmljibx为例

a) 启动服务器端

b)进入Axis2_HOME/samples/quickstartjibx目录，输入ant generate.client, 生成客户端代码

c)在Axis2_HOME/samples/quickstartjibx目录下输入ant run.client，便可得到如下输出

42
price updated
42.32

注： The JiBXClient类如下所示：

package samples.quickstart.clients;

import samples.quickstart.service.jibx.StockQuoteServiceStub;

public class JiBXClient{
    public static void main(java.lang.String args[]){
        try{
            StockQuoteServiceStub stub =
                new StockQuoteServiceStub
                ("http://localhost:8080/axis2/services/StockQuoteService");

            getPrice(stub);
            update(stub);
            getPrice(stub);

        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* fire and forget */
    public static void update(StockQuoteServiceStub stub){
        try{
            stub.update("CDE", new Double(42.35));
            System.err.println("price updated");
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

    /* two way call/receive */
    public static void getPrice(StockQuoteServiceStub stub){
        try{
            System.err.println(stub.getPrice("CDE"));
        } catch(Exception e){
            e.printStackTrace();
            System.err.println("\n\n\n");
        }
    }

}

This class uses the created JiBX client stub to access the getPrice and the update operations on the Web service. The getPricemethod sends a request for the stock "ABC" and displays the currentprice. The update method setsnex the price for stock "ABC" to42.35.

该类使用创建成的JiBX客户桩以获得服务端的getPrice()和update()操作，getPrice方法设置ABC并向服务端发送请求显示当前价格；updat方法更新价格。