soap

前端之家收集整理的这篇文章主要介绍了soap前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

soap

soap是一种基于XML的简易协议,允许程序通过HTTP来交换信息,用在分散或分布的环境中交换信息。

一条soap消息就是一个普通的xml文档,包含下列元素:

l必须的Envelope元素,标识该文档为一条soap消息;

l可选的Header元素,用于传输头信息;

l必需的Body元素,包含了所有的调用或响应信息;

l可选的Fault元素,提供有关处理错误的信息;

以上的元素均被声明为针对soap封装的默认命名空间中:http://schemas.xmlsoap.org/soap/envelope/,一条soap消息如下:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:q0="www.ssl.com"xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soape:Body>

<q0:add>

<a>1</a>

<b>2</b>

</q0:add>

</soape:Body>

</soape:Envelope>

1、 Header

可选的Header元素包含有关SOAP消息的应用程序相关信息,如认证、安全等。如果提供Header元素,则必须是Envelop元素的第一个子元素。

注意:所有Header元素的直接子元素必须有合格的命名空间,如下

<?xmlversion="1.0"?>

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:q0="www.ssl.com"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soap:Header>

<m:Trans xmlns:m="http://www.ssl.com">234</m:Trans> </soap:Header>

<soap:body>

</soap:body>

</soap:Envelope>

2、 Body

Body元素是必须的,包含了发送或接受的信息。Body元素的直接子元素也必须有合格的命名空间,如下

<?xmlversion="1.0"?>

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:q0="www.ssl.com"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soap:Body>

<m:GetPricexmlns:m="http://www.ssl.com/prices"> <m:Item>Apples</m:Item>

</m:GetPrice>

</soap:body>

</soap:Envelope>

该消息的响应消息如下:

<?xmlversion="1.0"?>

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:q0="www.ssl.com"xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soap:Body>

<m:GetPriceResponsexmlns:m="http://www.ssl.com/prices"> <m:price>3.6</m:price>

</m:GetPriceResponse>

</soap:body>

</soap:Envelope>

对于body元素的非直接子元素,在消息发送和消息响应时最好统一是否增加前缀,如不一致数据接受可能会出现错误

3、 Fault

Fault元素用于传输SOAP的错误信息。如果Fault元素存在,则必须是Body元素的子元素,在一条SOAP消息中,Fault元素只能出现一次。Fault元素有如下子元素:

lfaultcode,错误代号;

l faultString错误描述信息,最常用;

lfaultactor

ldetail

包含错误信息的SOAP消息如下

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

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body>

<S:Faultxmlns:ns4="http://www.w3.org/2003/05/soap-envelope">

<faultcode>S:Server</faultcode>

<faultstring>没有认真信息,认证失败</faultstring>

<detail>

<ns2:AuthExceptionxmlns:ns2="http://www.ssl.com/student/">

<message>没有认真信息,认证失败</message>

</ns2:AuthException>

</detail>

</S:Fault>

</S:Body>

</S:Envelope>

4、 Binding

定义了一种使用底层传输协议来完成在节点间交换SOAP信封的约定。

5、 API

SOAP消息基本上是从发送端到接收端的单向传输,常常结合起来执行类似于请求/应答的模式。一条SOAP消息就是一个普通的XML文档,其结构如下图所示,


在JAX-WS中,一条消息对应一个SOAPMessage实例。SOAPMessage封装了对soap消息的操作。WebService的本质就是SOAP消息的发送和SOAP消息的响应,所以可以通过SOAPMessage实现对webService的调用(其他相关API请参考jaxws-api),如下:

String ns="ns;

//1. 创建服务

URL ur=new URL("wsdl-address");

QName qname=new QName(ns,"WebServiceName");

Service service=Service.create(ur,qname);

//2、创建Dispatch

Dispatch<SOAPMessage> dispatch=service.createDispatch(new QName(ns,"WebServicePortName"),SOAPMessage.class,Service.Mode.MESSAGE);

//3、创建SOAPMessage

SOAPMessage message=MessageFactory.newInstance().createMessage();

SOAPEnvelope envelope=message.getSOAPPart().getEnvelope();

SOAPBody body=envelope.getBody();

//4、创建qname来指定消息中传递数据

//指定那个方法

QName ename=new QName(ns,"add","nn");

SOAPBodyElement element=body.addBodyElement(ename);

element.addChildElement("a").setValue("1");

element.addChildElement("b").setValue("2");

//打印消息

message.writeTo(System.out);

System.out.println("\ninvoking");

//5、通过dispatch传递消息

SOAPMessage response=dispatch.invoke(message);

response.writeTo(System.out);

原文链接:https://www.f2er.com/xml/296312.html

猜你在找的XML相关文章