Expand on Javadoc for Jooby.stop() fix jooby-project#1051

jknack · jknack · commit adc8075c50b3 · 2018-04-16T21:45:32.000-03:00
diff --git a/jooby/src/main/java/org/jooby/Jooby.java b/jooby/src/main/java/org/jooby/Jooby.java
@@ -2147,14 +2147,16 @@ public static List<Definition> exportRoutes(final Jooby app) {
   }
 
   /**
-   * Start an application.
+   * Start an application. Fire the {@link #onStart(Throwing.Runnable)} event and the
+   * {@link #onStarted(Throwing.Runnable)} events.
    */
   public void start() {
     start(new String[0]);
   }
 
   /**
-   * Start an application.
+   * Start an application. Fire the {@link #onStart(Throwing.Runnable)} event and the
+   * {@link #onStarted(Throwing.Runnable)} events.
    *
    * @param args Application arguments.
    */
@@ -3125,7 +3127,23 @@ public boolean isStarted() {
   }
 
   /**
-   * Stop the application, close all the modules and stop the web server.
+   * Stop the application, fire the {@link #onStop(Throwing.Runnable)} event and shutdown the
+   * web server.
+   *
+   * Stop listeners run in the order they were added:
+   *
+   * <pre>{@code
+   * {
+   *
+   *   onStop(() -> System.out.println("first"));
+   *
+   *   onStop(() -> System.out.println("second"));
+   *
+   *   ...
+   * }
+   * }</pre>
+   *
+   *
    */
   public void stop() {
     if (started.compareAndSet(true, false)) {
