SoapClient (java-sdk-common 1.0.9.1 API)

java.lang.Object
- com.dahuatech.hutool.http.webservice.SoapClient

```
public class SoapClient
extends Object
```
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);

 
```
从以下版本开始:

4.5.4

作者:

looly

构造器概要

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

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static SoapClient`	`create(String url)` 创建SOAP客户端，默认使用soap1.1版本协议
`static SoapClient`	`create(String url, SoapProtocol protocol)` 创建SOAP客户端
`static SoapClient`	`create(String url, SoapProtocol protocol, String namespaceURI)` 创建SOAP客户端
`SOAPMessage`	`getMessage()` 获取SOAP消息对象 `SOAPMessage`
`SOAPBodyElement`	`getMethodEle()` 获取方法节点用于创建子节点等操作
`String`	`getMsgStr(boolean pretty)` 获取SOAP请求消息
`SoapClient`	`init(SoapProtocol protocol)` 初始化
`SoapClient`	`reset()` 重置SOAP客户端，用于客户端复用重置后需调用serMethod方法重新指定请求方法，并调用setParam方法重新定义参数
`String`	`send()` 执行Webservice请求，即发送SOAP内容
`String`	`send(boolean pretty)` 执行Webservice请求，即发送SOAP内容
`SOAPMessage`	`sendForMessage()` 执行Webservice请求，即发送SOAP内容
`SoapClient`	`setCharset(Charset charset)` 设置编码
`SoapClient`	`setConnectionTimeout(int milliseconds)` 设置连接超时，单位：毫秒
`SoapClient`	`setHeader(QName name)` 设置头信息
`SoapClient`	`setHeader(QName name, String actorURI, String roleUri, Boolean mustUnderstand, Boolean relay)` 设置头信息
`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`	`setReadTimeout(int milliseconds)` 设置连接超时，单位：毫秒
`SoapClient`	`setUrl(String url)` 设置Webservice请求地址
`SoapClient`	`timeout(int milliseconds)` 设置超时，单位：毫秒超时包括： 1.
`SoapClient`	`write(OutputStream out)` 将SOAP消息的XML内容输出到流

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

- 构造器详细资料
  - 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
- 方法详细资料
  - create
```
public static SoapClient create(String url)
```
    创建SOAP客户端，默认使用soap1.1版本协议
    
    参数:
    
    url - WS的URL地址
    
    返回:
    
    SoapClient
  - create
```
public static SoapClient create(String url,
                                SoapProtocol protocol)
```
    创建SOAP客户端
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议，见SoapProtocol
    
    返回:
    
    SoapClient
  - create
```
public static SoapClient create(String url,
                                SoapProtocol protocol,
                                String namespaceURI)
```
    创建SOAP客户端
    
    参数:
    
    url - WS的URL地址
    
    protocol - 协议，见SoapProtocol
    
    namespaceURI - 方法上的命名空间URI
    
    返回:
    
    SoapClient
    
    从以下版本开始:
    
    4.5.6
  - init
```
public SoapClient init(SoapProtocol protocol)
```
    初始化
    
    参数:
    
    protocol - 协议版本枚举，见SoapProtocol
    
    返回:
    
    this
  - reset
```
public SoapClient reset()
```
    重置SOAP客户端，用于客户端复用
    重置后需调用serMethod方法重新指定请求方法，并调用setParam方法重新定义参数
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.6.7
  - setCharset
```
public SoapClient setCharset(Charset charset)
```
    设置编码
    
    参数:
    
    charset - 编码
    
    返回:
    
    this
  - setUrl
```
public SoapClient setUrl(String url)
```
    设置Webservice请求地址
    
    参数:
    
    url - Webservice请求地址
    
    返回:
    
    this
  - setHeader
```
public SoapClient setHeader(QName name)
```
    设置头信息
    
    参数:
    
    name - 头信息标签名
    
    返回:
    
    this
  - setHeader
```
public SoapClient setHeader(QName name,
                            String actorURI,
                            String roleUri,
                            Boolean mustUnderstand,
                            Boolean relay)
```
    设置头信息
    
    参数:
    
    name - 头信息标签名
    
    actorURI - 中间的消息接收者
    
    roleUri - Role的URI
    
    mustUnderstand - 标题项对于要对其进行处理的接收者来说是强制的还是可选的
    
    relay - relay属性
    
    返回:
    
    this
  - 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
  - timeout
```
public SoapClient timeout(int milliseconds)
```
    设置超时，单位：毫秒
    超时包括：
```
 1. 连接超时
 2. 读取响应超时
 
```
    参数:
    
    milliseconds - 超时毫秒数
    
    返回:
    
    this
    
    另请参阅:
    
    setConnectionTimeout(int), setReadTimeout(int)
  - setConnectionTimeout
```
public SoapClient setConnectionTimeout(int milliseconds)
```
    设置连接超时，单位：毫秒
    
    参数:
    
    milliseconds - 超时毫秒数
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.6
  - setReadTimeout
```
public SoapClient setReadTimeout(int milliseconds)
```
    设置连接超时，单位：毫秒
    
    参数:
    
    milliseconds - 超时毫秒数
    
    返回:
    
    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 - 是否格式化
    
    返回:
    
    返回结果

类 SoapClient

构造器概要

方法概要

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

构造器详细资料

SoapClient

SoapClient

SoapClient

方法详细资料

create

create

create

init

reset

setCharset

setUrl

setHeader

setHeader

setMethod

setMethod

setMethod

setMethod

setMethod

setParam

setParam

setParams

setParams

getMethodEle

getMessage

getMsgStr

write

timeout

setConnectionTimeout

setReadTimeout

sendForMessage

send

send