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

Class PostgresqlUrlParser

java.lang.Object

io.opentelemetry.instrumentation.jdbc.internal.parser.PostgresqlUrlParser

All Implemented Interfaces:

JdbcUrlParser

public final class PostgresqlUrlParser
extends Object
implements JdbcUrlParser

Parses PostgreSQL JDBC connection strings.

Sample URLs:

• postgresql://host:5432/db
• postgresql://host/db?user=postgres
• postgresql://user@host/db
• pgsql://host:5432/db
• postgresql://host/db?currentSchema=myschema

PostgreSQL defaults to localhost:5432 when host/port are not specified.

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 PostgresqlUrlParser	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 PostgresqlUrlParser 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