GH-624 - Expose factory method to create a (SpringBoot)ApplicationRuntime.

We now expose ApplicationRuntime.of(ApplicationContext) to create a SpringBootApplicationRuntime as that's needed a lot in integration tests for runtime and observability components.

Author: odrotbohm

spring-modulith-runtime/src/main/java/org/springframework/modulith/runtime/ApplicationRuntime.java

@@ -15,6 +15,9 @@
  */
 package org.springframework.modulith.runtime;
 
+import org.springframework.context.ApplicationContext;
+import org.springframework.util.Assert;
+
 /**
  * Abstraction of the application runtime environment. Primarily to keep references to Spring Boot out of the core
  * observability implementation.
@@ -23,6 +26,19 @@
  */
 public interface ApplicationRuntime {
 
+	/**
+	 * Creates a new {@link ApplicationRuntime} for the given {@link ApplicationContext}.
+	 *
+	 * @param context must not be {@literal null}.
+	 * @return will never be {@literal null}.
+	 */
+	public static ApplicationRuntime of(ApplicationContext context) {
+
+		Assert.notNull(context, "ApplicationContext must not be null!");
+
+		return new SpringBootApplicationRuntime(context);
+	}
+
 	/**
 	 * Returns the identifier of the application.
 	 *

spring-modulith-runtime/src/main/java/org/springframework/modulith/runtime/autoconfigure/SpringBootApplicationRuntime.java renamed to spring-modulith-runtime/src/main/java/org/springframework/modulith/runtime/SpringBootApplicationRuntime.java

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.springframework.modulith.runtime.autoconfigure;
+package org.springframework.modulith.runtime;
 
 import java.util.Arrays;
 import java.util.List;
@@ -23,7 +23,6 @@
 import org.springframework.boot.autoconfigure.AutoConfigurationPackages;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.context.ApplicationContext;
-import org.springframework.modulith.runtime.ApplicationRuntime;
 import org.springframework.util.Assert;
 import org.springframework.util.ClassUtils;
 

spring-modulith-runtime/src/main/java/org/springframework/modulith/runtime/autoconfigure/SpringModulithRuntimeAutoConfiguration.java

@@ -41,7 +41,7 @@
 import org.springframework.util.function.ThrowingSupplier;
 
 /**
- * Auto-configuration to register a {@link SpringBootApplicationRuntime}, a {@link ApplicationModulesRuntime} and an
+ * Auto-configuration to register an {@link ApplicationRuntime}, a {@link ApplicationModulesRuntime} and an
  * {@link ApplicationListener} to invoke all {@link ApplicationModuleInitializer}s as Spring Bean.
  *
  * @author Oliver Drotbohm
@@ -55,8 +55,8 @@ class SpringModulithRuntimeAutoConfiguration {
 	@Bean
 	@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
 	@ConditionalOnMissingBean(ApplicationRuntime.class)
-	static SpringBootApplicationRuntime modulithsApplicationRuntime(ApplicationContext context) {
-		return new SpringBootApplicationRuntime(context);
+	static ApplicationRuntime modulithsApplicationRuntime(ApplicationContext context) {
+		return ApplicationRuntime.of(context);
 	}
 
 	@Bean

spring-modulith-runtime/src/test/java/org/springframework/modulith/runtime/ApplicationModulesRuntimeIntegrationTests.java

@@ -27,7 +27,6 @@
 import org.junit.jupiter.api.Test;
 import org.springframework.boot.SpringApplication;
 import org.springframework.modulith.core.ApplicationModules;
-import org.springframework.modulith.runtime.autoconfigure.TestSpringBootApplicationRuntime;
 import org.springframework.modulith.test.TestApplicationModules;
 
 /**
@@ -43,7 +42,7 @@ public class ApplicationModulesRuntimeIntegrationTests {
 	void detectsTypeInAdditionalPackageAsApplicationType() {
 
 		var context = SpringApplication.run(SampleApplication.class);
-		var applicationRuntime = new TestSpringBootApplicationRuntime(context);
+		var applicationRuntime = ApplicationRuntime.of(context);
 
 		var runtime = new ApplicationModulesRuntime(() -> modules, applicationRuntime);
 
@@ -55,7 +54,7 @@ void detectsTypeInAdditionalPackageAsApplicationType() {
 	void onlyLooksUpApplicationModulesOnce() {
 
 		var context = SpringApplication.run(SampleApplication.class);
-		var applicationRuntime = new TestSpringBootApplicationRuntime(context);
+		var applicationRuntime = ApplicationRuntime.of(context);
 		var supplier = new CountingSupplier<>(() -> modules);
 
 		var runtime = new ApplicationModulesRuntime(supplier, applicationRuntime);

spring-modulith-runtime/src/test/java/org/springframework/modulith/runtime/autoconfigure/SpringBootApplicationRuntimeUnitTests.java renamed to spring-modulith-runtime/src/test/java/org/springframework/modulith/runtime/SpringBootApplicationRuntimeUnitTests.java

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.springframework.modulith.runtime.autoconfigure;
+package org.springframework.modulith.runtime;
 
 import static org.assertj.core.api.Assertions.*;
 
@@ -24,6 +24,7 @@
 import org.springframework.aop.framework.ProxyFactory;
 import org.springframework.context.ApplicationContext;
 import org.springframework.modulith.runtime.ApplicationRuntime;
+import org.springframework.modulith.runtime.SpringBootApplicationRuntime;
 
 /**
  * Unit tests for {@link SpringBootApplicationRuntime}.