Package io.opentelemetry.instrumentation.jdbc.internal.parser

Class MysqlUrlParser

java.lang.Object

io.opentelemetry.instrumentation.jdbc.internal.parser.MysqlUrlParser

All Implemented Interfaces:

JdbcUrlParser

public final class MysqlUrlParser
extends Object
implements JdbcUrlParser

Parser for MySQL and MariaDB JDBC URLs.

Sample URLs:

• mysql://host:3306/db
• mysql://host/db?user=root
• mysql:aurora://host:3306/db
• mysql:host:3306/db (non-standard format)
• mariadb:replication://host1,host2/db
• mariadb:sequential:address=(host=host1)(port=3306)(user=root)/db
• mysql://[::1]:3306/db (IPv6)

This class is internal and is hence not for public use. Its APIs are unstable and can change at any time.

Field Summary

Fields

Modifier and Type	Field	Description
static final MysqlUrlParser	INSTANCE

Method Summary

Modifier and Type	Method	Description
void	parse(String jdbcUrl, ParseContext ctx)	Parse the JDBC URL and populate the context with extracted information.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

INSTANCE

public static final MysqlUrlParser INSTANCE

Method Details

parse

public void parse(String jdbcUrl,
 ParseContext ctx)

Description copied from interface: JdbcUrlParser

Parse the JDBC URL and populate the context with extracted information.

Implementations are responsible for the full parsing lifecycle:

1. Set driver-specific defaults (system name, default host/port/user)
2. Call ParseContext.applyDataSourceProperties() or ParseContext.applyUserProperty() at the appropriate point to match driver-specific precedence semantics. Use applyUserProperty() for drivers whose DataSource does not support the standard serverName/portNumber/databaseName properties.
3. Parse the URL structure

The placement of ParseContext.applyDataSourceProperties() controls precedence:

• Before URL parsing: URL values take precedence (e.g., PostgreSQL, MySQL, Oracle)
• After URL parsing: DataSource properties take precedence (e.g., Microsoft SQL Server)

Specified by:

parse in interface JdbcUrlParser

Parameters:

jdbcUrl - the JDBC URL to parse (without the "jdbc:" prefix)

ctx - the parse context containing type and optional DataSource properties