test: avoid concurrent executions of tests that update environment and system properties

JUnit's @isolated is helpful to run certain tests in isolation.

Author: vlsi

packaging/rpm/postgresql-jdbc.spec.tpl

@@ -112,6 +112,7 @@ find -type f \( -name "*.jar" -or -name "*.class" \) | xargs rm -f
 rm src/test/java/org/postgresql/test/jdbc2/DriverTest.java \
    src/test/java/org/postgresql/util/OSUtilTest.java \
    src/test/java/org/postgresql/util/PGPropertyPasswordParserTest.java \
+   src/test/java/org/postgresql/util/StubEnvironmentAndProperties.java \
    src/test/java/org/postgresql/util/PGPropertyServiceParserTest.java
 
 # compat symlink: requested by dtardon (libreoffice), reverts part of

pgjdbc/src/test/java/org/postgresql/test/jdbc2/DriverTest.java

@@ -17,12 +17,11 @@
 import org.postgresql.PGEnvironment;
 import org.postgresql.PGProperty;
 import org.postgresql.test.TestUtil;
+import org.postgresql.util.StubEnvironmentAndProperties;
 import org.postgresql.util.URLCoder;
 
 import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.extension.ExtendWith;
 import uk.org.webcompere.systemstubs.environment.EnvironmentVariables;
-import uk.org.webcompere.systemstubs.jupiter.SystemStubsExtension;
 import uk.org.webcompere.systemstubs.properties.SystemProperties;
 import uk.org.webcompere.systemstubs.resource.Resources;
 
@@ -43,7 +42,7 @@
  * Tests the dynamically created class org.postgresql.Driver
  *
  */
-@ExtendWith(SystemStubsExtension.class)
+@StubEnvironmentAndProperties
 public class DriverTest {
 
   @Test

pgjdbc/src/test/java/org/postgresql/util/OSUtilTest.java

@@ -8,15 +8,13 @@
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.extension.ExtendWith;
 import uk.org.webcompere.systemstubs.environment.EnvironmentVariables;
-import uk.org.webcompere.systemstubs.jupiter.SystemStubsExtension;
 import uk.org.webcompere.systemstubs.properties.SystemProperties;
 import uk.org.webcompere.systemstubs.resource.Resources;
 
 import java.io.File;
 
-@ExtendWith(SystemStubsExtension.class)
+@StubEnvironmentAndProperties
 class OSUtilTest {
 
   @Test

pgjdbc/src/test/java/org/postgresql/util/PGPropertyPasswordParserTest.java

@@ -26,6 +26,7 @@
  *
  * @author Marek Läll
  */
+@StubEnvironmentAndProperties
 class PGPropertyPasswordParserTest {
 
   // "org.postgresql.pgpassfile" : missing

pgjdbc/src/test/java/org/postgresql/util/PGPropertyServiceParserTest.java

@@ -13,9 +13,7 @@
 import org.postgresql.PGEnvironment;
 
 import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.extension.ExtendWith;
 import uk.org.webcompere.systemstubs.environment.EnvironmentVariables;
-import uk.org.webcompere.systemstubs.jupiter.SystemStubsExtension;
 import uk.org.webcompere.systemstubs.properties.SystemProperties;
 import uk.org.webcompere.systemstubs.resource.Resources;
 
@@ -30,7 +28,7 @@
  *
  * @author Marek Läll
  */
-@ExtendWith(SystemStubsExtension.class)
+@StubEnvironmentAndProperties
 class PGPropertyServiceParserTest {
 
   // "org.postgresql.pgservicefile" : missing

pgjdbc/src/test/java/org/postgresql/util/StubEnvironmentAndProperties.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2022, PostgreSQL Global Development Group
+ * See the LICENSE file in the project root for more information.
+ */
+
+package org.postgresql.util;
+
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.junit.jupiter.api.parallel.Isolated;
+import uk.org.webcompere.systemstubs.jupiter.SystemStubsExtension;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is used to mark a test method as a test that should be run with stubbing system
+ * calls like {@code System#getProperty} and {@code System#getenv}.
+ * <p>The tests should be run in isolation to prevent concurrent modification of properties and
+ * the environment.</p>
+ */
+@Isolated
+@ExtendWith(SystemStubsExtension.class)
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD, ElementType.TYPE})
+public @interface StubEnvironmentAndProperties {
+}