fixed #478

Author: paxtonhare

quick-start/src/main/java/com/marklogic/quickstart/ApplicationRunListener.java

@@ -29,7 +29,9 @@ public void contextLoaded(ConfigurableApplicationContext context) {}
     @Override
     public void finished(ConfigurableApplicationContext context, Throwable exception) {
         String port = context.getEnvironment().getProperty("local.server.port");
-        System.out.println("QuickStart UI Ready and Listening on port " + port);
-        System.out.println("http://localhost:" + port);
+        if (exception == null) {
+            System.out.println("QuickStart UI is Ready and Listening on port " + port + ".\n");
+            System.out.println("Open your browser to http://localhost:" + port + ".\t(We recommend you use Chrome or FireFox.)");
+        }
     }
 }

quick-start/src/main/java/com/marklogic/quickstart/PortInUseFailureAnalyzer.java

@@ -0,0 +1,18 @@
+package com.marklogic.quickstart;
+
+import org.springframework.boot.context.embedded.tomcat.ConnectorStartFailedException;
+import org.springframework.boot.diagnostics.AbstractFailureAnalyzer;
+import org.springframework.boot.diagnostics.FailureAnalysis;
+
+public class PortInUseFailureAnalyzer extends AbstractFailureAnalyzer<ConnectorStartFailedException> {
+    @Override
+    protected FailureAnalysis analyze(Throwable rootFailure,
+                                      ConnectorStartFailedException cause) {
+        return new FailureAnalysis(
+            "QuickStart failed to start because port " + cause.getPort()
+                + " is already being used.",
+            "Try running with a different port:\n "
+                + "java -jar quickstart.war --server.port=8080\t\t(replace 8080 with your desired port)",
+            cause);
+    }
+}

quick-start/src/main/resources/META-INF/spring.factories

@@ -1 +1,7 @@
-org.springframework.boot.SpringApplicationRunListener=com.marklogic.quickstart.ApplicationRunListener
+# Run Liseners
+org.springframework.boot.SpringApplicationRunListener=\
+com.marklogic.quickstart.ApplicationRunListener
+
+# Failure Analyzers
+org.springframework.boot.diagnostics.FailureAnalyzer=\
+com.marklogic.quickstart.PortInUseFailureAnalyzer