从网络服务生成Apex类

使用WSDL2Apex从网络服务生成Apex类

如果某个网络服务被定义在WSDL文件中，而Salesforce必须使用SOAP和网络服务进行通信，则这种情况在某些时候会为开发者带来很多麻烦。为了简化SOAP请求，可以使用Salesforce中提供的功能将此网络服务转化为Apex类。开发者可以通过此Apex类调用网络服务，而此Apex类可以自动生成和编译XML信息，省去了手动设置的麻烦。

假设已经有了一个WSDL文件，包含了网络服务的XML描述。在设置界面中，搜索“Apex 类”，点击“Apex 类”链接，即可进入Salesforce中所有Apex类的一览表。点击“从WSDL中生成”，在接下来的窗口中上传文件，并点击“分析WSDL”按钮，Salesforce会自动将WSDL中包含的网络服务生成Apex类。

从WSDL中会生成两个类，分别是用于同步和异步请求的，异步请求的类名比同步请求的类名前面多了“Async”。

使用从网络服务生成的Apex类

从WSDL生成的Apex类可以像正常的Apex类一样被开发者使用。当调用其中包含的函数时，便相当于发送了一个网络服务请求。

测试从网络服务生成的Apex类

在测试从网络服务中生成的Apex类中的函数时，因为单元测试函数无法调用真正的网络服务，所以开发者必须自己生成模拟的网络服务请求和结果。

Salesforce中提供了WebServiceMock接口和Test.setMock()函数来实现这一点。

示例：测试网络服务类

假设已经从WSDL文件中生成了一个Apex类，名叫“ExampleServiceClass”，其中包含了某个函数“ExampleService()”。

开发者新建了一个Apex类“ExampleClass”，其中包含了某个函数“DoSomething()”来调用“ExampleServiceClass”类中的“ExampleService()”函数并处理结果。现在要对“DoSomething()”函数编写单元测试代码。

1. 首先建立一个全局的类，实现WebServiceMock接口，用于模拟网络服务的请求。代码如下：

@isTest
global class ServiceCalloutMock implements WebServiceMock {
    // 实现接口中的doInvoke()函数
    global void doInvoke(
                        Object stub,
                        Object request,
                        Map<String, Object> response,
                        String endpoint,
                        String soapAction,
                        String requestName,
                        String responseNS,
                        String responseName,
                        String responseType) {
    
    // 接下来，调用网络请求的Apex类中的函数，得到结果，并将结果赋值到参数中的response中。
    // response将作为网络请求的回应被用到单元测试中。
    // ...
    
   }
}

2. 建立单元测试函数。代码如下：

@isTest
static void DoSomethingTest() {
    // 调用刚才建立的模拟网络服务请求的类
    Test.setMOck(WebServiceMock.class, new ServiceCalloutMock());

    // 测试函数，得到结果。模拟的网络服务请求结果会在这里被使用，取代了调用真正的网络服务
    String result = ExampleClass.DoSomething();

    // System.assertEquals(..., result);
}