How mariadb-corporation/mariadb-connector-j works
MariaDB Connector/J is a JDBC driver that lets Java applications connect to MariaDB and MySQL. The principal path is application JDBC use through driver/configuration and connection/statement APIs, then client execution over the wire and result delivery. The source index supports the main execution, protocol, and result relationships shown here; README documentation establishes the driver’s product role and high-availability capability. Some subsystems are represented from the file tree without sampled implementation details, so their internal links are omitted.
Main entry points: StandardClient.java Standard client · ClientMessage.java Protocol messages · Connection.java JDBC connection · Configuration.java Connection options
Components 22
JDBC API
- JDBC driver
src/main/java/org/mariadb/jdbc/Driver.java - Connection options
src/main/java/org/mariadb/jdbc/Configuration.java - JDBC connection
src/main/java/org/mariadb/jdbc/Connection.java - Statement API
src/main/java/org/mariadb/jdbc/Statement.java - Prepared statements
src/main/java/org/mariadb/jdbc/ClientPreparedStatement.java - Database metadata
src/main/java/org/mariadb/jdbc/DatabaseMetaData.java
Connection Management
- Host selection
src/main/java/org/mariadb/jdbc/HostAddress.java - Client execution API
src/main/java/org/mariadb/jdbc/client/Client.java - Standard client
src/main/java/org/mariadb/jdbc/client/impl/StandardClient.java - HA client modes
src/main/java/org/mariadb/jdbc/client/impl
Protocol and Results
- Protocol messages
src/main/java/org/mariadb/jdbc/message/ClientMessage.java - Packet writer
src/main/java/org/mariadb/jdbc/client/socket/Writer.java - Packet reader
src/main/java/org/mariadb/jdbc/client/socket/Reader.java - Byte buffer
src/main/java/org/mariadb/jdbc/client/ReadableByteBuf.java - Column decoding
src/main/java/org/mariadb/jdbc/client/ColumnDecoder.java - Query results
src/main/java/org/mariadb/jdbc/client/result/Result.java - Complete results
src/main/java/org/mariadb/jdbc/client/result/CompleteResult.java
Driver Capabilities
- Connection pooling
src/main/java/org/mariadb/jdbc/pool/Pool.java - Authentication plugins
src/main/java/org/mariadb/jdbc/plugin/authentication/AuthenticationPluginLoader.java - TLS plugins
src/main/java/org/mariadb/jdbc/plugin/tls/TlsSocketPluginLoader.java - Type codecs
src/main/java/org/mariadb/jdbc/plugin/codec
Other components
- Java application
Connections 18
- Java application → JDBC driver: uses JDBC
README.md - JDBC driver → JDBC connection: opens connection
src/main/java/org/mariadb/jdbc/Driver.java - JDBC connection → Standard client: creates client
src/main/java/org/mariadb/jdbc/Connection.java - JDBC connection → Connection options: uses options
src/main/java/org/mariadb/jdbc/Connection.java - Prepared statements → JDBC connection: uses connection
src/main/java/org/mariadb/jdbc/ClientPreparedStatement.java - Prepared statements → Protocol messages: references messages
src/main/java/org/mariadb/jdbc/ClientPreparedStatement.java - Standard client → Client execution API: implements API
src/main/java/org/mariadb/jdbc/client/impl/StandardClient.java - Standard client → Packet reader: reads packets
src/main/java/org/mariadb/jdbc/client/impl/StandardClient.java - Standard client → Packet writer: writes packets
src/main/java/org/mariadb/jdbc/client/impl/StandardClient.java - Protocol messages → Packet reader: reads response
src/main/java/org/mariadb/jdbc/message/ClientMessage.java - Protocol messages → Query results: creates results
src/main/java/org/mariadb/jdbc/message/ClientMessage.java - Protocol messages → Complete results: creates complete result
src/main/java/org/mariadb/jdbc/message/ClientMessage.java - Protocol messages → Column decoding: decodes columns
src/main/java/org/mariadb/jdbc/message/ClientMessage.java - Column decoding → Byte buffer: decodes bytes
src/main/java/org/mariadb/jdbc/client/ColumnDecoder.java - Connection options → Authentication plugins: loads plugins
src/main/java/org/mariadb/jdbc/Configuration.java - Connection options → Type codecs: loads codecs
src/main/java/org/mariadb/jdbc/Configuration.java - Standard client → HA client modes: supports HA modes
src/main/java/org/mariadb/jdbc/client/impl/StandardClient.java - JDBC connection → Database metadata: provides metadata
src/main/java/org/mariadb/jdbc/DatabaseMetaData.java