Implement include and exclude filtering when calling registerAutoDetectedExtensions in MutableExtensionRegistry

[YongGoose]

fix #3717

Overview

This PR enables the activation of specific global extensions in JUnit Jupiter.

I've already worked on this in my personal repository, and since there’s a large amount of code changes, I decided to split it into two PRs.

YongGoose@a2ef07f
I plan to proceed in the following two ways.

1. Add an include method to ClassNamePatternFilterUtils.
2. Implement include and exclude filtering when calling registerAutoDetectedExtensions in MutableExtensionRegistry.

---

I hereby agree to the terms of the JUnit Contributor License Agreement.

---

Definition of Done

• There are no TODOs left in the code
• Method preconditions are checked and documented in the method's Javadoc
• Coding conventions (e.g. for logging) have been followed
• Change is covered by automated tests including corner cases, errors, and exception handling
• Public API has Javadoc and @API annotations
• Change is documented in the User Guide and Release Notes

[YongGoose]

@marcphilipp

There are a few points we need to discuss further.

1. When an extension is both included and excluded, exclude takes priority. WDYT?
2. Should the log display the extensions that were either included or excluded?

[marcphilipp]

Suggested change

	return ClassNamePatternFilterUtils.includeMatchingClassNames(include).and(
	ClassNamePatternFilterUtils.excludeMatchingClassNames(exclude));
	return ClassNamePatternFilterUtils.includeMatchingClassNames(include) //
	.and(ClassNamePatternFilterUtils.excludeMatchingClassNames(exclude));

[marcphilipp]

I wonder whether it would be worth creating a Java 9+ variant that avoids instantiating extension that don't pass the filter. We could do this via a new ServiceLoaderUtils class in junit-platform-commons that has a Java 9+ implementation in src/main/java9. The signature should look sth. like

Stream<T> load(
	Class<T> service,
	Predicate<? super Class<? extends T>> providerPredicate,
	ClassLoader loader
);

with the Java 8 implementation being

StreamSupport.stream(ServiceLoader.load(service, loader).spliterator(), false)
	.filter(it -> {
		@SuppressWarnings("unchecked") Class<? extends T> type = (Class<? extends T>) it.getClass();
		return providerPredicate.test(type);
	});

and Java 9+

ServiceLoader.load(service, loader).stream()
	.filter(provider -> providerPredicate.test(provider.type()))
	.map(ServiceLoader.Provider::get);

WDYT?