Skip to content

Commit

Permalink
Integrated PR #251
Browse files Browse the repository at this point in the history
  • Loading branch information
fturizo committed Jan 7, 2022
1 parent f81e0d3 commit cf5c6ba
Show file tree
Hide file tree
Showing 5 changed files with 38 additions and 38 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,77 +1,77 @@
= Payara Micro tools in Eclipse IDE
= Payara Micro Tools in Eclipse IDE

[[create-micro-maven-project]]
== Creating A New Payara Micro Maven Application

* Simply start up Eclipse IDE and then Choose *File > New > Project* from the main menu
or press Ctrl+N to get the list of available projects:

. Simply start up Eclipse IDE and then Choose *File > New > Project* from the main menu or press Ctrl+N to get the list of available projects:
+
image::eclipse-plugin/payara-micro/create-new-project.png[Generate Payara Micro Application]

* Now, select the Payara Micro Project type to create the application:

. Now, select the Payara Micro Project type to create the application:
+
image::eclipse-plugin/payara-micro/payara-micro-project.png[Payara Micro Project]

* Select the destination folder, where the project will be generated.
You may also use the default workspace location:

. Select the destination folder, where the project will be generated. You may also use the default workspace location:
+
image::eclipse-plugin/payara-micro/project-location.png[Project location]

* Enter the groupId, artifactId, etc to set up the project, and then click *Next*:

. Enter the groupId, artifactId, etc to set up the project, and then click *Next*:
+
image::eclipse-plugin/payara-micro/project-gav-details.png[Enter GAV]

* Enter the Payara Micro application settings e.g context path of the application
and Payara Micro version and click the *Finish* button:

. Enter the Payara Micro application settings e.g context path of the application and Payara Micro version and click the *Finish* button:
+
image::eclipse-plugin/payara-micro/micro-settings.png[Micro settings]

* The IDE creates the Payara Micro application using the Payara Micro maven archetype.
As you can see, the project has a basic structure with *src\main\java* and *src\main\webapp* folders:

. The IDE creates the Payara Micro application using the Payara Micro maven archetype. As you can see, the project has a basic structure with `src\main\java` and `src\main\webapp` folders:
+
image::eclipse-plugin/payara-micro/project-pom.png[Micro project generated]

[[run-micro-application]]
== Running The Payara Micro Application

Eclipse IDE needs a run configuration to build the artifacts and run/debug the Payara Micro application.

* To create the Payara Micro Run configuration, select the *Run > Run Configurations...* from the main menu or toolbar:

. To create the Payara Micro Run configuration, select the *Run > Run Configurations...* from the main menu or toolbar:
+
image::eclipse-plugin/payara-micro/micro-run-config-1.png[Micro run configuration]

* The Payara Micro Run configuration dialog allows you to specify Payara Micro settings and environment variables.
Note: Payara Micro setting specified by *payara-micro-maven-plugin* in the *pom.xml* takes precedence over the *Run Configuration*.

* Select Payara Micro and double click it or click on the *New configuration* button to create a new configuration :
. The Payara Micro Run configuration dialog allows you to specify Payara Micro settings and environment variables.
+
NOTE: Payara Micro setting specified by *payara-micro-maven-plugin* in the *pom.xml* takes precedence over the *Run Configuration*.

. Select Payara Micro and double click it or click on the *New configuration* button to create a new configuration :
+
image::eclipse-plugin/payara-micro/micro-run-config-2.png[New run configuration]

* Associate the workspace project with the run configuration:

. Associate the workspace project with the run configuration:
+
image::eclipse-plugin/payara-micro/micro-run-config-3.png[Associate project]

* Click the browse button and select the project from the *Project Selection* dialog:

. Click the browse button and select the project from the *Project Selection* dialog:
+
image::eclipse-plugin/payara-micro/micro-run-config-4.png[Select the project]

* Enter the configuration name and choose the *Build Artifact* type from the drop-down list:

. Enter the configuration name and choose the *Build Artifact* type and *Reload Artifact* action from the drop-down list:
+
image::eclipse-plugin/payara-micro/micro-run-config-5.png[Configuration name]
+
By enabling the Auto Deploy or Hot Deploy feature, you may automate the manual deployment processes to boost the developers productivity. Auto Deploy will undeploy the existing application and redeploy the new application on every save action whereas the Hot Deploy mode reuses the existing application instance and updating its classloader & internal components relative to the modified source.
+
NOTE: The Auto Deploy or Hot Deploy feature is only supported for the Exploded WAR artifact deployment.

* Add the configuration to *Run and Debug* menu and press the *Apply* button to save the configuration:

. Add the configuration to *Run and Debug* menu and press the *Apply* button to save the configuration:
+
image::eclipse-plugin/payara-micro/micro-run-config-6.png[Add the Run and Debug configuration]

* To start the Payara Micro instance, run the *Payara Micro Sample* configuration from the toolbar or main menu:

. To start the Payara Micro instance, run the *Payara Micro Sample* configuration from the toolbar or main menu:
+
image::eclipse-plugin/payara-micro/micro-run-config-7.png[Invoke run configuration]

* After running the Micro application, you may see the log in the OUTPUT window:

. After running the Micro application, you may see the log in the OUTPUT window:
+
image::eclipse-plugin/payara-micro/micro-run-1.png[Payara Micro log]
+
image::eclipse-plugin/payara-micro/micro-run-2.png[Payara Micro log]

Similarly, to debug the Payara Micro application and attach the debugger to the
application, instead of pressing the Run button, you can instead click Debug
from similar locations and select the Payara Micro Sample configuration.
Similarly, to debug the Payara Micro application and attach the debugger to the application, instead of pressing the Run button, you can instead click *Debug* from similar locations and select the Payara Micro Sample configuration.

0 comments on commit cf5c6ba

Please sign in to comment.