码迷,mamicode.com
首页 > 其他好文 > 详细

Salesforce SOAP 接口集成服务

时间:2020-03-29 22:39:26      阅读:109      评论:0      收藏:0      [点我收藏+]

标签:sch   png   cert   原因   for   cal   response   ORC   sync   

Salesforce 使用Apex调用外部数据的接口有两种方式:SOAP 和 REST

  • SOAP:Web服务使用XML格式的文件调用服务器,通常需要WSDL文档来生成代码
  • REST:HTTP使用REST格式的文件调用服务器,推荐使用

基于WSDL的CallOut适用于SOAP方式,HTTP方式可以使用任何的HTTP Service,SOAP或者REST都可以,推荐使用REST方式. 在使用SOAP方式调用接口时,可以借助WSDL2Apex工具将XML文件生成Apex类

  1. 在Setup上搜索 Apex Classes
  2. 点击Generate From WSDL
  3. 选择文件parks.xml
  4. 点击Parse WSDL,通过WSDL2Apex工具生成ParkService类和AsyncParkService类
  5. 点击Generate Apex code,确认生产Apex文件
  6. 点击Done

         技术图片

 

Tips:WSDL解析器很可能因为各种奇怪的原因导致生成文件失败,这时就需要手动调整Apex类或者XML文件,非常的不友好. 正确生成的两个类,一个用于同步调用外部的Web服务(ParkService),一个用于异步调用外部的Web服务(AsyncParkService)

调用外部Web接口的时候,都需要将服务器接口地址添加到远程站点列表进行认证,Setup → Remote Site Settings,添加站点“https://th-apex-soap-service.herokuapp.com” 

//Generated by wsdl2apex
public class ParkService {
    public class byCountryResponse {
        public String[] return_x;
        private String[] return_x_type_info = new String[]{‘return‘,‘http://parks.services/‘,null,‘0‘,‘-1‘,‘false‘};
        private String[] apex_schema_type_info = new String[]{‘http://parks.services/‘,‘false‘,‘false‘};
        private String[] field_order_type_info = new String[]{‘return_x‘};
    }
    public class byCountry {
        public String arg0;
        private String[] arg0_type_info = new String[]{‘arg0‘,‘http://parks.services/‘,null,‘0‘,‘1‘,‘false‘};
        private String[] apex_schema_type_info = new String[]{‘http://parks.services/‘,‘false‘,‘false‘};
        private String[] field_order_type_info = new String[]{‘arg0‘};
    }
    public class ParksImplPort {
        public String endpoint_x = ‘https://th-apex-soap-service.herokuapp.com/service/parks‘;
        public Map<String,String> inputHttpHeaders_x;
        public Map<String,String> outputHttpHeaders_x;
        public String clientCertName_x;
        public String clientCert_x;
        public String clientCertPasswd_x;
        public Integer timeout_x;
        private String[] ns_map_type_info = new String[]{‘http://parks.services/‘, ‘ParkService‘};
        public String[] byCountry(String arg0) {
            ParkService.byCountry request_x = new ParkService.byCountry();
            request_x.arg0 = arg0;
            ParkService.byCountryResponse response_x;
            Map<String, ParkService.byCountryResponse> response_map_x = new Map<String, ParkService.byCountryResponse>();
            response_map_x.put(‘response_x‘, response_x);
            WebServiceCallout.invoke(
              this,
              request_x,
              response_map_x,
              new String[]{endpoint_x,
              ‘‘,
              ‘http://parks.services/‘,
              ‘byCountry‘,
              ‘http://parks.services/‘,
              ‘byCountryResponse‘,
              ‘ParkService.byCountryResponse‘}
            );
            response_x = response_map_x.get(‘response_x‘);
            return response_x.return_x;
        }
    }
}

在成功生成Apex类后,即可尝试调用接口查询数据

public class ParkLocator {
    // 测试数据可以是:Germany, India, Japan and United States
    public static String[] country(String country){
        ParkService.ParksImplPort parkImp = new ParkService.ParksImplPort();
        String[] parkList = parkImp.byCountry(country);
        System.debug(‘parkList:‘ + parkList);
        return parkList;
    }
}

和Rest接口一样,普通的测试类不支持Web服务的接口,因此,需要做一些额外工作来进行测试类的编写

新建一个模拟服务器返回数据的类:ParkServiceMock

@isTest
global class ParkServiceMock implements WebServiceMock{
    global void doInvoke(
           Object stub,
           Object request,
           Map<String, Object> response,
           String endpoint,
           String soapAction,
           String requestName,
           String responseNS,
           String responseName,
           String responseType) {
        // 开始 - 指定模拟的服务器返回数据
        ParkService.byCountryResponse response_x = new ParkService.byCountryResponse();
        response_x.return_x = new String[]{‘Yellowstone‘, ‘Mackinac National Park‘, ‘Yosemite‘};
        // 结束 -
        response.put(‘response_x‘, response_x); 
   }
}

然后创建测试类:ParkLocatorTest

@isTest
public class ParkLocatorTest {
    @isTest static void testCallout() {              
        // 产生模拟的服务器响应数据
        Test.setMock(WebServiceMock.class, new ParkServiceMock());
        // 调用接口方法
        String[] result = ParkLocator.country(‘Japan‘);
    }
}

Salesforce Apex提供了内置的WebServiceMock接口和Test.setMock方法,用以测试方法接收虚假服务器响应,从而提供必要的测试类覆盖范围

参考数据:

https://trailhead.salesforce.com/content/learn/modules/apex_integration_services/apex_integration_soap_callouts

Salesforce SOAP 接口集成服务

标签:sch   png   cert   原因   for   cal   response   ORC   sync   

原文地址:https://www.cnblogs.com/mysalesforce/p/12595157.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!