Salesforce SOQL от Java

ODBC драйверът на Salesforce разширява броя на приложенията, от които можете да използвате Salesforce SOQL. В този блог описваме как да изпълнявате SOQL изрази от Java, като използвате Salesforce ODBC драйвера под нашия JDBC-ODBC Bridge, конектор Java към ODBC.

За да започнете:

Инсталирайте и лицензирайте Salesforce.com ODBC драйвера на машината, където е инсталиран JDBC-ODBC Bridge сървърът.

Преди да можете да използвате Salesforce.com ODBC драйвера, за да свържете приложението си към Salesforce.com, трябва да конфигурирате източник на ODBC данни. Източникът на ODBC данни съхранява подробностите за връзката за целевата база данни (напр. Salesforce.com) и ODBC драйвера, който е необходим за свързване с нея (например Salesforce.com ODBC драйвер).

Стартирайте ODBC администратор. За да направите това, в диалоговия прозорец Изпълнение на Windows въведете:
```
%windir%\syswow64\odbcad32.exe
```
В ODBC администратора изберете раздела System DSN и след това изберете Добавяне.
В диалоговия прозорец Създаване на нов източник на данни изберете Easysoft Salesforce SOQL ODBC драйвер и след това изберете Край.

Попълнете диалоговия прозорец Easysoft Salesforce SOQL ODBC Driver DSN Setup:

Setting	Стойност
DSN	Salesforce.com
Потребителско име	Името на вашия потребител на Salesforce.com. Например [email protected].
Парола	Паролата за вашия потребител на Salesforce.com.
Токен	Токенът за защита за вашия потребител на Salesforce.com, ако е необходимо. За да разберете дали трябва да предоставите токен за защита, изберете бутона Тест. Ако опитът за свързване е неуспешен с грешка, която съдържа `LOGIN_MUST_USE_SECURITY_TOKEN` , трябва да предоставите такъв. Salesforce.com изпраща по имейл токена за сигурност на имейл адреса, свързан с вашия потребителски акаунт в Salesforce.com. Ако не сте получили токен за сигурност, можете да го регенерирате. След това Salesforce.com ще ви изпрати по имейл новия токен за сигурност. За да регенерирате своя токен за сигурност, влезте в Salesforce.com и след това изберете Настройка от потребителското меню. Потърсете "сигурен маркер" в полето за бързо намиране. Щракнете върху Нулиране на маркера за защита на страницата Нулиране на маркера за защита. Когато получите маркера във вашия имейл клиент, копирайте го и след това го поставете в полето Token.

Използвайте бутона Тест, за да потвърдите, че можете успешно да се свържете със Salesforce.com.
Изтеглете Easysoft JDBC-ODBC Bridge. (Необходима е регистрация.)
Инсталирайте и лицензирайте Easysoft JDBC-ODBC Bridge на машината, където сте създали източника на данни.
За инструкции за инсталиране вижте документацията на Easysoft JDBC-ODBC Bridge.

Използване на Salesforce SOQL от Java

Копирайте EJOB.jar на машина, на която имате инсталиран Java Development Kit.
Ако Easysoft JDBC-ODBC Bridge вече е инсталиран на тази машина, пропуснете тази стъпка.

EJOB.jar е инсталиран на следното място на машината, където инсталирате Easysoft JDBC-ODBC Bridge:
```
<easysoft_install>\Jars
```
Местоположението по подразбиране за е <drive>:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge .

Добавете този Java код към файл с име ConnectToSalesforce.java:

import java.sql.*;
import java.util.Properties;

public class ConnectToSalesforce {

   public static void main(String[] args) {

      // Replace the <mydsn> value with your 32-bit Salesforce DSN.
      // If the JDBC-ODBC Bridge Server (JOB) is not located on the same machine as
      // ejob.jar replace localhost with the remote host name or IP address.
      // The :logonuser attribute value is a Windows user on the machine where
      // the JOB Server is running.
      String connectionUrl = "jdbc:easysoft://localhost/<mydsn>" +
         ":logonuser=mywindowsuser:logonpassword=mywindowspassword";

      Driver driver = null;
      DriverPropertyInfo props[] = null;
      Connection con = null;
      Statement stmt = null;      
      ResultSet rs = null;

      try {
       // Register the Easysoft JDBC-ODBC Bridge client.
       Class.forName("easysoft.sql.jobDriver");
       driver = DriverManager.getDriver(connectionUrl);

       con = DriverManager.getConnection(connectionUrl);

       stmt = con.createStatement();

       // You need to edit this query
       rs = stmt.executeQuery("SELECT Account.Name, (SELECT Contact.LastName FROM Account.Contacts) FROM Account");

       System.out.print("Name LastName" + "\n");
       
       while (rs.next()) {
           String n = rs.getString("Name");
           String l = rs.getString("LastName");
           System.out.print(n + " " + l + "\n");
       }

       rs.close();
       rs = null;
       stmt.close();
       stmt = null;
       con.close(); // Return to connection pool
       con = null;  // Make sure we do not close it twice	 

      }

      // Handle any errors that may have occurred.
      catch (Exception e) {
          e.printStackTrace();
      }
      finally {
          if (rs != null) try { rs.close(); } catch(Exception e) {}
          if (con != null) try { con.close(); } catch(Exception e) {}
      }
   }
}

В команден прозорец добавете EJOB.jar към пътя на класа на Java. Например:
```
set CLASSPATH="%CLASSPATH%;C:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge\Jars\EJOB.jar"
```

cd в директорията, където се намира ConnectToSalesforce.java, и компилирайте и стартирайте Java файла. Например:

"C:\Program Files\Java\jdk1.8.0_144\bin\javac.exe" ConnectToSalesforce.java
java ConnectToSalesforce
Name LastName
GenePoint Ltd Frank
United Oil & Gas, UK James
United Oil & Gas, Singapore D'Cruz
United Oil & Gas, Singapore Ripley