Complete these tasks to get started with your MicroProfile application.

Getting Started with Helidon MicroProfile

Helidon provides a MicroProfile server implementation (io.helidon.microprofile.server) that encapsulates the Helidon WebServer. You can either instantiate the server directly as is done in the Helidon MP Quickstart example or use its built-in main as shown below.

Maven Coordinates

The Managing Dependencies page describes how you should declare dependency management for Helidon applications. Then declare the following dependency in your project:

Maven Dependency for full MicroProfile
<dependency>
  <groupId>io.helidon.microprofile.bundles</groupId>
  <artifactId>helidon-microprofile</artifactId>
</dependency>

The above dependency adds all the features available in MicroProfile. If you want to start with a smaller core set of features then you can use the core bundle instead. This bundle includes the base feature in MicroProfile (such as JAX-RS, CDI, JSON-P/B, and Config) and leaves out some of the additional features such as Metrics and Tracing. You can add those dependencies individually if you choose.

Maven Dependency for MicroProfile core features only
<dependency>
  <groupId>io.helidon.microprofile.bundles</groupId>
  <artifactId>helidon-microprofile-core</artifactId>
</dependency>

Project files

Create a JAX-RS Resource class with at least one resource method.

Sample JAX-RS Resource Class
@Path("/")
@RequestScoped
public class HelloWorldResource {
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String message() {
        return "Hello World";
    }
}

And create a JAX-RS application.

Sample JAX-RS Application
@ApplicationScoped
@ApplicationPath("/")
public class HelloWorldApplication extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        return Set.of(
                HelloWorldResource.class
        );
    }
}

Add beans.xml in src/main/resources/META-INF so the CDI implementation can pick up your classes.

beans.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans/>

As a last step, add a main method to your application (or a dedicated Main class) to start everything up.

Sample JAX-RS Application
public static void main(String[] args) {
    io.helidon.microprofile.cdi.Main.main(args);
}

Run the main class. The server will start on port 7001 and serve your resources.

Adding Jandex

Jandex is an indexing tool for Weld (the CDI implementation used by Helidon) that helps speed up the boot time of an application.

To use Jandex, configure a Maven plugin that adds the index to your JAR file and a dependency on Jandex.

jandex dependency
<dependency>
    <groupId>io.smallrye</groupId>
    <artifactId>jandex</artifactId>
    <version>{version.plugin.jandex}</version>
</dependency>
jandex plugin configuration
<build>
    <plugins>
        <plugin>
            <groupId>io.smallrye</groupId>
            <artifactId>jandex-maven-plugin</artifactId>
            <version>3.1.2</version>
            <executions>
                <execution>
                    <id>make-index</id>
                    <goals>
                        <goal>jandex</goal>
                    </goals>
                    <phase>process-classes</phase>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>