salesforce 零基础学习（五十一）使用 Salesforce.com SOAP API 实现用户登录以及简单的增删改查(JAVA访问salesforce)

此篇请参看：https://resources.docs.salesforce.com/202/latest/en-us/sfdc/pdf/salesforce_developer_environment_tipsheet.pdf

salesforce提供了多种API和外部交互，常用的有REST API方式以及SOAP API方式。其中，REST方式好处是方便，如果业务逻辑不复杂情况下，rest方式是首选，但是如果操作特别复杂，比如在api中需要调用审批流，需要进行复杂的业务逻辑，则可以考虑使用SOAP API。

此篇内容为使用java通过SOAP方式实现用户登录以及简单的增删改查操作，因为salesforce对于TLS升级到1.1,方便起见，目前使用的JDK版本为1.8，使用SOAP方式操作的步骤如下（假定你的jdk安装完成以及环境变量配置完成）：

1.下载Force.com Web Service Connector

下载链接为http://mvnrepository.com/artifact/com.force.api/force-wsc  我下载的版本为38.0.4

2.下载开发的WSDL文件

Setup->Build->API,这里有很多可以选择的WSDL,企业级WSDL，合作伙伴,元信息等。此处选择企业级WSDL,选择以后详情页右键另存为MyProject.wsdl，名字随便起

不同WSDL区别：https://developer.salesforce.com/docs/atlas.en-us.202.0.api.meta/api/sforce_api_quickstart_intro.htm#choose_wsdl

3.下载Rhino JavaScript framework，下载完rar文件以后选择其中的js.jar

https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino/Download_Rhino

4.下载StringTemplate engine framework ，我选择的是目前最新的4.0.8.jar

http://www.stringtemplate.org/download.html

5.下载ANTRL runtime,我下载的是最新的版本的complete模式，其他模式有可能缺少相关的类

http://www.antlr.org/download.html

6.生成myproject.jar，将上述jar包以及myproject.wsdl放置在C:\Users\test\Desktop\myproject目录下，打开控制台

　　1) cd C:\Users\test\Desktop\myproject

　　2)java -classpath force-wsc-38.0.4.jar;ST4-4.0.8.jar;antlr-4.5.3-complete.jar;js.jar com.sforce.ws.tools.wsdlc myproject.wsdl myproject.jar

7.使用force-wsc-38.04.jar以及生成的myproject.jar实现java通过soap api方式访问sfdc,使用soap api访问有很多限制，比如一次insert或者upsert不能超过200等,这里举例登录以及批量添加功能。

限制详情：https://developer.salesforce.com/docs/atlas.en-us.204.0.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_apicalls.htm

SOAP API : https://resources.docs.salesforce.com/204/latest/en-us/sfdc/pdf/apex_api.pdf

 package controller;

 import java.util.ArrayList;
 import java.util.List;

 import com.sforce.soap.enterprise.Connector;
 import com.sforce.soap.enterprise.EnterpriseConnection;
 import com.sforce.soap.enterprise.sobject.Company_Info__c;
 import com.sforce.ws.ConnectionException;
 import com.sforce.ws.ConnectorConfig;

 public class Test {
     static final String USERNAME = "zhangyueqi_dlmu@163.com";
     static final String PASSWORD = "zyq123EfaM6E59ROTm6mgvEjXMD4IUS";
     static EnterpriseConnection connection;
     static List<Company_Info__c> companyInfoList;
     public static void main(String[] args) {

         ConnectorConfig config = new ConnectorConfig();
         config.setUsername(USERNAME);
         config.setPassword(PASSWORD);

         try {

             connection = Connector.newConnection(config);
             System.out.println("Auth EndPoint: "+config.getAuthEndpoint());
             System.out.println("Service EndPoint: "+config.getServiceEndpoint());
             System.out.println("Username: "+config.getUsername());
             System.out.println("SessionId: "+config.getSessionId());
             companyInfoList = new ArrayList<Company_Info__c>();
             createData();
             List<Company_Info__c> tempCompanyInfoList = new ArrayList<Company_Info__c>();
             for(int i=0;i<companyInfoList.size();i++) {
                 tempCompanyInfoList.add(companyInfoList.get(i));
                 //create超过200将会报错。sfdc的limit
                 if(i % 199 == 198 || i == companyInfoList.size()-1) {
                     connection.create(tempCompanyInfoList.toArray(new Company_Info__c[tempCompanyInfoList.size()]));
                     tempCompanyInfoList.clear();
                 }
             }

         } catch (ConnectionException e1) {
             e1.printStackTrace();
         }
     }

     private static void createData() {
         for(int i=0;i<220;i++) {
             Company_Info__c companyInfo = new Company_Info__c();
             companyInfo.setCompany_Name__c("company name" + i);
             companyInfo.setCompany_Code_Unique__c("company code unique" + i);
             companyInfo.setCompany_Phone__c("13800000000");
             companyInfo.setCompany_Place__c("company place " + i);
             companyInfo.setCompany_Type__c("company type" + i);
             companyInfoList.add(companyInfo);
         }
     }
 }

Test

总结：此篇主要内容为如何生成SOAP以及SOAP API的简单使用，详情可以参看SOAP API获取更多使用功能。篇中如果有错误地方，欢迎指正，有问题欢迎留言。