# wsc4j

**Repository Path**: brantzf/wsc4j

## Basic Information

- **Project Name**: wsc4j
- **Description**: WebService Client For Java
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-06-08
- **Last Updated**: 2024-12-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 介绍
此项目为方便`Soap WebService`调用。
原理：使用HttpClient发送xml

### 使用说明
#### 引入坐标
```
<dependency>
    <groupId>com.lbkj</groupId>
    <artifactId>wsc4j</artifactId>
    <version>1.0</version>
</dependency>
```

#### 调用示例
```
WSCResult result = WSC.invoke(url, xml_path, args...);

// e1: 获取响应数据
String data = result.getData();

// e2: 响应数据转Map。注意：不对`数组`进行处理
String data = result.toWSCMap();

// e2: 响应数据转为Bean。注意：需要引入`jackson-dataformat-xml`
Foo data = result.toBean(Foo.class);
```

#### XML文件
注：可使用`SoapUI`生成
```
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header>
        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <wsse:UsernameToken>
                <wsse:Username>%s</wsse:Username>
                <wsse:Password>%s</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
        %s
    </soapenv:Body>
</soapenv:Envelope>
```

### 拦截器
使用SPI的方式，实现`WSCInterceptor`接口

```
+-- resources
|   +-- META-INF
|       +-- services
|           -- com.lbkj.wsc.WSCInterceptor
```