使用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()”函数编写单元测试代码。
- 首先建立一个全局的类,实现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将作为网络请求的回应被用到单元测试中。
// ...
}
}
- 建立单元测试函数。代码如下:
@isTest
static void DoSomethingTest() {
// 调用刚才建立的模拟网络服务请求的类
Test.setMOck(WebServiceMock.class, new ServiceCalloutMock());
// 测试函数,得到结果。模拟的网络服务请求结果会在这里被使用,取代了调用真正的网络服务
String result = ExampleClass.DoSomething();
// System.assertEquals(..., result);
}