Merge pull request #7 from nmalygin-com/ci-test

improve isolation levels

Author: nmalygin-com

README.md

@@ -66,8 +66,9 @@ List<String> titles = queries
 
 ```java
 List<String> titles = queries
-    .query("SELECT title FROM books WHERE title LIKE ?",
-            new StringArgument("Clean%"))
+    .query("SELECT title FROM books WHERE title = ? OR title = ?",
+            new StringArgument("Clean Code"),
+            new StringArgument("Code Complete"))
     .executeWith(new ColumnToListRsh<>(new StringColumn("title")));
 ```
 
@@ -82,10 +83,9 @@ define the query and then set the parameter values).
 #### Building a query
 
 ```java
-Query titlesQuery = queries.query("SELECT title FROM books ");
-titlesQuery.append("WHERE title LIKE ? ", new StringArgument("Clean%"));
-titlesQuery.append("LIMIT ?", new IntArgument(10));
-List<String> titles = titlesQuery
+List<String> titles = queries.query("SELECT title FROM books ")
+    .append("WHERE title LIKE ? ", new StringArgument("Clean%"))
+    .append("LIMIT ?", new IntArgument(10))
     .executeWith(new ColumnToListRsh<>(new StringColumn("title")));
 ```
 
@@ -177,7 +177,7 @@ try (Transaction transaction = transactions.transaction()) {
 #### Setting the transaction isolation level
 
 ```java
-try (Transaction transaction = transactions.transaction(1)) {
+try (Transaction transaction = transactions.transaction(new ReadCommitted())) {
     // some code
 }
 ```

pom.xml

@@ -29,7 +29,7 @@ SOFTWARE.
 
     <groupId>com.nmalygin</groupId>
     <artifactId>superb-jdbc</artifactId>
-    <version>0.0.5-SNAPSHOT</version>
+    <version>0.0.5</version>
     <packaging>jar</packaging>
 
     <name>Superb JDBC</name>

src/main/java/com/nmalygin/superb/jdbc/api/IsolationLevel.java

@@ -0,0 +1,44 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2025 Nikolai Malygin
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.nmalygin.superb.jdbc.api;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * Represents an isolation level of a transaction.
+ *
+ * @author Nikolai Malygin
+ */
+public interface IsolationLevel {
+
+    /**
+     * Apply the isolation level for the connection.
+     *
+     * @param connection JDBC Connection
+     * @throws SQLException SQLException
+     */
+    void applyTo(Connection connection) throws SQLException;
+}

src/main/java/com/nmalygin/superb/jdbc/api/Transactions.java

@@ -39,15 +39,9 @@ public interface Transactions {
     Transaction transaction() throws SQLException;
 
     /**
-     *
      * @param isolationLevel the transaction isolation level.
-     * Level one of the following {@code Connection} constants:
-     * {@code Connection.TRANSACTION_READ_UNCOMMITTED},
-     * {@code Connection.TRANSACTION_READ_COMMITTED},
-     * {@code Connection.TRANSACTION_REPEATABLE_READ}, or
-     * {@code Connection.TRANSACTION_SERIALIZABLE}.
      * @return New transaction with the isolationLevel
      * @throws SQLException SQLException
      */
-    Transaction transaction(int isolationLevel) throws SQLException;
+    Transaction transaction(IsolationLevel isolationLevel) throws SQLException;
 }

src/main/java/com/nmalygin/superb/jdbc/api/handlers/ColumnToListRsh.java

@@ -37,7 +37,7 @@
  *
  * @author Nikolai Malygin
  */
-public class ColumnToListRsh<T> implements ResultSetHandler<List<T>> {
+public final class ColumnToListRsh<T> implements ResultSetHandler<List<T>> {
 
     private final Column<T> column;
 

src/main/java/com/nmalygin/superb/jdbc/api/handlers/columns/StringColumn.java

@@ -32,7 +32,7 @@
  *
  * @author Nikolai Malygin
  */
-public class StringColumn implements Column<String> {
+public final class StringColumn implements Column<String> {
 
     private final String name;
 

src/main/java/com/nmalygin/superb/jdbc/api/isolation/ReadCommitted.java

@@ -0,0 +1,50 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2025 Nikolai Malygin
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.nmalygin.superb.jdbc.api.isolation;
+
+import com.nmalygin.superb.jdbc.api.IsolationLevel;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * The read committed isolation level
+ *
+ * @author Nikolai Malygin
+ */
+@SuppressWarnings("PMD.AtLeastOneConstructor")
+public final class ReadCommitted implements IsolationLevel {
+
+    /**
+     * Apply the isolation level for the connection.
+     *
+     * @param connection JDBC Connection
+     * @throws SQLException SQLException
+     */
+    @Override
+    public void applyTo(final Connection connection) throws SQLException {
+        connection.setTransactionIsolation(Connection.TRANSACTION_READ_COMMITTED);
+    }
+}

src/main/java/com/nmalygin/superb/jdbc/api/isolation/ReadUncommitted.java

@@ -0,0 +1,50 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2025 Nikolai Malygin
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.nmalygin.superb.jdbc.api.isolation;
+
+import com.nmalygin.superb.jdbc.api.IsolationLevel;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * The read uncommitted isolation level
+ *
+ * @author Nikolai Malygin
+ */
+@SuppressWarnings("PMD.AtLeastOneConstructor")
+public final class ReadUncommitted implements IsolationLevel {
+
+    /**
+     * Apply the isolation level for the connection.
+     *
+     * @param connection JDBC Connection
+     * @throws SQLException SQLException
+     */
+    @Override
+    public void applyTo(final Connection connection) throws SQLException {
+        connection.setTransactionIsolation(Connection.TRANSACTION_READ_UNCOMMITTED);
+    }
+}

src/main/java/com/nmalygin/superb/jdbc/api/isolation/RepeatableRead.java

@@ -0,0 +1,50 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2025 Nikolai Malygin
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.nmalygin.superb.jdbc.api.isolation;
+
+import com.nmalygin.superb.jdbc.api.IsolationLevel;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * The repeatable read isolation level
+ *
+ * @author Nikolai Malygin
+ */
+@SuppressWarnings("PMD.AtLeastOneConstructor")
+public final class RepeatableRead implements IsolationLevel {
+
+    /**
+     * Apply the isolation level for the connection.
+     *
+     * @param connection JDBC Connection
+     * @throws SQLException SQLException
+     */
+    @Override
+    public void applyTo(final Connection connection) throws SQLException {
+        connection.setTransactionIsolation(Connection.TRANSACTION_REPEATABLE_READ);
+    }
+}

src/main/java/com/nmalygin/superb/jdbc/api/isolation/Serializable.java

@@ -0,0 +1,50 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2025 Nikolai Malygin
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.nmalygin.superb.jdbc.api.isolation;
+
+import com.nmalygin.superb.jdbc.api.IsolationLevel;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * The serializable isolation level
+ *
+ * @author Nikolai Malygin
+ */
+@SuppressWarnings("PMD.AtLeastOneConstructor")
+public final class Serializable implements IsolationLevel {
+
+    /**
+     * Apply the isolation level for the connection.
+     *
+     * @param connection JDBC Connection
+     * @throws SQLException SQLException
+     */
+    @Override
+    public void applyTo(final Connection connection) throws SQLException {
+        connection.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE);
+    }
+}