Skip to content

Latest commit

 

History

History
49 lines (29 loc) · 4.5 KB

File metadata and controls

49 lines (29 loc) · 4.5 KB

Cloud native development with Helidon - stock manager

License: UPL Quality gate

Introduction

This repo holds the source code to the "Stockmanager" microservices in it's "finished" form.

The Storefront micro service is an example microservice that is used in a number of Oracle labs to show how to use Helidon to create a microservcies with business logic (admitedly very simple in this case) and to receive message from another microservice (The "Storefront")

Getting Started

This is a "finished" version of the Stockmanager microservice. As a "finished" version of the code this is what someone who has completed the lab would expect to have created (approximately).

Due to the way Eclipse operates the project itself is in the helidon-stockmanager-full directory

This code is being provided here for several reasons: 1/ As refrence for people who for whatever reason do not want to run through the lab themselves.

2/ As a starting point for future lab development, to provide the source code of a simple Helidon based microservice without having to create it from scratch

3/ To enable the automated building of the full code tof labs which do not ivoled creatingthe code itself (e.g. using a finished version of the code in a Kubernetes lab which only uses containers and doesn;t explore the code itself)

Prerequisites

This project uses Java 17 and Helidon 3.1.2. It was created using a reasonably recent version of Eclipse for Enterprise developers (2022-06 at the point of witing this). Eclipse was chosen due to it's open source license and an IDE was used for ease of development (and ease of running the associated labs) It uses Maven to run the builds. It also uses JIB to create docker images - so if you want to have Maven perform that step you will need docker installed and running.

If you want to create native images using GraalVM you will need both GraalVM and the native image plugin installed and configured in your path.

For ease of building beans this project also uses Lombok,a wonderfully usefull compile time tool. Lombok will be automatically used when building with Maven, but if using an IDE like Eclipse you will need to install it in the IDE, see the Project Lombok documentation for details.

Notes/Issues

This is a "finished" version of the Stockmanager microservice. As such there is little work expected to be done to it, though at various points in the future it may be updated to use newer versions of Helidon or other dependencies, or include hooks to code or microservcies used in yet to be developed lab modules.

URLs

The link below is to the "full" lab that startes with the templates, ends up with something similar to this code and then progresses to creating docker images and finally to deploying in Kubernetes. This codce represents the "finished" Storefront code as of the end of the Helidon labs Associated base lab

Contributing

This project is open source. Please submit your contributions by forking this repository and submitting a pull request! Oracle appreciates any contributions that are made by the open source community. Please consider that any changes or modifications will need to remain in sync with the template code based on this content, any and the associated Labs which use that template code.

License

Copyright (c) 2024 Oracle and/or its affiliates.

Licensed under the Universal Permissive License (UPL), Version 1.0.

See LICENSE for more details.

Disclaimer

ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.