# doc

**Repository Path**: yxk123/doc

## Basic Information

- **Project Name**: doc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-08-21
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SAP WebService接口调用
	WebService 方式跨平台通用性高，可以同时发布和调用一个服务，可以调用内部服务和外部服务。缺点是调用对方服务需要生成本地客户端代码，数据传输采用soap协议，调用调试有一定的不便。

## 1.调用一个WebService


### 1.pom.xml文件中加入webservice调用相关jar包

```pom
<dependency>
       <groupId>org.apache.cxf</groupId>
          	<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
          	<version>3.2.5</version>
 </dependency>

```
### 2.在cxf官网下载相关jar包
	cxf官网 http://cxf.apache.org/download.html 
	下载地址 http://www.apache.org/dyn/closer.lua/cxf/3.2.6/apache-cxf-3.2.6.zip
1. 将下载后的文件解压到一定的目录，用于后续配置系统环境变量。
2. 配置cxf环境变量
	新建 CXF_HOME D:\Program Files (x86)\apache-cxf-3.2.6
	在PATH中添加 %CXF_HOME%\bin

### 3.在soapui官网下载soapui 
	官网地址 https://www.soapui.org/ 
	
![Image text](img/20180820151644 (1).png)

1. 使用wsdl地址建立项目
	选择File,点击new soapUI project
2. 使用soapui生成javacode
	选中项目下节点，右键Generate Code，选择Apache CXF
3. 注意配置生成参数
	点击 【Custom Args】标签，在 【Tool Args】 中填入参数： -encoding utf-8 -wsdlLocation classpath:wsdl/xxx.wsdl

	ps: -encoding 解决生成的代码中中文乱码问题，和工作空间编码格式同步。
	ps: -wsdlLocation为开发项目中wsdl的读取地址。
4. 将wsdl文件和生成的Java代码copy到项目相应的目录。	

### 4.在项目中开发使用webService

1. 在yml中设置相应的请求参数
	
``` yml
	sap:
          wsUserName: xiadongliang
          wsPwd: 654321
          wsReqUrl:
            zlmara: http://it-sapdevelop.chinacloudapp.cn:8000/sap/bc/srt/rfc/sap/zlmara_upd/200/zlmara_upd/zlmara_upd

```
	ps: 请求地址为wsdl文件中 <soap:address 标签中的 location 地址，非请求wsdl文件获取地址。
2. 配置webService连接。
	[webService 连接工具类](http://123.124.254.170:70/portal/doc/blob/master/%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8/code/WsClientFactory.java)
3. 在Service中调用
	

``` 从配置中获取请求调用地址
@Value("${sap.wsReqUrl.zlmara}")
        private String wsReqUrl;
        ps: zlmara 为yml中配置的webservice请求地址
```

``` 方法中使用
ZLMARAUPD client= (ZLMARAUPD) WsClientFactory.getInstance().getClient(wsReqUrl,ZLMARAUPD.class);
        ps: ZLMARAUPD 为对应的具体业务的接口类

```


### 5.其他

	sap服务器有可能调用异常，需检查请求的参数是否正确。
	ps: "exception": "javax.xml.ws.soap.SOAPFaultException"
	
## 2.发布一个WebService
### 1.编写业务接口类
 1.在接口类中添加类注解
 
``` 注解
@WebService(targetNamespace = "http://service.testSap.cnbmtech.com/")
# 命名空间为service 包倒叙
```
2.在接口方法中添加注解

``` 注解
	@WebMethod 
    #方法注解
    @WebParam
    #该方法请求参数注解

```
### 2.编写业务接口实现类
1.在实现类上加入注解

``` 注解
@WebService(targetNamespace = "http://service.testSap.cnbmtech.com/",endpointInterface = "com.cnbmtech.testSap.service.TestService")
    #命名空间需要与接口类保持一致

```
### 3.编写发布配置类
[WebService发布配置](http://123.124.254.170:70/portal/doc/blob/master/%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8/code/WebServiceConfig.java)


-------------------------------------------分割线-------------------------------------------


# SAP rfc方式调用
	rfc调用必须依赖中间件和类库支持，不需要强制生成客户端调用代码，但需要把握调用细节和调用方式。
	
### 1.下载sap相关工具
	下载地址 
[jco类库和中间件](http://123.124.254.170:70/portal/doc/blob/master/%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8/lib/sapjco3-NTAMD64-3.0.16.zip)

1.根据系统类型拷贝相应的文件，将sapjco3.dll拷贝到C:\Program Files\Java\jdk1.8.0_51\bin下。

2.将sapjco3.jar引入项目的lib中。

3.命令行中输入 java -jar e:/sapjco3.jar 测试安装是否成功。
### 2.编写连接调用配置类
[导入sap连接工具类](http://123.124.254.170:70/portal/doc/blob/master/%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8/code/SAPConn.java)
	
    在yml中配置：
``` yml配置
	#sap服务器IP地址
    jco.client.ashost: 10.20.1.100
      #系统编号
    jco.client.sysnr: 00
      #配置client
    jco.client.client: 200
    jco.client.user: xiadongliang
    jco.client.passwd: 654321
    jco.destination.pool_capacity: 3
    jco.destination.peak_limit: 10
    jco.client.lang: ZH

```
### 3.连接调用参考，仅做demo用。
1. 添加操作
	

``` demo
JCoFunction function;
        JCoDestination destination = SAPConn.connect();
        function = destination.getRepository().getFunction("ZFML_MARA_CREATE");
        JCoStructure SN_ITEM= function.getImportParameterList().getStructure("IS_MARA");

        ZtlMara ztlMara =zfmlMaraCreate.getIsMara();
        Class clazz=ztlMara.getClass();
        for(Field field:clazz.getDeclaredFields()){
            field.setAccessible(true);
            SN_ITEM.setValue(field.getName().toUpperCase(),field.get(ztlMara));
        }

        function.execute(destination);
        String result = function.getExportParameterList().getString("EV_ERROR");// 调用接口返回状态
        String message = function.getExportParameterList().getString("EV_MSG");// 调用接口返回信息
        log.info("调用返回状态--->" + result + ";调用返回信息--->" + message);
        SN_ITEM.clear();

```

2. 查询操作
	
``` demo
JSONObject json=new JSONObject();
        JCoDestination destination = SAPConn.connect();
        JCoFunction function;
        function = destination.getRepository().getFunction("ZFML_MARA_GET");
        JCoParameterList input = function.getImportParameterList();
        input.setValue("IV_MATNR", iv_mantr);
        function.execute(destination);
        JCoParameterList paraList = function.getExportParameterList();

        String result = paraList.getString("EV_ERROR");// 调用接口返回状态
        String message = paraList.getString("EV_MSG");// 调用接口返回信息


        JCoStructure exportStructure = function.getExportParameterList().getStructure("ES_MARA");

        for (int i = 0; i < exportStructure.getMetaData().getFieldCount(); i++) {
            log.info(exportStructure.getMetaData().getName(i) + ":\t" + exportStructure.getString(i));
        }

        for (JCoField field : exportStructure) {
            json.put(field.getName(),field.getString());
        }

```