Package io.github.mfvanek.pg.connection.host

Class PgUrlParser

java.lang.Object

io.github.mfvanek.pg.connection.host.PgUrlParser

public final class PgUrlParser
extends Object

Utility class for parsing and manipulating PostgreSQL connection URLs.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	TESTCONTAINERS_PG_URL_PREFIX	The URL prefix used in Testcontainers to initialize PostgreSQL containers.
static final String	URL_HEADER	Header prefix for PostgreSQL JDBC URLs.

Method Summary

Modifier and Type	Method	Description
static String	buildCommonUrlToPrimary(String firstPgUrl, String secondPgUrl)	Constructs a common (joint) PostgreSQL URL for a primary server.
static String	buildCommonUrlToPrimary(String firstPgUrl, String secondPgUrl, Map<String,String> urlParameters)	Constructs a common (joint) PostgreSQL URL for a primary server.
static String	buildCommonUrlToPrimary(Set<String> pgUrls)	Constructs a common (joint) PostgreSQL URL for a primary server.
static String	buildCommonUrlToPrimary(Set<String> pgUrls, Map<String,String> urlParameters)	Constructs a common (joint) PostgreSQL URL for a primary server.
static List<Map.Entry<String,String>>	extractNameWithPortAndUrlForEachHost(String pgUrl)	Extracts host-port pairs and builds replica-compatible connection URLs for each host.

Methods inherited from class java.lang.Object

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

Field Details

URL_HEADER

public static final String URL_HEADER

Header prefix for PostgreSQL JDBC URLs.

See Also:

• Constant Field Values

TESTCONTAINERS_PG_URL_PREFIX

public static final String TESTCONTAINERS_PG_URL_PREFIX

The URL prefix used in Testcontainers to initialize PostgreSQL containers.

Testcontainers provides a special JDBC URL format that allows for on-the-fly creation and management of PostgreSQL database containers during tests. This prefix is part of the JDBC URL and signals Testcontainers to handle the lifecycle of the container automatically.

Since:

0.14.2

See Also:

• Testcontainers JDBC Support
• Constant Field Values

Method Details

extractNameWithPortAndUrlForEachHost

@Nonnull
public static List<Map.Entry<String,String>> extractNameWithPortAndUrlForEachHost(@Nonnull
 String pgUrl)

Extracts host-port pairs and builds replica-compatible connection URLs for each host.

Parameters:

pgUrl - the PostgreSQL connection URL; must be valid and non-blank.

Returns:

a list of host-port pairs and corresponding replica-compatible URLs.

buildCommonUrlToPrimary

@Nonnull
public static String buildCommonUrlToPrimary(@Nonnull
 String firstPgUrl,
 @Nonnull
 String secondPgUrl)

Constructs a common (joint) PostgreSQL URL for a primary server.

Parameters:

firstPgUrl - a first PostgreSQL connection URL.

secondPgUrl - a second PostgreSQL connection URL.

Returns:

the constructed primary connection URL.

buildCommonUrlToPrimary

@Nonnull
public static String buildCommonUrlToPrimary(@Nonnull
 String firstPgUrl,
 @Nonnull
 String secondPgUrl,
 @Nonnull
 Map<String,String> urlParameters)

Constructs a common (joint) PostgreSQL URL for a primary server.

Parameters:

firstPgUrl - a first PostgreSQL connection URL.

secondPgUrl - a second PostgreSQL connection URL.

urlParameters - optional additional parameters to include in the URL.

Returns:

the constructed primary connection URL.

buildCommonUrlToPrimary

@Nonnull
public static String buildCommonUrlToPrimary(@Nonnull
 Set<String> pgUrls)

Constructs a common (joint) PostgreSQL URL for a primary server.

Parameters:

pgUrls - a set of PostgreSQL connection URLs.

Returns:

the constructed primary connection URL.

buildCommonUrlToPrimary

@Nonnull
public static String buildCommonUrlToPrimary(@Nonnull
 Set<String> pgUrls,
 @Nonnull
 Map<String,String> urlParameters)

Constructs a common (joint) PostgreSQL URL for a primary server.

Parameters:

pgUrls - a set of PostgreSQL connection URLs.

urlParameters - optional additional parameters to include in the URL.

Returns:

the constructed primary connection URL.