kdbc/onl.ycode.kdbc/JdbcUrlParser

JdbcUrlParser

Parses a standard JDBC URL into the form expected by the kdbc C library.

Supported prefixes (fully JDBC-compatible):

jdbc:sqlite:/path/to/file.db
jdbc:sqlite::memory:
jdbc:sqlite:file::memory:?cache=shared
jdbc:postgresql://host:port/database?user=x&password=y
jdbc:mariadb://host:port/database?user=x&password=y
jdbc:mysql://host:port/database?user=x&password=y                         // → MARIADB driver
jdbc:oracle:thin:@host:port/service_name                                  // modern
jdbc:oracle:thin:@//host:port/service_name                                // modern (// form)
jdbc:oracle:thin:@host:port:SID                                           // legacy SID
jdbc:sqlserver://host:port;databaseName=db;user=x;password=y

Explicit user / password arguments to parse override any values in the URL. Unknown URL parameters are returned in ParsedJdbcUrl.extraParams.

Throws

SQLException

for malformed or unsupported URLs.

Functions

parse

fun parse(url: String, user: String? = null, password: String? = null): ParsedJdbcUrl

Parses url into a ParsedJdbcUrl. See the class KDoc for supported JDBC prefixes and behaviour. Explicit user / password override any credentials embedded in the URL's query string.