从网络服务生成Apex类

mac2022-07-01  12

使用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); }

转载于:https://www.cnblogs.com/chengcheng0148/p/generate_apex_class_from_webservice.html

最新回复(0)