SoapClient (hutool-http 6.0.0-M4 API)

java.lang.Object
- org.dromara.hutool.http.webservice.SoapClient

所有已实现的接口:

HeaderOperation<SoapClient>
```
public class SoapClient
extends Object
implements HeaderOperation<SoapClient>
```
SOAP客户端
此对象用于构建一个SOAP消息，并通过HTTP接口发出消息内容。 SOAP消息本质上是一个XML文本，可以通过调用getMsgStr(boolean) 方法获取消息体
使用方法：
```
 SoapClient client = SoapClient.create(url)
 .setMethod(methodName, namespaceURI)
 .setCharset(CharsetUtil.CHARSET_GBK)
 .setParam(param1, "XXX");

 String response = client.send(true);

 
```
作者:

looly

从以下版本开始:

4.5.4

构造器概要

构造器
构造器和说明
`SoapClient(String url)` 构造，默认使用soap1.1版本协议
`SoapClient(String url, SoapProtocol protocol)` 构造
`SoapClient(String url, SoapProtocol protocol, String namespaceURI)` 构造

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`SOAPHeaderElement`	`addSOAPHeader(QName name)` 增加SOAP头信息，方法返回`SOAPHeaderElement`可以设置具体属性和子节点
`SOAPHeaderElement`	`addSOAPHeader(QName name, String actorURI, String roleUri, Boolean mustUnderstand, Boolean relay)` 增加SOAP头信息，方法返回`SOAPHeaderElement`可以设置具体属性和子节点
`SOAPHeaderElement`	`addSOAPHeader(String localName)` 增加SOAP头信息，方法返回`SOAPHeaderElement`可以设置具体属性和子节点
`SOAPHeaderElement`	`addSOAPHeader(String localName, String value)` 增加SOAP头信息，方法返回`SOAPHeaderElement`可以设置具体属性和子节点
`SoapClient`	`charset(Charset charset)` 设置编码
`SoapClient`	`clearHeaders()` 清除所有头信息，包括全局头信息
`SOAPMessage`	`getMessage()` 获取SOAP消息对象 `SOAPMessage`
`SOAPBodyElement`	`getMethodEle()` 获取方法节点用于创建子节点等操作
`String`	`getMsgStr(boolean pretty)` 获取SOAP请求消息
`SoapClient`	`header(String name, String value, boolean isOverride)` 设置一个header 如果覆盖模式，则替换之前的值，否则加入到值列表中
`Map<String,List<String>>`	`headers()` 获取headers
`SoapClient`	`init(SoapProtocol protocol)` 初始化
`static SoapClient`	`of(String url)` 创建SOAP客户端，默认使用soap1.1版本协议
`static SoapClient`	`of(String url, SoapProtocol protocol)` 创建SOAP客户端
`static SoapClient`	`of(String url, SoapProtocol protocol, String namespaceURI)` 创建SOAP客户端
`SoapClient`	`reset()` 重置SOAP客户端，用于客户端复用重置后需调用serMethod方法重新指定请求方法，并调用setParam方法重新定义参数
`String`	`send()` 执行Webservice请求，即发送SOAP内容
`String`	`send(boolean pretty)` 执行Webservice请求，即发送SOAP内容
`SOAPMessage`	`sendForMessage()` 执行Webservice请求，即发送SOAP内容
`Response`	`sendForResponse()` 发送请求，获取异步响应
`SoapClient`	`setMethod(Name name, Map<String,Object> params, boolean useMethodPrefix)` 设置请求方法
`SoapClient`	`setMethod(QName name)` 设置请求方法
`SoapClient`	`setMethod(QName name, Map<String,Object> params, boolean useMethodPrefix)` 设置请求方法
`SoapClient`	`setMethod(String methodName)` 设置请求方法方法名自动识别前缀，前缀和方法名使用“:”分隔当识别到前缀后，自动添加xmlns属性，关联到默认的namespaceURI
`SoapClient`	`setMethod(String methodName, String namespaceURI)` 设置请求方法方法名自动识别前缀，前缀和方法名使用“:”分隔当识别到前缀后，自动添加xmlns属性，关联到传入的namespaceURI
`SoapClient`	`setParam(String name, Object value)` 设置方法参数，使用方法的前缀
`SoapClient`	`setParam(String name, Object value, boolean useMethodPrefix)` 设置方法参数
`SoapClient`	`setParams(Map<String,Object> params)` 批量设置参数，使用方法的前缀
`SoapClient`	`setParams(Map<String,Object> params, boolean useMethodPrefix)` 批量设置参数
`SoapClient`	`setUrl(String url)` 设置Webservice请求地址
`SoapClient`	`write(OutputStream out)` 将SOAP消息的XML内容输出到流

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.dromara.hutool.http.client.HeaderOperation
auth, bearerAuth, contentType, cookie, cookie, cookie, disableCookie, enableDefaultCookie, header, header, header, header, header, header, keepAlive, proxyAuth

