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

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