WennSie das Archiv der Distribution extrahiert haben,
installieren Sie den Treiber, indem Sie Ihrem Klassenpfad
mysql-connector-java-[version]-bin.jar
hinzufügen. Hierzu schreiben Sie entweder den vollständigen
Pfad in Ihre Umgebungsvariable CLASSPATH
oder
geben ihn direkt mit der Kommandozeilenoption -cp an, wenn Sie
Ihre JVM starten.
Wenn Sie den Treiber mit dem JDBC DriverManager benutzen,
verwenden Sie com.mysql.jdbc.Driver
als die
Klasse, die java.sql.Driver
implementiert.
Die Umgebungsvariable CLASSPATH
können Sie
unter UNIX, Linux oder Mac OS X entweder lokal für einen
Benutzer in seinem .profile
oder in
.login
oder in einer anderen Login-Datei
setzen. Sie kann aber auch global in der Datei
/etc/profile
eingestellt werden.
In einer C-Shell (csh, tcsh) würde der Connector/J-Treiber dem
CLASSPATH
folgendermaßen hinzugefügt:
shell> setenv CLASSPATH /path/to/mysql-connector-java-[version]-bin.jar:$CLASSPATH
In einer Bourne-kompatiblen Shell (sh, ksh, bash) würden Sie dieses tun:
export set CLASSPATH=/path/to/mysql-connector-java-[version]-bin.jar:$CLASSPATH
In Windows 2000, Windows XP und Windows Server 2003 muss die Umgebungsvariable in der Systemsteuerung eingestellt werden.
Wenn Sie MySQL Connector/J mit einem Anwendungsserver wie etwa
Tomcat oder JBoss benutzen möchten, müssen Sie in der
Herstellerdokumentation nachlesen, wie Klassenbibliotheken von
Drittanbietern konfiguriert werden, da die meisten
Anwendungsserver die Umgebungsvariable
CLASSPATH
ignorieren. Beispiele für die
Konfiguration einiger J2EE-Anwendungsserver finden Sie in
Abschnitt 25.3.5.2, „Connector/J mit J2EE und anderen Java-Frameworks einsetzen“. Die
maßgebliche Quelle für die Konfiguration eines
JDBC-Verbindungspools auf Ihrem konkreten Anwendungsserver ist
jedoch dessen Dokumentation.
Wenn Sie Servlets oder JSPs entwickeln und Ihr Anwendungsserver J2EE-fähig ist, können Sie die .jar-Datei des Treibers in das Unterverzeichnis WEB-INF/lib Ihrer Webanwendungen legen, da dies der Standardspeicherort für Bibliotheken von Drittanbietern in J2EE-Webanwendungen ist.
Sie können auch die Klasse MysqlDataSource oder
MysqlConnectionPoolDataSource im Package
com.mysql.jdbc.jdbc2.optional
verwenden, wenn
Ihr J2EE-Anwendungsserver sie unterstützt oder benötigt. Ab
Connector/J 5.0.0 ist über die Klasse
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
auch die Schnittstelle javax.sql.XADataSource
implementiert, die in Verbindung mit dem MySQL-Server 5.0
verteilte XA-Transaktionen unterstützt.
Die diversen MysqlDataSource-Klassen unterstützen (über Standard-Set-Mutators) folgende Parameter:
user
password
serverName (siehe vorhergehenden Abschnitt über Ausfall-Hosts)
databaseName
port
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.