Differences

This shows you the differences between two versions of the page.

--- java_jetty_server_on_metaarray [2022/01/21 00:40] – [Run Your Server] added ending peteyboy
+++ java_jetty_server_on_metaarray [2022/01/21 00:58] – clean up peteyboy
@@ Line 1: / Line 1: @@
-FIXME  this is under construction
 ====== Setting up a simple Java Jetty Server  ======
@@ Line 9: / Line 7: @@
 You can create a java server project that embeds Jetty and run it on [[metaarray|the MetaArray]] on your [[meta_port_allocation|assigned port]]. Below is a very simple example on how to get started with that. It doesn't use any IDE, so it's a bit manual. You can find more detailed directions at the external project links below.
-There are lots of different java frameworks that center around using the Jetty server, including a few micro frameworks. I am going to show an example using [[https://javalin.io | Javalin]], which is a microframework that is a lighter load that Spring Boot and other more mainline frameworks.  It has a simple tutorial that was used and modified a bit here to show you how to set up a Java Jetty server. To make things quick to set up, we'll use Maven (''mvn'').
+There are lots of different java web frameworks that center around using the [[https://www.eclipse.org/jetty/ |Jetty]] server, including a few microframeworks. This page is going to go through an example using [[https://javalin.io | Javalin]], which is a microframework that is a lighter load that Spring Boot and other more mainline frameworks.  It has a simple tutorial that was used and modified a bit here to show you how to set up a Java Jetty server. To make things quick to set up, we'll use Maven (''mvn'').
 ===== Create Project Space =====
-First, we'll create your maven-style project folder.
+First, let's create your maven-style project folder.
   - Go to an appropriate project folder that you want to work in
   - make the java source folder in the maven style
@@ Line 21: / Line 19: @@
 ===== Create Project Object Model =====
-Next, we'll set up the POM file, which maven will use to pull all the dependencies for our framework and let us build it.
+Next, let's set up the POM file, which maven will use to pull all the dependencies for our framework and let us build it.
   - Create a new file in "myproject", call it ''pom.xml''
@@ Line 79: / Line 77: @@
       </plugin>
       <plugin>
+        <!-- Exec plugin lets us run app directly from maven and not deal with classpaths -->
        <groupId>org.codehaus.mojo</groupId>
          <artifactId>exec-maven-plugin</artifactId>
@@ Line 90: / Line 89: @@
          </executions>
          <configuration>
+           <!-- This is what exec will run as project main, *CHANGE THIS IF YOU ARE USING A DIFFERENT MAIN CLASS-->
            <mainClass>myproject.helloWorld</mainClass>
          </configuration>
@@ Line 138: / Line 138: @@
 ===== Run Your Server =====
-Now, let's run the server. We've set up an "exec goal" in the pom so we can run the resulting project from maven, like so:
+Now, let's run the server. We've set up an "exec goal" in the POM so we can run the resulting project from maven, like so:
   mvn exec:java
-You should see something like this:
+You should see something like this (hopefully any warnings you get are ignorable):
   WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
@@ Line 167: / Line 167: @@
   [myproject.helloWorld.main()] INFO io.javalin.Javalin - Listening on http://localhost:32056/
   [myproject.helloWorld.main()] INFO io.javalin.Javalin - Javalin started in 263ms \o/
-Now try it out! point your web browser to //http://yourusername.yourSDFmetarraydomain.org:yourMetaArrayPort // and see it if works!
+If you get here, then your server is running! Now try it out: point your web browser to //http://yourusername.yourSDFmetarraydomain.org:yourMetaArrayPort // and see it if works!
 Press ''ctl-c'' to stop the server.