MicroProfile 4.0

Spec PDF | Spec HTML

The Eclipse MicroProfile 4.0 release is now available! MicroProfile 4.0 is the first release under the MicroProfile Working Group and is based on Jakarta EE 8 using the associated javax.* namespace (replacing the role of Java EE). Although Jakarta EE 8 is API backward compatible with Java EE 8, Jakarta EE replaces Java EE dependencies with Jakarta EE dependencies for all MicroProfile specifications.

Based on MicroProfile's time-boxed release process, this is a major release that includes the following updates:

• MicroProfile Config 2.0
• MicroProfile Fault Tolerance 3.0
• MicroProfile Health 3.0
• MicroProfile JWT Authentication 1.2
• MicroProfile Metrics 3.0
• MicroProfile OpenAPI 2.0
• MicroProfile OpenTracing 2.0
• MicroProfile Rest Client 2.0

MicroProfile 4.0 also utilizes the following specifications:

• Jakarta Contexts and Dependency Injection 2.0
• Jakarta Annotations 1.3
• Jakarta RESTful Web Services 2.1
• Jakarta JSON Binding 1.0
• Jakarta JSON Processing 1.1

To get started with MicroProfile 4.0, add the following dependency to your pom.xml to get the complete MicroProfile stack:

<dependency>
    <groupId>org.eclipse.microprofile</groupId>
    <artifactId>microprofile</artifactId>
    <version>4.0</version>
    <type>pom</type>
    <scope>provided</scope>
</dependency>

Or, to import the transitive dependencies for selective use (ala BOM), add the following (using relevant dependencies) to your pom.xml:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.eclipse.microprofile</groupId>
            <artifactId>microprofile</artifactId>
            <version>4.0</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.eclipse.microprofile.health</groupId>
        <artifactId>microprofile-health-api</artifactId>
        <scope>provided</scope>
    </dependency>

    <dependency>
        <groupId>org.eclipse.microprofile.metrics</groupId>
        <artifactId>microprofile-metrics-api</artifactId>
        <scope>provided</scope>
    </dependency>

    <dependency>
        <groupId>jakarta.ws.rs</groupId>
        <artifactId>jakarta.ws.rs-api</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

NOTE: Older releases of MicroProfile (1.3 and before) are located in the microprofile-bom repository.