Microsphere BOM

Microsphere Projects for Bill of Materials (BOM)

Introduction

The Microsphere BOM project provides a centralized Bill of Materials (BOM) of third-party libraries for the Microsphere ecosystem. Its primary purpose is to manage and harmonize dependency versions across multiple projects, ensuring compatibility and reducing configuration overhead for developers.

By importing this BOM, downstream projects can declare dependencies without specifying version numbers, relying instead on the curated set of versions maintained within this repository. This project is built upon the microsphere-build parent project

Language Support

Microsphere Build supports the Maven project building on Java TLS versions:

• 8
• 11
• 17
• 21
• 25

Modules

Module	Purpose
microsphere-bomdb-bom	Manages versions for Java Databases (SQLite, H2, etc.).
microsphere-bomee-bom	Manages versions for Java EE API (Servlet, JAX-RS, EJB, etc.).
microsphere-testing-bom	Manages versions for testing utilities (JUnit, Mockito, Hamcrest, etc.).
microsphere-tomcat-bom	Manages versions for Tomcat libraries (Servlet container).
microsphere-all-bom	An aggregator BOM that imports both logging, testing and other BOMs.
microsphere-bom-example	A validation module used to verify the BOM integrity.

Getting Started

The easiest way to get started is by adding the Microsphere BOM (Bill of Materials) to your project's pom.xml:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.github.microsphere-projects</groupId>
            <artifactId>microsphere-all-bom</artifactId>
            <version>${microsphere-bom.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Building from Source

You don't need to build from source unless you want to try out the latest code or contribute to the project.

To build the project, follow these steps:

1. Clone the repository:

git clone https://github.com/microsphere-projects/microsphere-bom.git

2. Build the source:

• Linux/MacOS:

./mvnw package

• Windows:

mvnw.cmd package

Contributing

We welcome your contributions! Please read Code of Conduct before submitting a pull request.

Reporting Issues

• Before you log a bug, please search the issues to see if someone has already reported the problem.
• If the issue doesn't already exist, create a new issue.
• Please provide as much information as possible with the issue report.

Documentation

User Guide

DeepWiki Host

ZRead Host

License

The Microsphere Java is released under the Apache License 2.0.