Informazioni sul supporto Java EE
Nelle sezioni seguenti viene descritto in che modo il driver Microsoft JDBC per SQL Server fornisce il supporto per la piattaforma Java Enterprise Edition (Java EE) e le caratteristiche API facoltative di JDBC 3.0. Gli esempi di codice sorgente forniti in questo sistema di Guida costituiscono un buon riferimento per iniziare a usare queste caratteristiche.
Assicurarsi innanzitutto che l'ambiente Java (JDK, JRE) includa il pacchetto javax.sql. Questo pacchetto è necessario per qualsiasi applicazione JDBC che usi l'API facoltativa. JDK 1.5 e le versioni successive contengono già questo pacchetto, pertanto non è necessario installarlo separatamente.
Nome del driver
Il nome della classe del driver è com.microsoft.sqlserver.jdbc.SQLServerDriver.
Per il driver JDBC 12.8, il driver è incluso in mssql-jdbc-12.8.0.jre8.jar o mssql-jdbc-12.8.0.jre11.jar.
Per il driver JDBC 12.6, il driver è incluso in mssql-jdbc-12.6.0.jre8.jar oppure mssql-jdbc-12.6.0.jre11.jar.
Per il driver JDBC 12.4, il driver è incluso in mssql-jdbc-12.4.0.jre8.jar oppure mssql-jdbc-12.4.0.jre11.jar.
Per il driver JDBC 12.2, il driver è incluso in mssql-jdbc-12.2.0.jre8.jar oppure mssql-jdbc-12.2.0.jre11.jar.
Per il driver JDBC 11.2, il driver è incluso in mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar o mssql-jdbc-11.2.0.jre18.jar.
Per il driver JDBC 10.2, il driver è incluso in mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar o mssql-jdbc-10.2.0.jre17.jar.
Per il driver JDBC 9.4, il driver è incluso in mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar o mssql-jdbc-9.4.1.jre16.jar.
Per il driver JDBC 9.2, il driver è incluso in mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar o mssql-jdbc-9.2.1.jre15.jar.
Per il driver JDBC 8.4, il driver è incluso in mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar o mssql-jdbc-8.4.1.jre14.jar.
Per il driver JDBC 8.2, il driver è incluso in mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar o mssql-jdbc-8.2.2.jre13.jar.
Per il driver JDBC 7.4, il driver è incluso in mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar o mssql-jdbc-7.4.1.jre12.jar.
Per il driver JDBC 7.2, il driver è incluso in mssql-jdbc-7.2.2.jre8.jar o mssql-jdbc-7.2.2.jre11.jar.
Per il driver JDBC 7.0, il driver è incluso in mssql-jdbc-7.0.0.jre8.jar o mssql-jdbc-7.0.0.jre10.jar.
Per il driver JDBC 6.4, il driver è incluso in mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar o mssql-jdbc-6.4.0.jre9.jar.
Per il driver JDBC 6.2, il driver è incluso in mssql-jdbc-6.2.2.jre7.jar oppure mssql-jdbc-6.2.2.jre8.jar.
Per JDBC Driver 4.1, 4.2 e 6.0, il driver è incluso nel file sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar o sqljdbc42.jar.
Il nome della classe viene usato ogni volta che si carica il driver con la classe JDBC DriverManager e ogni volta che si specifica il nome della classe del driver in qualsiasi configurazione del driver. Per configurare un'origine dati all'interno di un server applicazioni Java EE potrebbe ad esempio essere necessario immettere il nome della classe del driver.
Origini dati
Il driver JDBC fornisce supporto per le origini dati Java EE e JDBC 3.0. La classe SQLServerXADataSource del driver JDBC è implementata da com.microsoft.sqlserver.jdbc.SQLServerXADataSource.
Nomi delle origini dati
È possibile stabilire connessioni al database utilizzando le origini dati. Le origini dati disponibili con il driver JDBC sono descritte nella tabella seguente:
| Tipo di origine dati | Nome e descrizione della classe |
|---|---|
| Origine dati | com.microsoft.sqlserver.jdbc.SQLServerDataSource Origine dati non per i pool. |
| ConnectionPoolDataSource | com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource Origine dati per la configurazione dei pool di connessioni al server applicazioni JAVA EE. Utilizzata in genere quando l'applicazione è in esecuzione in un server applicazioni JAVA EE. |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource Origine dati per la configurazione delle origini dati JAVA EE XA. Utilizzata in genere quando l'applicazione è in esecuzione in un server applicazioni JAVA EE e in uno strumento di gestione transazioni XA. |
Proprietà dell'origine dati
Tutte le origini dati consentono di impostare e ottenere qualsiasi proprietà associata al set di proprietà del driver sottostante.
Esempi:
setServerName("localhost");
setDatabaseName("AdventureWorks");
Di seguito viene illustrato in che modo un'applicazione si connette utilizzando un'origine dati:
//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
Per altre informazioni sulle proprietà dell'origine dati, vedere Impostazione delle proprietà dell'origine dati.