Merge pull request #9 from Rurutia1027/b_support-mysql

let persistent common support mysql datasource

Author: Rurutia1027

persistence-common/README.md

@@ -88,6 +88,39 @@ public class PersistenceConfig {
 }
 ```
 
+#### Using MySQL
+
+To use MySQL as the data source, add the MySQL JDBC driver and configure the dialect:
+
+**Maven dependency (in your application):**
+```xml
+<dependency>
+    <groupId>com.mysql</groupId>
+    <artifactId>mysql-connector-j</artifactId>
+    <scope>runtime</scope>
+</dependency>
+```
+
+**Configuration:**
+```java
+@Bean
+@Primary
+public DataSource dataSource() {
+    DriverManagerDataSource ds = new DriverManagerDataSource();
+    ds.setDriverClassName("com.mysql.cj.jdbc.Driver");
+    ds.setUrl("jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf8");
+    ds.setUsername("user");
+    ds.setPassword("password");
+    return ds;
+}
+
+// In sessionFactory hibernate properties:
+props.put("hibernate.dialect", "org.hibernate.dialect.MySQLDialect");  // or MySQL8Dialect for MySQL 8+
+```
+
+To run integration tests against MySQL (Testcontainers), use:  
+`mvn test -DexcludedGroups=` (runs all tests including MySQL). By default, MySQL container tests are excluded for faster CI.
+
 ### 3. Define Entities 
 
 ```java

persistence-common/pom.xml

@@ -23,6 +23,7 @@
 
         <!-- Database -->
         <postgresql.version>42.7.2</postgresql.version>
+        <mysql.version>8.4.0</mysql.version>
 
         <!-- Utils -->
         <commons-codec.version>1.16.0</commons-codec.version>
@@ -31,6 +32,7 @@
         <!-- Test -->
         <junit.version>5.10.1</junit.version>
         <testcontainers.version>1.20.3</testcontainers.version>
+        <test.excludedGroups>mysql</test.excludedGroups>
     </properties>
 
     <dependencies>
@@ -124,6 +126,13 @@
             <scope>test</scope>
         </dependency>
 
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>mysql</artifactId>
+            <version>${testcontainers.version}</version>
+            <scope>test</scope>
+        </dependency>
+        
         <dependency>
             <groupId>org.testcontainers</groupId>
             <artifactId>junit-jupiter</artifactId>
@@ -145,6 +154,13 @@
             <scope>test</scope>
         </dependency>
 
+        <dependency>
+            <groupId>com.mysql</groupId>
+            <artifactId>mysql-connector-j</artifactId>
+            <version>${mysql.version}</version>
+            <scope>test</scope>
+        </dependency>
+        
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-test</artifactId>
@@ -169,6 +185,10 @@
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
                 <version>3.1.2</version>
+                <configuration>
+                    <!-- Exclude MySQL Testcontainers tests by default; run with -DexcludedGroups= to include -->
+                    <excludedGroups>${test.excludedGroups}</excludedGroups>
+                </configuration>
             </plugin>
         </plugins>
     </build>

persistence-common/src/test/java/org/tus/common/domain/persistence/integration/QueryServiceMySQLIT.java

@@ -0,0 +1,32 @@
+package org.tus.common.domain.persistence.integration;
+
+import org.junit.jupiter.api.Tag;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.test.context.junit.jupiter.SpringJUnitConfig;
+import org.tus.common.domain.persistence.QueryService;
+import org.tus.common.domain.persistence.integration.config.PersistenceTestContainerMySQLConfig;
+
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+/**
+ * Integration tests that run against MySQL (Testcontainers).
+ * Run with: mvn test -Dgroups=mysql
+ */
+@Tag("mysql")
+@SpringJUnitConfig(classes = PersistenceTestContainerMySQLConfig.class)
+public class QueryServiceMySQLIT {
+
+    @Autowired
+    private QueryService queryService;
+
+    @Test
+    void queryOverMySQL() {
+        String hql = "FROM TestPersistedEntity";
+        List<?> results = queryService.query(hql, Map.of());
+        assertNotNull(results);
+    }
+}

persistence-common/src/test/java/org/tus/common/domain/persistence/integration/config/PersistenceTestContainerMySQLConfig.java

@@ -0,0 +1,65 @@
+package org.tus.common.domain.persistence.integration.config;
+
+import org.hibernate.SessionFactory;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.jdbc.datasource.DriverManagerDataSource;
+import org.springframework.orm.hibernate5.HibernateTransactionManager;
+import org.springframework.orm.hibernate5.LocalSessionFactoryBean;
+import org.springframework.transaction.PlatformTransactionManager;
+import org.springframework.transaction.annotation.EnableTransactionManagement;
+import org.testcontainers.containers.MySQLContainer;
+import org.tus.common.domain.persistence.PersistenceService;
+
+import javax.sql.DataSource;
+import java.util.Properties;
+
+/**
+ * Test configuration for integration tests using MySQL via Testcontainers.
+ * Use this when testing against MySQL-specific behaviour.
+ */
+@Configuration
+@EnableTransactionManagement
+public class PersistenceTestContainerMySQLConfig {
+
+    @Bean(initMethod = "start", destroyMethod = "stop")
+    @SuppressWarnings("resource") // Spring manages container lifecycle via destroyMethod
+    public MySQLContainer<?> mySQLContainer() {
+        return new MySQLContainer<>("mysql:8.0")
+                .withDatabaseName("testdb")
+                .withUsername("test")
+                .withPassword("test");
+    }
+
+    @Bean
+    public DataSource dataSource(MySQLContainer<?> container) {
+        DriverManagerDataSource ds = new DriverManagerDataSource();
+        ds.setDriverClassName(container.getDriverClassName());
+        ds.setUrl(container.getJdbcUrl());
+        ds.setUsername(container.getUsername());
+        ds.setPassword(container.getPassword());
+        return ds;
+    }
+
+    @Bean
+    public LocalSessionFactoryBean sessionFactory(DataSource dataSource) {
+        LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
+        sessionFactory.setDataSource(dataSource);
+        sessionFactory.setPackagesToScan("org.tus.common.domain.persistence.integration.entity");
+        Properties props = new Properties();
+        props.put("hibernate.dialect", "org.hibernate.dialect.MySQLDialect");
+        props.put("hibernate.hbm2ddl.auto", "update");
+        sessionFactory.setHibernateProperties(props);
+        return sessionFactory;
+    }
+
+    @Bean
+    public PersistenceService persistenceService(SessionFactory sessionFactory) {
+        return new PersistenceService(sessionFactory);
+    }
+
+    @Bean
+    public PlatformTransactionManager transactionManager(SessionFactory sessionFactory) {
+        return new HibernateTransactionManager(sessionFactory);
+    }
+}