随着云计算、微服务和服务导向的架构的流行,Web服务的使用越来越广泛。而在Salesforce平台进行开发时,我们需要调用外部Web服务。而这时,sfdx-wsdl2apex-plugin 可以帮我们快速和简单地把 WSDL 文件转换配套的 Apex 类。
本文会为读者提供一个详细的指南,展示如何使用 npm 包 sfdx-wsdl2apex-plugin 来完成该转换过程。
第一步:安装 sfdx-wsdl2apex-plugin
如何安装这一npm包呢?首先,打开终端,输入以下命令即可:
--- ------- -- ---------------------
我们也可以通过以下命令来检查是否该插件已经安装成功:
---- --------- ---------
第二步:准备 WSDL 文件
在将 WSDL 文件转换为 Apex 类之前,首先需要确保有一个 WSDL 文件。如果您还没有一个这样的文件,可以从以下方式中获得:
- 直接使用服务供应商提供的WSDL文件。
- 通过使用Salesforce的“Generate from WSDL”选项来生成 WSDL 文件。
无论哪种方法,都需要获取完整的 WSDL 文件路径和名称,以便在将其转换成 Salesforce 上的 Apex 类时进行引用。
第三步:将 WSDL 文件转换为 Apex 类
现在我们可以通过 sfdx-wsdl2apex-plugin 将 WSDL 文件转换为 Apex 类。我们可以通过以下命令来实现:
---- --------- -- -- ------------- -- --------------- ----------------------
这里,需要将 ApexClassName
和 OutputDirectory
替换为实际要使用的名称。/path/to/your/wsdl.xml
同样需要被替换为 WSDL 文件的实际路径和名称。
需要注意的是,上述命令中 -p
标记表示将生成的 Apex 类文件存储在本地系统上的指定目录中。-l
标记用于将生成的 Apex 类命名为您的选择。-d
标记表示可以指定生成 Apex 类的目录。
此外,我们还可以使用以下标记和文件选项:
- -c:加密 Apex 类文件
- -n:生成的 Apex 类中包含的命名空间前缀
- -x:用户自定义 Apex 类的内容以扩展转换的文件
- -g:指定生成的代码中的 WSDL 名称
- -e:本地目录内的客户端证书
- -k:客户端密钥
- -w:客户端密码
- -r:生成反序列化代码
- -v:设置 API 版本
这些标记可以根据需要进行使用。
示例代码:
以下是一个使用 sfdx-wsdl2apex-plugin 将简单 WSDL 文件转换为 Apex 类的示例命令:
---- --------- -- -- --------- -- ----------- -- -- -- ----------- -----------------------------
这个命令将生成一个名为 CalcService
的 Apex 类,其中 wsdl2Apex
为命名空间前缀。该类将被存储在本地系统上的 ./
目录中,并标记为可供 Salesforce 平台使用。
结论
在本文中,我们向您介绍了 sfdx-wsdl2apex-plugin,这是一个 npm 包,可以帮助 Salesforce 开发人员将 WSDL 文件转换为 Apex 类。我们希望,这篇文章能够帮助您快速应用该技术,在 Salesforce 开发中实现与外部 Web 服务的交互。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/6005601981e8991b448de406