Connect to SQL Server Data from a Connection Pool in Jetty

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

   
   
   <Configure id='sqldemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="sqldemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="sqldemo"/></Arg>
       <Arg>jdbc/sqldb</Arg>
       <Arg>
         <New class="cdata.jdbc.sql.SQLDriver">
           <Set name="url">jdbc:sql:</Set>
           <Set name="User">myUser</Set>
           <Set name="Password">myPassword</Set>
           <Set name="Database">NorthWind</Set>
           <Set name="Server">myServer</Set>
           <Set name="Port">1433</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

   Connecting to Microsoft SQL Server

   Connect to Microsoft SQL Server using the following properties:

   • Server: The name of the server running SQL Server.
   • User: The username provided for authentication with SQL Server.
   • Password: The password associated with the authenticating user.
   • Database: The name of the SQL Server database.

   Connecting to Azure SQL Server and Azure Data Warehouse

   You can authenticate to Azure SQL Server or Azure Data Warehouse by setting the following connection properties:

   • Server: The server running Azure. You can find this by logging into the Azure portal and navigating to "SQL databases" (or "SQL data warehouses") -> "Select your database" -> "Overview" -> "Server name."
   • User: The name of the user authenticating to Azure.
   • Password: The password associated with the authenticating user.
   • Database: The name of the database, as seen in the Azure portal on the SQL databases (or SQL warehouses) page.

   SSH Connectivity for SQL Server

   You can use SSH (Secure Shell) to authenticate with SQL Server, whether the instance is hosted on-premises or in supported cloud environments. SSH authentication ensures that access is encrypted (as compared to direct network connections).

   SSH Connections to SQL Server in Password Auth Mode

   To connect to SQL Server via SSH in Password Auth mode, set the following connection properties:

   • User: SQL Server User name
   • Password: SQL Server Password
   • Database: SQL Server database name
   • Server: SQL Server Server name
   • Port: SQL Server port number like 3306
   • UserSSH: "true"
   • SSHAuthMode: "Password"
   • SSHPort: SSH Port number
   • SSHServer: SSH Server name
   • SSHUser: SSH User name
   • SSHPassword: SSH Password

   SSH Connections to SQL Server in Public Key Auth Mode

   To connect to SQL Server via SSH in Password Auth mode, set the following connection properties:

   • User: SQL Server User name
   • Password: SQL Server Password
   • Database: SQL Server database name
   • Server: SQL Server Server name
   • Port: SQL Server port number like 3306
   • UserSSH: "true"
   • SSHAuthMode: "Public_Key"
   • SSHPort: SSH Port number
   • SSHServer: SSH Server name
   • SSHUser: SSH User name
   • SSHClientCret: the path for the public key certificate file

4. Configure the resource in the Web.xml:

   
   
     jdbc/sqldb
     javax.sql.DataSource
     Container
   
   

5. You can then access SQL Server with a lookup to java:comp/env/jdbc/sqldb:

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

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.