Add resource container selector resolver

[mpkorstanje]

Overview

Resolve resource container selectors

As a follow up for #3630 and #3705 this adds a
addResourceContainerSelectorResolver()
method to EngineDiscoveryRequestResolver.Builder analogous to
addClassContainerSelectorResolver().

Points of note:

• As classpath resources can be selected from packages, the package
  filter should also be applied. To make this possible the base path of
  a resource is rewritten to a package name prior to being filtered.

• The ClasspathResourceSelector now has a getClasspathResources
  method. This method will lazily try to load the resources if not
  already provided when discovering resources in a container.

• selectClasspathResource(Set<Resource>) was added to short circuit the
  need to resolve resources twice. And to make it possible to use
  this method as part of the public API,
  ReflectionSupport.tryToLoadResources was also added.

---

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

[mpkorstanje]

We briefly discussed the problem in the team. Do you have a concrete use case that would require solving the problem of having a machine-independent identifier for re-running a test based on a non-unique classpath resource? Otherwise, maybe we can move forward as-is and see if it actually becomes a problem?

Haven't got any concrete examples in mind right now. So that seems reasonable.

[marcphilipp]

Thanks for updating this PR! I'll discuss it with the team and will get back to you.

[marcphilipp]

@mpkorstanje Thanks a lot! Do you have time to try out adopting this in Cucumber from a snapshot?

[mpkorstanje]

Cheers! I've already had a work in progress. But it will need some updates. Shouldn't be too difficult.

cucumber/cucumber-jvm#2835