- 构造器详细资料
  - SoapClient
```
public SoapClient(String url)
```
    构造，默认使用soap1.1版本协议
    
    参数:
    
    url - WS的URL地址
  - SoapClient
```
public SoapClient(String url,
                  SoapProtocol protocol)
```
    构造
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议版本，见SoapProtocol
  - SoapClient
```
public SoapClient(String url,
                  SoapProtocol protocol,
                  String namespaceURI)
```
    构造
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议版本，见SoapProtocol
    
    namespaceURI - 方法上的命名空间URI
    
    从以下版本开始:
    
    4.5.6
- 方法详细资料
  - of
```
public static SoapClient of(String url)
```
    创建SOAP客户端，默认使用soap1.1版本协议
    
    参数:
    
    url - WS的URL地址
    
    返回:
    
    this
  - of
```
public static SoapClient of(String url,
                            SoapProtocol protocol)
```
    创建SOAP客户端
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议，见SoapProtocol
    
    返回:
    
    this
  - of
```
public static SoapClient of(String url,
                            SoapProtocol protocol,
                            String namespaceURI)
```
    创建SOAP客户端
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议，见SoapProtocol
    
    namespaceURI - 方法上的命名空间URI
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.6
  - init
```
public SoapClient init(SoapProtocol protocol)
```
    初始化
    
    参数:
    
    protocol - 协议版本枚举，见SoapProtocol
    
    返回:
    
    this
  - reset
```
public SoapClient reset()
```
    重置SOAP客户端，用于客户端复用
    重置后需调用serMethod方法重新指定请求方法，并调用setParam方法重新定义参数
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.6.7
  - charset
```
public SoapClient charset(Charset charset)
```
    设置编码
    
    参数:
    
    charset - 编码
    
    返回:
    
    this
  - setUrl
```
public SoapClient setUrl(String url)
```
    设置Webservice请求地址
    
    参数:
    
    url - Webservice请求地址
    
    返回:
    
    this
  - header
```
public SoapClient header(String name,
                         String value,
                         boolean isOverride)
```
    设置一个header
    如果覆盖模式，则替换之前的值，否则加入到值列表中
    
    指定者:
    
    header 在接口中 HeaderOperation<SoapClient>
    
    参数:
    
    name - Header名
    
    value - Header值
    
    isOverride - 是否覆盖已有值
    
    返回:
    
    T 本身
  - headers
```
public Map<String,List<String>> headers()
```
    获取headers
    
    指定者:
    
    headers 在接口中 HeaderOperation<SoapClient>
    
    返回:
    
    Headers Map
  - clearHeaders
```
public SoapClient clearHeaders()
```
    清除所有头信息，包括全局头信息
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.7.13
  - addSOAPHeader
```
public SOAPHeaderElement addSOAPHeader(QName name,
                                       String actorURI,
                                       String roleUri,
                                       Boolean mustUnderstand,
                                       Boolean relay)
```
    增加SOAP头信息，方法返回SOAPHeaderElement可以设置具体属性和子节点
    
    参数:
    
    name - 头信息标签名
    
    actorURI - 中间的消息接收者
    
    roleUri - Role的URI
    
    mustUnderstand - 标题项对于要对其进行处理的接收者来说是强制的还是可选的
    
    relay - relay属性
    
    返回:
    
    SOAPHeaderElement
    
    从以下版本开始:
    
    5.4.4
  - addSOAPHeader
```
public SOAPHeaderElement addSOAPHeader(String localName)
```
    增加SOAP头信息，方法返回SOAPHeaderElement可以设置具体属性和子节点
    
    参数:
    
    localName - 头节点名称
    
    返回:
    
    SOAPHeaderElement
    
    从以下版本开始:
    
    5.4.7
  - addSOAPHeader
```
public SOAPHeaderElement addSOAPHeader(String localName,
                                       String value)
```
    增加SOAP头信息，方法返回SOAPHeaderElement可以设置具体属性和子节点
    
    参数:
    
    localName - 头节点名称
    
    value - 头节点的值
    
    返回:
    
    SOAPHeaderElement
    
    从以下版本开始:
    
    5.4.7
  - addSOAPHeader
```
public SOAPHeaderElement addSOAPHeader(QName name)
```
    增加SOAP头信息，方法返回SOAPHeaderElement可以设置具体属性和子节点
    
    参数:
    
    name - 头节点名称
    
    返回:
    
    SOAPHeaderElement
    
    从以下版本开始:
    
    5.4.4
  - setMethod
