Connect to AdRoll Data from a Connection Pool in Jetty

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
The AdRoll JDBC Driver supports connection pooling: This article shows how to connect faster to AdRoll data from Web apps in Jetty.

The CData JDBC driver for AdRoll is easy to integrate with Java Web applications. This article shows how to efficiently connect to AdRoll data in Jetty by configuring the driver for connection pooling. You will configure a JNDI resource for AdRoll 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 AdRoll data source at the level of the Web app, in WEB-INF\jetty-env.xml.

    
    <Configure id='adrolldemo' class="org.eclipse.jetty.webapp.WebAppContext">
        <New id="adrolldemo" class="org.eclipse.jetty.plus.jndi.Resource">
        <Arg><Ref refid="adrolldemo"/></Arg>
        <Arg>jdbc/adrolldb</Arg>
        <Arg>
          <New class="cdata.jdbc.api.APIDriver">
            <Set name="url">jdbc:api:</Set>
            <Set name="Profile">C:\profiles\AdRoll.apip</Set>
            <Set name="Authscheme">OAuth</Set>
            <Set name="OAuthClientId">your_client_id</Set>
            <Set name="OAuthClientSecret">your_client_secret</Set>
            <Set name="CallbackUrl">your_callback_url</Set>
          </New>
        </Arg>
      </New>
    </Configure>
    

    Start by setting the Profile connection property to the location of the AdRoll Profile on disk (e.g. C:\profiles\AdRoll.apip). Next, set the ProfileSettings connection property to the connection string for AdRoll (see below).

    AdRoll API Profile Settings

    Register a developer account with AdRoll and create an OAuth application to receive a client ID and secret.

  4. Configure the resource in the Web.xml:

    
      jdbc/adrolldb
      javax.sql.DataSource
      Container
    
    
  5. You can then access AdRoll with a lookup to java:comp/env/jdbc/adrolldb:

    InitialContext ctx = new InitialContext();
    DataSource myadroll = (DataSource)ctx.lookup("java:comp/env/jdbc/adrolldb");
    

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.

Ready to get started?

Connect to live data from AdRoll with the API Driver

Connect to AdRoll