MicroProfile 5.0-RC1

Spec PDF | Spec HTML

Note that in this release, we are aligning every specification with Jakarta EE 9.1. This effectively creates an incompatible change due to the namespace change from javax to jakarta in the code.

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

• MicroProfile Config 3.0-RC5
• MicroProfile Health 4.0-RC3
• MicroProfile Fault Tolerance 4.0-RC4
• MicroProfile JWT RBAC 2.0-RC2
• MicroProfile Metrics 4.0-RC4
• MicroProfile OpenAPI 3.0-RC3
• MicroProfile OpenTracing 3.0-RC3
• MicroProfile Rest Client 3.0-RC3

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

<dependency>
    <groupId>org.eclipse.microprofile</groupId>
    <artifactId>microprofile</artifactId>
    <version>5.0-RC1</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>5.0-RC1</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>

MicroProfile 4.1

Spec PDF | Spec HTML

In this release, the requirement that CCR's need to be certified with Java SE 8 has been lifted to include any version above Java SE 8.

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

• MicroProfile Health 3.1

To get started with MicroProfile 4.1, 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.1</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.1</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>

MicroProfile 4.1-RC2

Spec PDF | Spec HTML

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

• MicroProfile Health 3.1

To get started with MicroProfile 4.1, 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.1-RC2</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.1-RC2</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>

MicroProfile 4.1-RC1

Spec PDF | Spec HTML

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

• MicroProfile Health 3.1

To get started with MicroProfile 4.1, 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.1-RC1</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.1-RC1</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>

MicroProfile 4.0.1

Spec PDF | Spec HTML

This maintenance release fixes the ability to use the single MicroProfile 4.0.1 dependency as shown below, without having to explicitly declare the separate specification dependencies ala BOM style.

To get started with MicroProfile 4.0.1, 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.1</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.1</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>

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.

MicroProfile 4.0-RC1

Spec PDF | Spec HTML

The Eclipse MicroProfile 4.0-RC1 release is now available! MicroProfile 4.0-RC1 is based on Jakarta EE 8, the first MicroProfile release to be based on Jakarta EE (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-RC1
• MicroProfile Fault Tolerance 3.0-RC2
• MicroProfile Health 3.0-RC5
• MicroProfile JWT Authentication 1.2-RC1
• MicroProfile Metrics 3.0-RC2
• MicroProfile OpenAPI 2.0-RC3
• MicroProfile OpenTracing 2.0-RC2
• MicroProfile Rest Client 2.0-RC2

MicroProfile 4.0-RC1 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-RC1, 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-RC1</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-RC1</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.

MicroProfile 4.0-M1

Spec PDF | Spec HTML

The Eclipse MicroProfile 4.0-M1 release is now available! MicroProfile 4.0-M1 is based on Jakarta EE 8, the first MicroProfile release to be based on Jakarta EE (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 an major release that includes the following updates:

• MicroProfile Config 2.0-M1
• MicroProfile Fault Tolerance 3.0-RC1
• MicroProfile Health 3.0-RC3
• MicroProfile JWT Authentication 1.2-RC1
• MicroProfile Metrics 3.0-RC1
• MicroProfile OpenAPI 2.0-RC2
• MicroProfile OpenTracing 2.0-RC1
• MicroProfile Rest Client 2.0-RC2

MicroProfile 4.0-M1 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-M1, 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-M1</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-M1</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.

MicroProfile 3.3

Spec PDF | Spec HTML

The Eclipse MicroProfile 3.3 release is now available! Based on MicroProfile's time-boxed release process, this is an incremental release that includes an update to MicroProfile Config 1.4, MicroProfile Fault Tolerance 2.1, MicroProfile Health 2.2, MicroProfile Metrics 2.3, and MicroProfile Rest Client 1.4.

Read the specification document here: MicroProfile 3.3 Specification

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

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

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

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

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

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

MicroProfile 3.3-RC2

Spec PDF | Spec HTML

The Eclipse MicroProfile 3.3-RC2 release is now available! Based on MicroProfile's time-boxed release process, this is an incremental release that includes an update to MicroProfile Config 1.4, MicroProfile Fault Tolerance 2.1, MicroProfile Health 2.2, MicroProfile Metrics 2.3, and MicroProfile Rest Client 1.4.

Read the specification document here: MicroProfile 3.3-RC2 Specification

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

<dependency>
    <groupId>org.eclipse.microprofile</groupId>
    <artifactId>microprofile</artifactId>
    <version>3.3-RC2</version>
    <type>pom</type>
    <scope>provided</scope>
</dependency>

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

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

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

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