Code improvements.

Signed-off-by: Franz Wilhelmstötter <franz.wilhelmstoetter@gmail.com>

Author: jenetics

facilejdbc/src/main/java/io/jenetics/facilejdbc/Lifecycle.java

@@ -257,25 +257,25 @@ public static final class Value<T, E extends Exception>
 		implements Supplier<T>, ExtendedCloseable<E>
 	{
 
-		private final T _value;
-		private final ThrowingConsumer<? super T, ? extends E> _release;
+		private final T value;
+		private final ThrowingConsumer<? super T, ? extends E> release;
 
 		private Value(
 			final T value,
 			final ThrowingConsumer<? super T, ? extends E> release
 		) {
-			_value = value;
-			_release = requireNonNull(release);
+			this.value = value;
+			this.release = requireNonNull(release);
 		}
 
 		@Override
 		public T get() {
-			return _value;
+			return value;
 		}
 
 		@Override
 		public void close() throws E {
-			_release.accept(get());
+			release.accept(get());
 		}
 
 		@Override
@@ -430,7 +430,7 @@ public static final class Resources<E extends Exception>
 		implements ExtendedCloseable<E>
 	{
 
-		private final List<ThrowingRunnable<? extends E>> _resources = new ArrayList<>();
+		private final List<ThrowingRunnable<? extends E>> resources = new ArrayList<>();
 
 		/**
 		 * Create a new {@code Resources} object, initialized with the given
@@ -441,7 +441,7 @@ public static final class Resources<E extends Exception>
 		public Resources(
 			final Collection<? extends ThrowingRunnable<? extends E>> releases
 		) {
-			_resources.addAll(releases);
+			resources.addAll(releases);
 		}
 
 		/**
@@ -480,14 +480,14 @@ public <C> C add(
 			requireNonNull(resource);
 			requireNonNull(release);
 
-			_resources.add(() -> release.accept(resource));
+			resources.add(() -> release.accept(resource));
 			return resource;
 		}
 
 		@Override
 		public void close() throws E {
-			if (!_resources.isEmpty()) {
-				ExtendedCloseable.of(_resources).close();
+			if (!resources.isEmpty()) {
+				ExtendedCloseable.of(resources).close();
 			}
 		}
 

facilejdbc/src/main/java/io/jenetics/facilejdbc/Query.java

@@ -50,14 +50,19 @@
 
 /**
  * A {@code Query} represents an executable piece of SQL text.
+ * <p>
+ * <b>Select query</b>
  * {@snippet lang="java":
  * private static final Query SELECT = Query.of("""
  *     SELECT * FROM person
  *     WHERE forename like :forename
  *     ORDER BY surname;
  *     """
  * );
- *
+ * }
+ * <p>
+ * <b>Insert query</b>
+ * {@snippet lang="java":
  * private static final Query INSERT = Query.of("""
  *     INSERT INTO person(forename, surname, birthday, email)
  *     VALUES(:forename, :surname, :birthday, :email);
@@ -613,14 +618,19 @@ public String toString() {
 
 	/**
 	 * Create a new query object from the given SQL string.
+	 * <p>
+	 * <b>Select query</b>
 	 * {@snippet lang="java":
 	 * private static final Query SELECT = Query.of("""
 	 *     SELECT * FROM person
 	 *     WHERE forename like :forename
 	 *     ORDER BY surname;
 	 *     """
 	 * );
-	 *
+	 * }
+	 * <p>
+	 * <b>Insert query</b>
+	 * {@snippet lang="java":
 	 * private static final Query INSERT = Query.of("""
 	 *     INSERT INTO person(forename, surname, birthday, email)
 	 *     VALUES(:forename, :surname, :birthday, :email);

facilejdbc/src/main/java/io/jenetics/facilejdbc/RowParser.java

@@ -358,7 +358,10 @@ default ResultSetParser<Set<T>> unmodifiableSet() {
 	 * While consuming the result {@link Stream}, possible {@link SQLException}s
 	 * are wrapped into {@link UncheckedSQLException}s.
 	 * {@snippet lang="java":
+	 * static final RowParser<Book> PARSER = RowParser.record(Book.class);
 	 * final var select = Query.of("SELECT * FROM book;");
+	 *
+	 * // Query result stream must be used within a try-with-resources block.
 	 * try (var stream = select.as(PARSER.stream(), conn)) {
 	 *     stream.forEach(book -> null); // @replace substring='null' replacement="..."
 	 * }

facilejdbc/src/main/java/io/jenetics/facilejdbc/SingleParam.java

@@ -31,7 +31,7 @@
  * INSERT_QUERY.on(
  *     Param.value("forename", "Werner"),
  *     Param.value("birthday", LocalDate.now()),
- *     Param.value("email", "some.email@gmail.com"))
+ *     Param.value("email", "some.email@gmail.com"));
  * }
  *
  * @author <a href="mailto:franz.wilhelmstoetter@gmail.com">Franz Wilhelmstötter</a>

facilejdbc/src/main/java/io/jenetics/facilejdbc/Stored.java

@@ -19,6 +19,8 @@
  */
 package io.jenetics.facilejdbc;
 
+import static java.util.Objects.requireNonNull;
+
 /**
  * This class combines a record, stored in the DB, with its primary key.
  *
@@ -32,4 +34,7 @@
  * @since 2.1
  */
 public record Stored<K, T>(K id, T value) {
+	public Stored {
+		requireNonNull(id);
+	}
 }

facilejdbc/src/main/java/io/jenetics/facilejdbc/Transaction.java

@@ -51,6 +51,7 @@
  * @version 1.1
  * @since 1.1
  */
+@FunctionalInterface
 public interface Transaction {
 
 	/**