Noções básicas sobre o suporte ao Java EE
As seções a seguir documentam como o Microsoft JDBC Driver para SQL Server fornece suporte para a Plataforma Java, Enterprise Edition (Java EE) e recursos opcionais de API do JDBC 3.0. Os exemplos de código-fonte fornecidos neste sistema de Ajuda fornecem uma boa referência como introdução a esses recursos.
Primeiro, tenha certeza de que seu ambiente Java (JDK, JRE) inclua o pacote javax.sql. Este pacote é exigido por qualquer aplicativo do JDBC que usa a API opcional. O JDK 1.5 e as versões posteriores já contêm esse pacote; portanto, você não precisará instalá-lo separadamente.
Nome do driver
O nome de classe do driver é com.microsoft.sqlserver.jdbc.SQLServerDriver.
Para o JDBC Driver 12.8, o driver está contido no arquivo mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Para o JDBC Driver 12.6, o driver está contido no arquivo mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Para o JDBC Driver 12.4, o driver está contido em mssql-jdbc-12.4.0.jre8.jar ou no mssql-jdbc-12.4.0.jre11.jar.
Para o JDBC Driver 12.2, o driver está contido no arquivo mssql-jdbc-12.2.0.jre8.jar ou no mssql-jdbc-12.2.0.jre11.jar.
No caso do JDBC Driver 11.2, o driver está contido em mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.
Para o JDBC Driver 10.2, o driver está contido em mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Para o JDBC Driver 9.4, o driver está contido em mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Para o JDBC Driver 9.2, o driver está contido em mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Para o JDBC Driver 8.4, o driver está contido em mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.
Para o JDBC Driver 8.2, o driver está contido em mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.
Para o JDBC Driver 7.4, o driver está contido no mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.
Para o JDBC Driver 7.2, o driver está contido no mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar.
Para o JDBC Driver 7.0, o driver está contido no mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar.
Para o JDBC Driver 6.4, o driver está contido no mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.
Para o JDBC Driver 6.2, o driver está contido no mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar.
Para os JDBC Drivers 4.1, 4.2 e 6.0, o driver está contido nos arquivos sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.
O nome de classe é usado sempre que você carrega o driver com a classe DriverManager do JDBC e sempre que especifica o nome de classe do driver em qualquer configuração de driver. Por exemplo, configurar uma fonte de dados em um servidor de aplicativos do Java EE pode exigir que você insira o nome de classe do driver.
Fontes de dados
O JDBC driver dá suporte a fontes de dados para Java EE/JDBC 3.0. A classe SQLServerXADataSource do JDBC Driver é implementada por com.microsoft.sqlserver.jdbc.SQLServerXADataSource.
Nomes da fonte de dados
Você pode fazer conexões de banco de dados usando fontes de dados. As fontes de dados disponíveis com o driver JDBC são descritas na tabela a seguir:
| Tipo de fonte de dados | Nome de classe e descrição |
|---|---|
| DataSource | com.microsoft.sqlserver.jdbc.SQLServerDataSource A fonte de dados de não pooling. |
| ConnectionPoolDataSource | com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource A fonte de dados para configurar pools de conexão de servidor de aplicativos do JAVA EE. Geralmente usado quando o aplicativo é executado dentro de um servidor de aplicativos do JAVA EE. |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource A fonte de dados para configurar fontes de dados do JAVA EE XA. Geralmente usado quando o aplicativo é executado dentro de um servidor de aplicativos do JAVA EE e um gerenciador de transações XA. |
Propriedades da fonte de dados
Todas as fontes de dados oferecem suporte à capacidade de definir e obter qualquer propriedade que está associada com o conjunto de propriedades do driver subjacente.
Exemplos:
setServerName("localhost");
setDatabaseName("AdventureWorks");
Veja a seguir como um aplicativo é conectado usando uma fonte de dados:
//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
Para saber mais sobre as propriedades de fonte de dados, confira Definindo as propriedades da fonte de dados.