Package fr.codinbox.connector.commons.redis

Interface RedisConnectorService

All Known Implementing Classes:
RedisConnectorServiceImpl
public interface RedisConnectorService
Service interface for managing multiple named Redis connections.

Connections are discovered from environment variables with the CONNECTOR_REDIS_ prefix. Each connection is identified by a unique name extracted from the environment variable pattern CONNECTOR_REDIS_<NAME>_CONFIG.

Logging contract:

  • INFO — lifecycle events (initialization start, connection count, connection created)
  • WARNING — recoverable failures (missing config when exit-on-failure is disabled)
  • SEVERE — fatal failures that will cause server shutdown
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    @NotNull Optional<RedisConnection>
    getConnection(@NotNull String id)
    Retrieves a Redis connection by its identifier.
    void
    init()
    Initializes all Redis connections discovered from environment variables.
    void
    shutdown()
    Shuts down all managed Redis connections.

  • Method Details

    • init

      void init() throws ConnectionInitException
      Initializes all Redis connections discovered from environment variables.
      Throws:
      ConnectionInitException - if a connection with exit-on-failure enabled fails to initialize

    • shutdown

      void shutdown()
      Shuts down all managed Redis connections.

    • getConnection

      @NotNull @NotNull Optional<RedisConnection> getConnection(@NotNull @NotNull String id)
      Retrieves a Redis connection by its identifier.
      Parameters:
      id - the connection identifier (case-sensitive, as extracted from environment variables)
      Returns:
      an Optional containing the connection, or empty if no connection exists with that id