```
public SoapClient setMethod(Name name,
                            Map<String,Object> params,
                            boolean useMethodPrefix)
```
    设置请求方法
    
    参数:
    
    name - 方法名及其命名空间
    
    params - 参数
    
    useMethodPrefix - 是否使用方法的命名空间前缀
    
    返回:
    
    this
  - setMethod
```
public SoapClient setMethod(QName name,
                            Map<String,Object> params,
                            boolean useMethodPrefix)
```
    设置请求方法
    
    参数:
    
    name - 方法名及其命名空间
    
    params - 参数
    
    useMethodPrefix - 是否使用方法的命名空间前缀
    
    返回:
    
    this
  - setMethod
```
public SoapClient setMethod(String methodName)
```
    设置请求方法
    方法名自动识别前缀，前缀和方法名使用“:”分隔
    当识别到前缀后，自动添加xmlns属性，关联到默认的namespaceURI
    
    参数:
    
    methodName - 方法名
    
    返回:
    
    this
  - setMethod
```
public SoapClient setMethod(String methodName,
                            String namespaceURI)
```
    设置请求方法
    方法名自动识别前缀，前缀和方法名使用“:”分隔
    当识别到前缀后，自动添加xmlns属性，关联到传入的namespaceURI
    
    参数:
    
    methodName - 方法名（可有前缀也可无）
    
    namespaceURI - 命名空间URI
    
    返回:
    
    this
  - setMethod
```
public SoapClient setMethod(QName name)
```
    设置请求方法
    
    参数:
    
    name - 方法名及其命名空间
    
    返回:
    
    this
  - setParam
```
public SoapClient setParam(String name,
                           Object value)
```
    设置方法参数，使用方法的前缀
    
    参数:
    
    name - 参数名
    
    value - 参数值，可以是字符串或Map或SOAPElement
    
    返回:
    
    this
  - setParam
```
public SoapClient setParam(String name,
                           Object value,
                           boolean useMethodPrefix)
```
    设置方法参数
    
    参数:
    
    name - 参数名
    
    value - 参数值，可以是字符串或Map或SOAPElement
    
    useMethodPrefix - 是否使用方法的命名空间前缀
    
    返回:
    
    this
  - setParams
```
public SoapClient setParams(Map<String,Object> params)
```
    批量设置参数，使用方法的前缀
    
    参数:
    
    params - 参数列表
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.6
  - setParams
```
public SoapClient setParams(Map<String,Object> params,
                            boolean useMethodPrefix)
```
    批量设置参数
    
    参数:
    
    params - 参数列表
    
    useMethodPrefix - 是否使用方法的命名空间前缀
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.6
  - getMethodEle
```
public SOAPBodyElement getMethodEle()
```
    获取方法节点
    用于创建子节点等操作
    
    返回:
    
    SOAPBodyElement
    
    从以下版本开始:
    
    4.5.6
  - getMessage
```
public SOAPMessage getMessage()
```
    获取SOAP消息对象 SOAPMessage
    
    返回:
    
    SOAPMessage
    
    从以下版本开始:
    
    4.5.6
  - getMsgStr
```
public String getMsgStr(boolean pretty)
```
    获取SOAP请求消息
    
    参数:
    
    pretty - 是否格式化
    
    返回:
    
    消息字符串
  - write
```
public SoapClient write(OutputStream out)
```
    将SOAP消息的XML内容输出到流
    
    参数:
    
    out - 输出流
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.6
  - sendForMessage
```
public SOAPMessage sendForMessage()
```
    执行Webservice请求，即发送SOAP内容
    
    返回:
    
    返回结果
  - send
```
public String send()
```
    执行Webservice请求，即发送SOAP内容
    
    返回:
    
    返回结果
  - send
```
public String send(boolean pretty)
```
    执行Webservice请求，即发送SOAP内容
    
    参数:
    
    pretty - 是否格式化
    
    返回:
    
    返回结果
  - sendForResponse
```
public Response sendForResponse()
```
    发送请求，获取异步响应
    
    返回:
    
    响应对象

类 SoapClient

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 org.dromara.hutool.http.client.HeaderOperation

构造器详细资料

SoapClient

SoapClient

SoapClient

方法详细资料

of

of

of

init

reset

charset

setUrl

header

headers

clearHeaders

addSOAPHeader

addSOAPHeader

addSOAPHeader

addSOAPHeader

setMethod

setMethod

setMethod

setMethod

setMethod

setParam

setParam

setParams

setParams

getMethodEle

getMessage

getMsgStr

write

sendForMessage

send

send

sendForResponse