In this tutorial, I will explain how to create, run and debug a Payara Micro application in Visual Studio Code. (If you're interested in learning more about using Payara Server in VSCode, please checkout ourprevious blogs.)
Prerequisite VSCode Extensions
Before going through this tutorial, you must install the following extensions from the Visual Studio Code marketplace:
You can install extensions from Extensions view (Ctrl + Shift + X) in the activity bar of VS Code:
Creating a Payara Micro Application
Maven is the most widely used project build and dependency management tool in the Java ecosystem. So in this tutorial we will generate a Payara Micro Maven Web Application through the Payara Micro Maven archetype.
- Open the command pallet using Ctrl + Shift + P, type Payara Micro and select the Generate a Payara Micro Project option:
- Answer the prompts (groupId, artifactId, etc) to set up the project:
- Enter the context path of application:
- Select the Payara Micro version:
- Select the destination folder, where the project will be generated. Once the project is generated, you may either add the project to the current workspace or open in a new window:
- As you can see, the project has a basic structure with src\main\java and src\main\webapp folders:
Running the Payara Micro Application:
- In the explorer sidebar (or Payara activity bar), expand Payara Micro Instances, right click on the instance and select start:
- After starting the instance, you may see the Payara Micro application log in the OUTPUT window:
- Similarly you may also start the instance in the debug mode and you may also modify the debug configuration from the launch.json config named “payara-micro”.
JDK Home Path
To modify the JDK Home Path of the application, right click on the Payara Micro instance, select JDK Home and browse the JDK Home path:
You may also modify the jdk home path setting from the settings.json by updating the java.home property.
Customize Build Commands:
Payara Micro application lifecycle commands like start, stop, reload and bundle can be modified as per developer choice by overriding these command instructions in the tasks.json.
Now that we can run Payara Micro applications without leaving VSCode, it's time to write some code! For inspiration, check out the Payara Examples repository on GitHub for some sample applications.