Skip to content

Latest commit

 

History

History
52 lines (39 loc) · 2.02 KB

README.asciidoc

File metadata and controls

52 lines (39 loc) · 2.02 KB

Quarkus Demo Project: Order Service

The application demonstrates a service, which is able to create and manage orders. To fetch the detailed information of ordered item(s), it uses a REST service provided here. Fetching the items directly from the client will allow attacker to manipulate the item information e.g. price and therefore must be avoided by all means.

Requirements

  • This application will consume this rest service. Please ensure to have it up and running and correctly configured before trying to test this application. In application.properties:

    product-service-key/mp-rest/url=<external-service-url>
    Note

    The RestClient here is automatically generated based on the openapi file provided by external service. So if there is any change in the external service, please update the openapi file corresponding in /main/resources/

  • The app uses data persistence and you need a working database to use it. You can start the DB containers using simple cmd:

    docker-compose up

    If you want to use other DB, modify the params in application.properties

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

mvn compile quarkus:dev

If the port is used, consider use -Ddebug=<port> to specify debug port manually.

Note

Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8081/q/dev/.

OpenAPI & Swagger UI

With your app running, go to http://localhost:8081/q/swagger-ui to see the Swagger UI visualizing your API. You can access the YAML OpenAPI schema under http://localhost:8081/q/openapi

Packaging, running the application and creating native executable