Repository files navigation

MySQL provides connectivity for client applications developed in the Java programming language with MySQL Connector/J, a driver that implements theJava Database Connectivity (JDBC) API and alsoMySQL X DevAPI.

MySQL Connector/J 9.5 is a JDBC Type 4 driver that is compatible with theJDBC 4.2 specification. The Type 4 designation means that the driver is a pure Java implementation of the MySQL protocol and does not rely on the MySQL client libraries.

The driver also contains an implementation ofMySQL X DevAPI, an application programming interface for working withMySQL as a Document Store through CRUD-based, NoSQL operations.

For more information, please visit the officialMySQL Connector/J documentation.

Please refer to theREADME andLICENSE files, available in this repository, and theLegal Notices in the MySQL Connector/J documentation for further details.

Oracle values the independent security research community and believes that responsible disclosure of security vulnerabilities helps us ensure the security and privacy of all our users. Please refer to thesecurity guidelines document for additional information.

MySQL Connector/J is free for usage under the terms of the specified licensing and it runs on any operating system that is able to run a Java Virtual Machine.

MySQL Connector/J can be installed from pre-compiled packages that can be downloaded from theMySQL Connector/J download page. Installing MySQL Connector/J only requires obtaining the corresponding JAR file from the downloaded bundle or installer and including it in the application's CLASSPATH.

According to how you use MySQL Connector/J, you may also need to install the following third-party libraries on your system for it to work:

• Protocol Buffers (protobuf-java) is required for using X DevAPI.
• Oracle Cloud Infrastructure SDK for Java (oci-java-sdk) is required to support OCI AIM authentication.
• Simple Logging Facade API (slf4j-api) is required for using the logging capabilities provided by the default implementation of org.slf4j.Logger.Slf4JLogger by MySQL Connector/J.
• OpenTelemetry API and SDK are required for enabling OpenTelemetry native instrumentation.

Alternatively, MySQL Connector/J can be obtained automatically viaMaven's dependency management by adding the following configuration in the application's Project Object Model (POM) file:

<dependency>  <groupId>com.mysql</groupId>  <artifactId>mysql-connector-j</artifactId>  <version>9.5.0</version></dependency>

MySQL Connector/J's own Project Object Model (POM) file specifies a transitive dependency to Protocol Buffers (protobuf-java) since it is required for using X DevAPI. However, if you do not use the X DevAPI features, you may also want to add a dependency exclusion to avoid linking the unneeded sub-library. For example:

<dependency>  <groupId>com.mysql</groupId>  <artifactId>mysql-connector-j</artifactId>  <version>9.5.0</version>  <exclusions>    <exclusion>      <groupId>com.google.protobuf</groupId>      <artifactId>protobuf-java</artifactId>    </exclusion>  </exclusions> </dependency>

This driver can also be complied and installed from the source available in this repository. Please refer to the MySQL Connector/J documentation fordetailed instructions on how to do it.

This repository contains the MySQL Connector/J source code as per the latest release. No changes are made in this repository between releases.

We greatly appreciate feedback from our users, including bug reports and code contributions. Your input helps us improve, and we thank you for any issues you report or code you contribute. Please refer to thecontributing guidelines document for additional information.

• MySQL Connector/J Developer Guide.
• MySQL Connector/J X DevAPI Reference.
• MySQL Connector/J, JDBC and Java Forum.
• #connectors channel in MySQL Community Slack (Sign-up required if you do not have an Oracle account.)
• @MySQL on X.
• MySQL Blog.
• MySQL Connectors Blog archive.
• MySQL Newsletter.
• MySQL Bugs Tracking System.

For more information about this and other MySQL products, please visitMySQL Contact & Questions.