Connection-Pool Library

Biblioteka Connection-Pool to moja własna implementacja w języku Java, służąca do zarządzania pulą połączeń do bazy danych. Przygotowałem to, jako alternatywę dla gotowych rozwiązań, aby lepiej zrozumieć zarządzanie połączeniami oraz wielowątkowość.

🎯 Funkcjonalności

• System zarządzania połączeniami: Klasa DatabaseConnection odpowiedzialna za ustanawianie połączeń z bazą danych, zarządzanie parametrami połączeń (użytkownik, hasło, URL, itp.), logowanie informacji o stanie połączeń oraz obsługę błędów podczas nawiązywania i zamykania połączeń.

• Pula połączeń:Klasa ConnectionPool zarządza pulą połączeń do bazy danych. Na starcie aplikacji inicjalizowana jest określona liczba połączeń minPoolSize, kontrolowana jest maksymalna liczba połączeń maxPoolSize oraz zapewniona jest synchronizacja i bezpieczeństwo wielowątkowe za pomocą mechanizmów takich jak Semaphore i Lock.

• Obsługa zapytań o połączenia i ich zwalnianie: Klasa ConnectionPool udostępnia metody getConnection() i releaseConnection(), umożliwiające pobieranie i zwracanie połączeń z/do puli. W przypadku braku dostępnych połączeń, jeżeli liczba połączeń w puli nie przekracza maxPoolSize, tworzone są nowe połączenia.

• Mechanizm usuwania nieaktywnych połączeń: Metoda removeIdleConnection() oraz harmonogram startConnectionRemovalScheduler() pozwalają na regularne sprawdzanie puli i usuwanie nieaktywnych połączeń, które przekraczają minimalny rozmiar puli minPoolSize. Dzięki temu zasoby są zwalniane i nieużywane połączenia są eliminowane.

🚀 Technologie i biblioteki

• Java 21

• PostgtreSQL

• JUnit

• Log4j2

• Lombok

• Gradle

📂 Struktura Projektu

.
├── src
│   ├── main
│   │   └── java
│   │       ├── connection_pool          # Logika zarządzania pulą połączeń
│   │       └── data                     # Obsługa połączeń do bazy danych
│   └── test                             # Testy jednostkowe i wydajnościowe
├── build.gradle                         # Konfiguracja budowania projektu
└── ...

🚀 Implementacja

• Upewnij się, że masz zainstalowane:
• Java Development Kit (JDK) w wersji 21 lub wyższej
• Gradle do zarządzania zależnościami
• Bazę danych PostgreSQL

• Sklonuj repozytorium:

git clone https://github.com/user/Connection-Pool-Library.git
cd Connection-Pool

• Skonfiguruj bazę danych:
• Utwórz bazę danych PostgreSQL
• Zaktualizuj dane logowania w pliku DatabaseConnection.java
• Ścieżka do pliku:
src/com/jakub/bone/data/AirportDatabase.java
• Zastąp dane logowania swoimi:

private String user = "twoj_uzytkownik";
private String password = "twoje_haslo";

• Zbuduj projekt:

./gradlew build

🛠️ Przykład Użycia

private String user = "twoj_uzytkownik";
private String password = "twoje_haslo";

DatabaseConnection dbConn = new DatabaseConnection("user", "password", "baza", 5432);
ConnectionPool pool = new ConnectionPool(10, 100, dbConn);

// Pobranie połączenia
Connection conn = pool.getConnection();

// Wykonanie zapytań
try (Statement stmt = conn.createStatement()) {
    stmt.executeUpdate("INSERT INTO test_table (data) VALUES ('example');");
}

// Zwolnienie połączenia
pool.releaseConnection(conn);

🔗 Repozytorium