[RNG-182] Bill of Materials (BOM)

• Type: New Feature
• Status: Closed
• Priority: Minor
• Resolution: Implemented
• Affects Version/s: 1.5
• Fix Version/s: 1.5
• Component/s: bom, client-api, core, sampling, simple
• difficulty-level: Easy
• Assignee: Alex Herbert
• Reporter: Alex Herbert
• Created: 01/Oct/22 07:07
• Updated: 14/Oct/22 13:39
• Resolved: 03/Oct/22 15:21

Description

In 1.5 the multi-module project rearranges a few methods to default interface methods in a different module. This is binary compatible. However it requires that all versions of the modules are matched. If the other modules are explicitly imported by a transitive dependency as a lower version then this will cause a runtime error due to missing methods.
 
I suggest we create a Bill of Materials (BOM) as a separate artifact to be deployed to maven for dependency management. Downstream users can then include this in their POM and all versions of the RNG modules would be matched.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-rng-bom</artifactId>
            <version>1.5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Issue Links

• relates to: RNG-176 Enhance the UniformRandomProvider interface with extra methods and default implementations
• relates to: NUMBERS-190 Bill of Materials (BOM)