Salesforce WSDL转化Jar

前言

Salesforce有多种集成方式供不同平台集成，其中Soap/Metadata是一种比较常见的集成方式。在使用Soap/Metadata之前我们需要先拿到相应的wsdl文件，以匹配到不同的平台。笔者在这里就JAVA(C#使用Visual Studio的方式可以直接引入WSDL文件，无需转换)平台的方式做一个解释说明。

前置步骤

• 下载WSC（Force.com Web Service Connector）：https://github.com/forcedotcom/wsc（若在Maven中需要引用，请访问：http://mvnrepository.com/artifact/com.force.api/force-wsc）
• 下载API：Quick Box中输入“API”，可以看到API WSDL列表，选择需要的WSDL进行下载（需要有Modify All的权限）。在这里我们以Enterprise WSDL和Apex WSDL为例。

构建WSC-Uber

• 安装maven(当前3.5最佳)并配置环境：已完成略过；
• 打开cmd进入到WSC的目录：执行mvn clean package。这个过程会下载WSC引用的JAR，耐心等待过程即可。
• 执行完毕后，在target目录下会生成四个Jar：force-wsc-{version}-javadoc.jar, force-wsc-{version}-sources.jar, force-wsc-{version}-uber.jar, force-wsc-{version}.jar。其中uber.jar就是我们需要的jar。

转化Jar

格式：java -classpath force-wsc-{version}-uber.jar com.sforce.ws.tools.wsdlc enterprise.xml ../jar/enterprise.jar

解释：enterprise.xml代表wsdl文件，可在之前加入路径；../jar/enterprise.jar代表生成jar名和路径。

心得

• 在构建WSC Jar时，要确认安装JDK和Maven，并配置正确的JAVA_HOME和Maven Path；
• 建议直接通过Command实现该过程，可定义临时的环境变量并且可以一站式完成；
• github上的wsc zip可通过Command “git clone https://github.com/forcedotcom/wsc.git” 下载到当前目录（请确认已安装git）。

Mac简易安装

1. 下载并安装JDK并配置JAVA_HOME（已完成略过）；
   设置临时JAVA_HOME：export JAVA_HOME=$(/usr/libexec/java_home)，检测：$JAVA_HOME。
2. 下载并安装Maven（已完成略过）；
   设置临时Path：export PATH={maven}/bin:$PATH，检测：mvn -v。
3. 下载并安装git（已完成略过）；
4. Command执行git clone https://github.com/forcedotcom/wsc.git；
5. Command执行mvn clean package；
6. 找到对应的uber.jar，Command执行java -classpath force-wsc-{version}-uber.jar com.sforce.ws.tools.wsdlc enterprise.xml ../jar/enterprise.jar。

整个过程注意目录的匹配。