基於Tomcat5.0和Axis2開發Web Service代碼詳解

時間 2021-01-22

標籤 java apache 服務器框架 ide 網站 url spa orm server 欄目 Tomcat 简体版

原文原文鏈接

本文將詳細介紹HelloWorld中使用的server和client端代碼。閱讀以前，你應該首先了解SOAP1.1協議。

author: ZJ 07-3-13

Blog: [url]http://zhangjunhd.blog.51cto.com/[/url]

1．HelloWorld作了些什麼？

HelloWorld功能很是簡單，在客戶端輸入你的姓名，本例中爲ZJ。參數傳遞到服務器端後，通過處理將返回name+"HelloWorld!"，本例中爲ZJ HelloWorld!

2．服務器端文件HelloWorld.java

HelloWorld.java

package sample;

import org.apache.axiom.om.OMAbstractFactory;

import org.apache.axiom.om.OMElement;

import org.apache.axiom.om.OMFactory;

import org.apache.axiom.om.OMNamespace;

public class HelloWorld {

//讀取client端getSayHelloOMElement()方法傳遞的參數in。

public OMElement sayHello(OMElement in){

//將in轉換爲String。

String name=in.getText();

String info=name+"HelloWorld!";

//建立response SOAP包。

OMFactory fac=OMAbstractFactory.getOMFactory();

// OMNamespace指定此SOAP文檔名稱空間。

OMNamespace omNs=fac.createOMNamespace("http://helloworld.com/","hw");

//建立元素sayHello，並指定其在omNs指代的名稱空間中。

OMElement resp=fac.createOMElement("sayHelloResponse",omNs);

//指定元素的文本內容。

resp.setText(info);

return resp;

}

3．services.xml部署文件

services.xml

<?xml version="1.0" encoding="UTF-8"?>

//下面定義服務名

This is a sample Web Service.

</description>

// ServiceClass指定Java Class的位置，即實現服務的類。

<parameter name="ServiceClass" locked="false">sample.HelloWorld</parameter>

// operation 與Java Class中方法名對應。

// messageReceiver看下文註解。

</operation>

</service>

註解：消息交換模式。

目前Axis2支持三種模式：In-Only、Robust-In和In-Out。In-Only消息交換模式只有SOAP請求，而不須要應答；Robust-In消息交換模式發送SOAP請求，只有在出錯的狀況下才返回應答；In-Out消息交換模式老是存在SOAP請求和應答。本例使用In-Out模式。

4．客戶端文件TestClient.java

TestClient.java

package example.client;

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.addressing.EndpointReference;

import org.apache.axis2.client.Options;

import org.apache.axis2.client.ServiceClient;

public class TestClient {

// targetEPR指定打包的Service（.aar文件）在容器中的物理位置。

private static EndpointReference targetEPR=new EndpointReference

("http://localhost:8080/axis2/services/HelloWorld");

public static OMElement getSayHelloOMElement(){

//建立request SOAP包。

OMFactory fac=OMAbstractFactory.getOMFactory();

// OMNamespace指定此SOAP文檔名稱空間。

OMNamespace omNs=fac.createOMNamespace("http://helloworld.com/","hw");

//建立元素sayHello，並指定其在omNs指代的名稱空間中。

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

//指定元素的文本內容。

method.setText("ZJ");

return method;

}

public static void main(String[] args){

try{

Options options=new Options();

options.setTo(targetEPR);

ServiceClient sender=new ServiceClient();

sender.setOptions(options);

OMElement sayHello=TestClient.getSayHelloOMElement();

//發出request SOAP，

//同時將獲得的遠端由sayHello方法返回的信息保存到result。

//經過services.xml能準確找到sayHello方法所在的文件。

OMElement result=sender.sendReceive(sayHello);

}

catch(Exception axisFault){

axisFault.printStackTrace();

}

5 ．Axis2簡介

Apache Axis2 是Axis的後續版本，是新一代的SOAP引擎。Axis2的主要特色有：

1）採用名爲 AXIOM（AXIs Object Model）的新核心 XML 處理模型，利用新的XML解析器提供的靈活性按需構造對象模型。

2）支持不一樣的消息交換模式。目前Axis2支持三種模式：In-Only、Robust-In和In-Out。In-Only消息交換模式只有SOAP請求，而不須要應答；Robust-In消息交換模式發送SOAP請求，只有在出錯的狀況下才返回應答；In-Out消息交換模式老是存在SOAP請求和應答。

3）提供阻塞和非阻塞客戶端 API。

4）支持內置的 Web服務尋址 (WS-Addressing) 。

5）靈活的數據綁定，能夠選擇直接使用 AXIOM，使用與原來的 Axis 類似的簡單數據綁定方法，或使用 XMLBeans、JiBX 或 JAXB 2.0 等專用數據綁定框架。

6）新的部署模型，支持熱部署。

7）支持HTTP，SMTP，JMS，TCP傳輸協議。

8）支持REST (Representational State Transfer)。

6．Axis2 支持的規範包括：

-SOAP 1.1 and 1.2

-Message Transmission Optimization Mechanism (MTOM), XML Optimized Packaging (XOP) and SOAP with Attachments

-WSDL 1.1, including both SOAP and HTTP bindings

-WS-Addressing (submission and final)

-WS-Policy

-SAAJ 1.1

有關Axis2更加詳細的介紹，能夠訪問Axis2網站[url]http://ws.apache.org/axis2/[/url]。

相關介紹

基於Tomcat5.0和Axis2開發Web Service應用實例

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。