Ready to get started?

Download a free trial of the Salesforce Driver to get started:

 Download Now

Learn more:

Salesforce Icon Salesforce JDBC Driver

Rapidly create and deploy powerful Java applications that integrate with Salesforce account data including Leads, Contacts, Opportunities, Accounts, and more!

Connect to Salesforce Data from a Connection Pool in Jetty

The Salesforce JDBC Driver supports connection pooling: This article shows how to connect faster to Salesforce data from Web apps in Jetty.

The CData JDBC driver for Salesforce is easy to integrate with Java Web applications. This article shows how to efficiently connect to Salesforce data in Jetty by configuring the driver for connection pooling. You will configure a JNDI resource for Salesforce in Jetty.

Configure the JDBC Driver for Salesforce as a JNDI Data Source

Follow the steps below to connect to Salesforce from Jetty.

  1. Enable the JNDI module for your Jetty base. The following command enables JNDI from the command-line:

    java -jar ../start.jar --add-to-startd=jndi
  2. Add the CData and license file, located in the lib subfolder of the installation directory, into the lib subfolder of the context path.
  3. Declare the resource and its scope. Enter the required connection properties in the resource declaration. This example declares the Salesforce data source at the level of the Web app, in WEB-INF\jetty-env.xml.

    <Configure id='salesforcedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="salesforcedemo" class=""> <Arg><Ref refid="salesforcedemo"/></Arg> <Arg>jdbc/salesforcedb</Arg> <Arg> <New class="cdata.jdbc.salesforce.SalesforceDriver"> <Set name="url">jdbc:salesforce:</Set> <Set name="User">username</Set> <Set name="Password">password</Set> <Set name="SecurityToken">Your_Security_Token</Set> </New> </Arg> </New> </Configure>

    There are several authentication methods available for connecting to Salesforce: Login, OAuth, and SSO. The Login method requires you to have the username, password, and security token of the user.

    If you do not have access to the username and password or do not wish to require them, you can use OAuth authentication.

    SSO (single sign-on) can be used by setting the SSOProperties, SSOLoginUrl, and TokenUrl connection properties, which allow you to authenticate to an identity provider. See the "Getting Started" chapter in the help documentation for more information.

  4. Configure the resource in the Web.xml:

    jdbc/salesforcedb javax.sql.DataSource Container
  5. You can then access Salesforce with a lookup to java:comp/env/jdbc/salesforcedb: InitialContext ctx = new InitialContext(); DataSource mysalesforce = (DataSource)ctx.lookup("java:comp/env/jdbc/salesforcedb");

More Jetty Integration

The steps above show how to configure the driver in a simple connection pooling scenario. For more use cases and information, see the Working with Jetty JNDI chapter in the Jetty documentation.