From 0e7b21b78863d5680e279256c929cd0203bb25e4 Mon Sep 17 00:00:00 2001
From: Ilia Motornyi <elmot@vaadin.com>
Date: Tue, 28 Feb 2017 09:50:23 +0200
Subject: Easy DevelopmentServerLauncher run with maven (#8677)

Add Maven target for running or debugging the development
server and instructions for IDEA.
---
 README.md      | 36 +++++++++++++-----------------------
 uitest/pom.xml | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 7ea8d8e634..06d4963aa7 100644
--- a/README.md
+++ b/README.md
@@ -59,7 +59,7 @@ The following preferences need to be set to keep the project consistent. You nee
 1. In a Project Explorer  right-click *vaadin-uitest*
 1. Open *Run As* -> *Maven build...*
 1. Type in <code>jetty:run-exploded</code> into *Goals* and click *Run*
-1. Open URL *http://localhost:8080/run/<testUI>*
+1. Open URL *http://localhost:8080/run/&lt;testUI&gt;*
 
 ## Setting up IntelliJ IDEA to Develop Vaadin 7
 
@@ -75,29 +75,19 @@ The following preferences need to be set to keep the project consistent. You nee
 
 1. Open *Maven Projects*
 1. Open *vaadin-uitest* -> *Plugins* -> *jetty* -> *jetty:run-exploded*
-1. Open URL *http://localhost:8080/run/<testUI>*
+1. Open URL *http://localhost:8080/run/&lt;testUI&gt;*
 
 ## Running a Development Server
 
-1. Open *File* -> *New* -> *Module...*
- 1. Choose type *Java* and click *Next*
- 1. Type in name <code>uitest-run</code> and set *Content Root* and *Module File Location* to <code>&lt;your project location&gt;/uitest-run</code>
- 1. Click *Finish*
-1. Open *File* -> *Project Structure...*
- 1. Choose <code>uitest-run</code> module
- 1. Open *Dependencies* tab
- 1. Click *+* -> *Module Dependency* -> *vaadin-uitest* -> *OK*
- 1. Click *+* -> *Library...* -> *New Library...* -> *From Maven*
- 1. Type in <code>org.eclipse.jetty.aggregate:jetty-all:9.4.0.M0</code> and press *Tab*
- 1. Wait a little while Idea is trying to download the library, then click *OK*
- 1. Close *Project Structure* dialog by pressing *OK*
-1. Open *Run* -> *Edit Configurations...* then create a new configuration of type *Application* named <code>DevelopmentServerLauncher</code>
- 1. Set *Main class* to <code>com.vaadin.launcher.DevelopmentServerLauncher</code>
- 1. Set *Single instance only* checkmark
- 1. Set *VM options* to <code>-ea</code>
- 1. Set *Use classpath options* to <code>uitest-run</code>
- 1. Set *Working directory* to <code>uitest</code>
- 1. Close *Run/Debug Configurations* dialog by pressing *OK*
-
-The run configuration is ready.
+1. Open *Run* menu  and click *Edit Configurations*
+1. Click green ***+*** sign at top left corner, select *Maven* from popup 
+1. In the run configuration page, set any name for the configuration, select *vaadin-uitest* project folder as *Working directory*
+1. Type <code>exec:exec@run-development-server</code> into *Command line* and save the configuration
+1. Run the configuration and open URL *http://localhost:8888/run/&lt;testUI&gt;*
+
+## Running a Development Server in a debug mode
+
+1. Type <code>exec:exec@debug-development-server</code> into *Command line* and save the configuration
+1. In the same dialog, create new "Remote" debug configuration, using *localhost* and *Port 5005* 
+1. Start both configurations and open URL *http://localhost:8888/run/&lt;testUI&gt;*
 
diff --git a/uitest/pom.xml b/uitest/pom.xml
index 5473a9d2f8..640d6f9150 100644
--- a/uitest/pom.xml
+++ b/uitest/pom.xml
@@ -356,6 +356,46 @@
                     <skip>true</skip>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>1.5.0</version>
+                <executions>
+                    <execution>
+                        <id>run-development-server</id>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>java</executable>
+                            <arguments>
+                                <argument>-ea</argument>
+                                <argument>-classpath</argument>
+                                <classpath/>
+                                <argument>com.vaadin.launcher.DevelopmentServerLauncher</argument>
+                            </arguments>
+                            <classpathScope>test</classpathScope>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>debug-development-server</id>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>java</executable>
+                            <arguments>
+                                <argument>-ea</argument>
+                                <argument>-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005</argument>
+                                <argument>-classpath</argument>
+                                <classpath/>
+                                <argument>com.vaadin.launcher.DevelopmentServerLauncher</argument>
+                            </arguments>
+                            <classpathScope>test</classpathScope>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
         </plugins>
         <pluginManagement>
             <plugins>
-- 
cgit v1.2.3