--- title: How to Build Microservices with Helidon description: Your practical guide to Helidon, Oracle's new open source framework for microservices-based applications. image: https://blog.avenuecode.com/hubfs/joel-filipe-ZMRMFULofus-unsplash.jpg --- [AvenueCode.com](https://avenuecode.com) [News](https://avenuecode.com/news) [Contact](https://avenuecode.com/contact) [![Avenue Code Snippets Logo](https://blog.avenuecode.com/hubfs/Avenue%20Code%20New%20Logos%20-%202023/AC-Snippets---Black.png)](https://blog.avenuecode.com/?hsLang=en-us) *menu* - Technology [Cloud](https://blog.avenuecode.com/blog/topic/cloud?hsLang=en-us) [Delivery Infrastructure](https://blog.avenuecode.com/blog/topic/delivery-infrastructure?hsLang=en-us) [Web Experience](https://blog.avenuecode.com/blog/topic/web-experience?hsLang=en-us) [Agile Mindset](https://blog.avenuecode.com/blog/topic/agile-mindset?hsLang=en-us) [Quality First](https://blog.avenuecode.com/blog/topic/quality-first?hsLang=en-us) [Design](https://blog.avenuecode.com/blog/topic/design?hsLang=en-us) [Solution Architecture](https://blog.avenuecode.com/blog/topic/solution-architecture?hsLang=en-us) [Data & ML](https://blog.avenuecode.com/blog/topic/data-and-machine-learning?hsLang=en-us) [Mobile Experience](https://blog.avenuecode.com/blog/topic/mobile-experience?hsLang=en-us) - [Whitepapers](https://blog.avenuecode.com/blog/topic/whitepapers?hsLang=en-us) - [Spotlight](https://blog.avenuecode.com/blog/topic/spotlight?hsLang=en-us) - [Extraordinary Women in Tech](https://blog.avenuecode.com/blog/topic/extraordinary-women-in-tech?hsLang=en-us) - [Avenue Code Culture](https://blog.avenuecode.com/blog/topic/avenue-code-culture?hsLang=en-us) - [Cloud](https://blog.avenuecode.com/blog/topic/cloud?hsLang=en-us) - [Design](https://blog.avenuecode.com/blog/topic/design?hsLang=en-us) - [Delivery Infrastructure](https://blog.avenuecode.com/blog/topic/delivery-infrastructure?hsLang=en-us) - [Solution Architecture](https://blog.avenuecode.com/blog/topic/solution-architecture?hsLang=en-us) - [Web Experience](https://blog.avenuecode.com/blog/topic/web-experience?hsLang=en-us) - [Data & ML](https://blog.avenuecode.com/blog/topic/data-and-machine-learning?hsLang=en-us) - [Agile Mindset](https://blog.avenuecode.com/blog/topic/agile-mindset?hsLang=en-us) - [Mobile Experience](https://blog.avenuecode.com/blog/topic/mobile-experience?hsLang=en-us) - [Quality First](https://blog.avenuecode.com/blog/topic/quality-first?hsLang=en-us) - [Whitepapers](https://blog.avenuecode.com/blog/topic/whitepapers?hsLang=en-us) - [Spotlight](https://blog.avenuecode.com/blog/topic/spotlight?hsLang=en-us) - [Extraordinary Women in Tech](https://blog.avenuecode.com/blog/topic/extraordinary-women-in-tech?hsLang=en-us) - [Avenue Code Culture](https://blog.avenuecode.com/blog/topic/avenue-code-culture?hsLang=en-us) # [How to Build Microservices with Helidon](https://blog.avenuecode.com/how-to-build-microservices-with-helidon) - [Tweet](https://twitter.com/share) *perm\_identity* [Pankaj Bharambe](https://blog.avenuecode.com/how-to-build-microservices-with-helidon/author/pankaj-bharambe?hsLang=en-us) *schedule* 4/14/21 2:00 PM This is your practical guide to Oracle's new open source framework, [Project Helidon](https://helidon.io/#/), a collection of Java libraries designed for creating microservices-based applications. Originally named J4C (Java for Cloud), Helidon was designed to be simple and fast. It has two versions: **Helidon SE** and **Helidon MP**.  Helidon SE features three core APIs to create a microservice -- a web server, configuration, and security -- for building microservices-based applications. An application server is not required.  Helidon MP supports the MicroProfile 1.1 specification for building microservices-based applications. In this snippet, we will mostly concentrate on Helidon SE. ##### Prerequisites Helidon requires Java 11 (or newer) and Maven. ##### Web Server Helidon has a small, functional style API that is reactive, simple, and transparent; an application server is not required. A Helidon microservice is a Java SE application that starts a tinny HTTP server from the main method. To start webServer API, we need to add the required Maven Dependency to the pom.xml ```         io.helidon.webserver        helidon-webserver ``` Inspired by NodeJS and other Java frameworks, Helidon's web server component is an asynchronous and reactive API that runs on top of Netty. The WebServer interface provides basic server lifecycle and monitoring enhanced by configuration, routing, error handling, and building metrics and health endpoints. See the startServer() method below:  ``` private static void startServer() {Config config = Config.create();     WebServer server = WebServer.builder(createRouting(config))                             .addMediaSupport(JsonpSupport.create())                 .build();server.start()         .thenAccept(ws -> {  System.out.println("WEB server is up! http://localhost:" + ws.port() + "/greet");                    ws.whenShutdown().thenRun(()-> System.out.println("WEB server is DOWN. Good bye!"));          })          .exceptionally(t -> {System.err.println("Startup failed: " + t.getMessage());                    t.printStackTrace(System.err);                    return null;          });return server; }private static Routing createRouting(Config config) {        MetricsSupport metrics = MetricsSupport.create();        GreetService greetService = new GreetService(config);        HealthSupport health = HealthSupport.builder()                .addLiveness(HealthChecks.healthChecks())                   .build();        return Routing.builder()                .register(health)                                   .register(metrics)                                  .register("/greet", greetService)                .build();    } ``` First, we need to build an instance of the Routing interface that serves as an HTTP request-response handler with routing rules: see createRouting() . In this example, in createRouting() we have registered Metric, Health, and context path /greet. We use GreetService to greet the user. The information below is from GreetService.java: ``` @Overridepublic void update(Routing.Rules rules) {        rules            .get("/", this::getDefaultMessageHandler)            .get("/{name}", this::getMessageHandler)            .put("/greeting", this::updateGreetingHandler);} ``` After building the Routing Interface, we need to start the server. Helidon provides a functional interface for start and shutdown methods for servers.  Let’s build and run our server application with Maven: ``` $ mvn package ``` The command above will help build the application, and you'll be able to see the logs below on your terminal. ``` [INFO] Scanning for projects...[INFO]----------------------------------------------------------[INFO] Detecting the operating system and CPU architecture[INFO]----------------------------------------------------------[INFO] os.detected.name: osx[INFO] os.detected.arch: x86_64[INFO] os.detected.version: 10.15[INFO] os.detected.version.major: 10[INFO] os.detected.version.minor: 15[INFO] os.detected.classifier: osx-x86_64............................................. ``` After a Successful Build, run the server by invoking jar: ``` $ java -jar target/avenuecode-helidon-se.jar ``` When the server starts, you should see the following in your terminal window: ``` 2020.12.29 12:12:02 INFO io.helidon.common.LogConfig Thread[main,5,main]: Logging at initialization configured using classpath: /logging.properties2020.12.29 12:12:02 INFO io.helidon.common.HelidonFeatures Thread[features-thread,5,main]: Helidon SE 2.2.0 features: [Config, Health, Metrics, WebServer]2020.12.29 12:12:07 INFO io.helidon.webserver.NettyWebServer Thread[nioEventLoopGroup-2-1,10,main]: Channel '@default' started: [id: 0x59794fb8, L:/0:0:0:0:0:0:0:0:65015]WEB server is up! http://localhost:65015/greet ``` You can see the server is started on 65015, one of the available random ports. Run the curl:  ``` $ curl -X GET http://localhost:65015/greet/AvenuCode  ``` You should see: ``` {"message":"Hello AvenuCode!"} ``` ##### Configuration Component The configuration component, Config, loads and processes configuration properties in key/value format. By default, configuration properties will be read from a defined application.properties or application.yaml file placed in the /src/main/resources directory. The following code example demonstrates how to use Config and builds upon the previous example by reading an applications.yaml file to specify a port on which to start the web server. ``` app:  greeting: "Hello"server:  port: 8080  host: 0.0.0.0 ``` The greeting subnode defines the server response that we hard-coded in the previous example. The port subnode defines port 8080 for the web server to use upon startup. Let’s update our startServer() method to take advantage of the configuration we just defined: ``` private static void startServer() {Config config = Config.create();     WebServer server = WebServer.builder(createRouting(config)).config(config.get("server"))                             .addMediaSupport(JsonpSupport.create())                 .build();server.start()         .thenAccept(ws -> {  System.out.println("WEB server is up! http://localhost:" + ws.port() + "/greet");                    ws.whenShutdown().thenRun(()-> System.out.println("WEB server is DOWN. Good bye!"));          })          .exceptionally(t -> {System.err.println("Startup failed: " + t.getMessage());                    t.printStackTrace(System.err);                    return null;          });return server; } ``` First, we need to build an instance of the Config interface by invoking its create() method to read our configuration file. The get(String key) method, provided by Config, returns a node, or a specific subnode, from the configuration file specified by key. For example, config.get("server") will return the content under the server node. Next, we create an instance of[ServerConfiguration](https://helidon.io/docs/latest/apidocs/io/helidon/webserver/ServerConfiguration.html), providing immutable web server information. This is possible when we invoke its create() method by passing in the statement, config.get("server").  The web server is created as in the previous example, except we use a config() method that accepts the config instance. We can now build and run this version of our web server application using the same Maven and Java commands. Execute the same curl command: ``` $ curl -X GET http://localhost:8080/greet/AvenuCode  ``` You should see: ``` {"message":"Hello AvenuCode!"} ``` ##### Security The **Security** class provides support for authentication, authorization, and auditing. A number of security providers for use in Helidon applications have been implemented. There are three ways security may be built into a Helidon application: from a builder; by configuration; or a hybrid of the first two. The following code example demonstrates how to build an instance of **Security**, use **Config** to obtain user authentication (with encrypted password) and display the server time. ``` // application.yamlhttp-basic-auth: users:   login: "avenuecode"   password: "${CLEAR=somePassword}"   roles: ["user","admin"]Config config = Config.create();Security security = Security.builder()       .config(config)       .addProvider(...)       .build();String user = config.get("http-basic-auth.users.login").asString();String password = config.get("http-basic-auth.users.password").asString();System.out.println("\n");System.out.println("INFO: user = " + user);System.out.println("INFO: password = " + password); ``` ##### Health and Metrics Helidon provides built-in support for health and metrics endpoints. Health:  ``` curl -s -X GET http://localhost:8080/health ``` Metrics in Prometheus Format :  ``` curl -s -X GET http://localhost:8080/metrics ``` Metrics in JSON Format :  ``` curl -H 'Accept:application/json' -X GET http://localhost:8080/metrics  ``` ##### Getting Started Helidon provides[quick start examples](https://helidon.io/docs/latest/#/getting-started/02_base-example) to demonstrate the differences between Helidon SE and Helidon MP. The following Maven and Java commands will generate and package the Helidon SE example to create a REST service using Helidon's web server. ``` mvn -U archetype:generate -DinteractiveMode=false \    -DarchetypeGroupId=io.helidon.archetypes \    -DarchetypeArtifactId=helidon-quickstart-se \    -DarchetypeVersion=2.2.0 \    -DgroupId=com.avenuecode.snippet \    -DartifactId=avenuecode-helidon-se \    -Dpackage=com.avenuecode.snippet.quickstart$ mvn package$ java -jar target/quickstart-se.jar ``` ##### Conclusion In today's Snippet, we provided an introduction to Helidon, the new Java microservice framework that Oracle recently open sourced. Helidon is lightweight, simple, and fast, and more and more developers are excited about its capabilities. How have you used Helidon for your projects? Tell us in the comments below!   ##### Quick Links for Reference [Project Helidon](https://helidon.io/#/) [Helidon Javadocs](https://helidon.io/docs/latest/apidocs/index.html?overview-summary.html)  [Maven](https://maven.apache.org/download.cgi)  [Java 11](https://www.oracle.com/java/technologies/javase-downloads.html)  --- ### Author # Pankaj Bharambe Pankaj Bharambe is a Senior Software Engineer at Avenue Code. He loves learning new technologies and automating functionalities to reduce effort. He also likes exploring core concepts and web technology. In his free time, Pankaj enjoys reading books, hiking, and playing cricket. --- ### Related Posts ### SAGA Pattern for Microservices Architecture [READ MORE](https://blog.avenuecode.com/saga-pattern-for-microservices-architecture?hsLang=en-us) ### How to Use WireMock for Integration Testing [READ MORE](https://blog.avenuecode.com/how-to-use-wiremock-for-integration-testing?hsLang=en-us) ### How to Dockerize Your Spring Boot Application [READ MORE](https://blog.avenuecode.com/how-to-dockerize-your-spring-boot-application?hsLang=en-us) ### How to Save Time and Effort Using The Test Pyramid [READ MORE](https://blog.avenuecode.com/how-to-save-time-and-effort-using-the-test-pyramid?hsLang=en-us) ### Leave a Comment! ### Avenue Code Social [![Facebook Icon](https://blog.avenuecode.com/hubfs/Images/Blog/facebook.png?t=1486470796564)](https://www.facebook.com/avenuecode) [![Twitter Icon](https://blog.avenuecode.com/hubfs/Images/Blog/twitter.png?t=1486470796842)](https://twitter.com/AvenueCode) [![LinkedIn Icon](https://blog.avenuecode.com/hubfs/Images/Blog/linkedin.png?t=1486470796556)](https://www.linkedin.com/company/avenuecode/) ### Newsletter Want to stay on top of all tips and news from Avenue Code? ### Popular Snippets ![Avenue Code-primary versions_logo white avenue code endorsement 2](https://blog.avenuecode.com/hs-fs/hubfs/Avenue%20Code%20New%20Logos%20-%202023/Avenue%20Code-primary%20versions_logo%20white%20avenue%20code%20endorsement%202.png?width=1180&name=Avenue%20Code-primary%20versions_logo%20white%20avenue%20code%20endorsement%202.png "Avenue Code-primary versions_logo white avenue code endorsement 2") ### About Us - [Who We Are](https://www.avenuecode.com/who-we-are) - [What We Do](https://www.avenuecode.com/what-we-do) - [Portfolio](https://www.avenuecode.com/portfolio) - [Partners](https://www.avenuecode.com/partners) - [News](https://www.avenuecode.com/news) - [Events](https://www.avenuecode.com/events) - [Blog](https://blog.avenuecode.com/) - [Contact](https://www.avenuecode.com/contact) ### Our Offices San Francisco [+1 415 766 4178](tel:+553125161448) [ac.inquiries@avenuecode.com](mailto:brazil.info@avenuecode.com) Belo Horizonte [+55 31 2516 1448](tel:+553125161448) [brazil.info@avenuecode.com](mailto:brazil.info@avenuecode.com) São Paulo [+55 11 3205 3232](tel:+553125161448) [brazil.info@avenuecode.com](mailto:brazil.info@avenuecode.com) ### We're Hiring! - [Belo Horizonte](https://www.avenuecode.com/who-we-are) - [New York](https://www.avenuecode.com/what-we-do) - [San Francisco](https://www.avenuecode.com/portfolio) - [São Paulo](https://www.avenuecode.com/partners) --- ©2015 - 2017 Avenue Code [![Facebook Icon](https://blog.avenuecode.com/hubfs/Images/Icons/facebook-2.png)](https://www.facebook.com/avenuecode) [![Twitter Icon](https://blog.avenuecode.com/hubfs/Images/Icons/twitter-2.png)](https://twitter.com/AvenueCode) [![LinkedIn Icon](https://blog.avenuecode.com/hubfs/Images/Icons/linkedin-2.png)](https://www.linkedin.com/company/avenue-code) [![Glassdoor Icon](https://blog.avenuecode.com/hubfs/Images/Icons/glassdoor-icon-1.png)](https://www.glassdoor.com/Overview/Working-at-Avenue-Code-EI_IE456173.11,22.htm) [![YouTube Icon](https://blog.avenuecode.com/hubfs/Images/Icons/youtube-2.png)](https://www.youtube.com/user/AvenueCodePlay) Please enable JavaScript to view the [comments powered by Disqus.](http://disqus.com/?ref_noscript) © 2026 Avenue Code ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "Pankaj Bharambe", "url" : "https://blog.avenuecode.com/author/pankaj-bharambe" }, "dateModified" : "2021-04-14T17:00:00.528Z", "datePublished" : "2021-04-14T17:00:00.000Z", "headline" : "How to Build Microservices with Helidon", "image" : [ "https://blog.avenuecode.com/hubfs/joel-filipe-ZMRMFULofus-unsplash.jpg" ], "mainEntityOfPage" : { "@id" : "https://blog.avenuecode.com/how-to-build-microservices-with-helidon", "@type" : "WebPage" }, "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://blog.avenuecode.com/hubfs/Avenue%20Code%20New%20Logos%20-%202023/Avenue%20Code-primary%20versions_LOGO%20HORIZONTAL%20group%201-7.png" }, "name" : "Avenue Code" } } ```