testcontainers/testcontainers-java

Add getR2dbcUrl helper method to JdbcDatabaseContainer

Open

#8,797 opened on Jun 23, 2024

View on GitHub
 (13 comments) (0 reactions) (0 assignees)Java (7,535 stars) (1,588 forks)batch import
good first issuemodules/r2dbctype/enhancement

Description

Module

Core

Problem

I might've been chosen the wrong module, sorry for that, haven't found one for all RDBMS containers.

There is a convenient method, getJdbcUrl in JdbcDatabaseContainer. The problem however, if I'm working with R2DBC the connection string schema is different. Currently, I have to create an R2DBC connection string myself, which is a bit tedious.

Solution

It would be great to have a similar method in JdbcDatabaseContainer, like getR2dbcUrl that would construct the R2DBC compliant connection string.

Benefit

This would make integration with R2DBC drivers more seamless and provide better developer experience.

Alternatives

The alternative, I think, is to create the connection string manually, which might be fine, not a big deal, until you have to do it over and over again, in which case it became really frustrating.

Would you like to help contributing this feature?

Yes

Contributor guide

Tech stack
javasql
Domain
database
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
JavaTestcontainersR2DBC basics
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70
Research direction
Examine the existing getJdbcUrl method in the JdbcDatabaseContainer class (located in the core module). Understand how it constructs the JDBC URL. Then study the R2DBC URL specification and create a similar getR2dbcUrl method that generates the correct R2DBC connection string. Consider if any configuration like encoding or parameters need to be adjusted. Review the class for any existing helper methods to ensure consistency.