Änderungen von Dokument Plugin-Entwicklung

Von Version 14.1
bearbeitet von awa
am 04.12.2022, 00:47
Änderungskommentar: Neuen Anhang README-FC-SERVER.md hochladen
Auf Version 5.6
bearbeitet von awa
am 25.02.2022, 13:22
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,17 +1,18 @@
1 1  {{content/}}
2 2  
3 +== Plugins für zusätzliche Funktionalitäten ==
3 3  
4 4  {{formcycle/}} bietet ein Vielzahl von Einstiegspunkten für die Erweiterung der Standard-Funktionalitäten durch Plugins. Basierend auf den einzelnen [[Plugin-Typen>>doc:Formcycle.PluginDevelopment.Types.WebHome]] werden diese zu gewissen Zeitpunkten automatisch oder manuell angesprochen und erlauben es somit von der Ersetzung eigener Platzhalter bis hin zur Implementierung eigener Verarbeitungslogik {{formcycle/}} anzupassen. Als fundamentaler erster Schritt für die Entwicklung eigener Plugins ist hierbei das Erstellen eines entsprechenden Java-Projekts anzusehen.
5 5  
6 6  == API-Dokumentation ==
7 7  
8 -Die API-Dokumentation für {{formcycle/}} findet sich hier auf unserer Seite: [[JavaScript und JavaDocs>>https://docs.formcycle.eu/]]
9 +Die API-Dokumentation für {{formcycle/}} findet sich hier auf unserer Seite: [[Javadocs>>https://docs.formcycle.eu/]]
9 9  
10 10  == Maven-Setup ==
11 11  
12 -Zu Beginn der Entwicklung eines Plugins ist es nötig, das entsprechende Entwicklungsprojekt aufzusetzten und zu konfigurieren.
13 +Zu Beginn der Entwicklung eines Plugins ist es nötig das entsprechende Entwicklungsprojekt aufzusetzten und zu konfigurieren.
13 13  
14 -Für letzteres empfehlen wir hierbei das Build-Management-Tool [[Apache Maven>>url:https://maven.apache.org/||rel="__blank"]] zu verwenden. Andere Build-Tools können prinzipiell auch genutzt werden, hier können wir aber keine Hilfe bereitstellen.
15 +Für letzteres empfehlen wir hierbei das Build-Management-Tool [[Apache Maven>>url:https://maven.apache.org/||rel="__blank"]] zum Einsatz. Andere Build-Tools können prinzipiell benutzt werden, hier können wir aber keine Hilfe bereitstellen.
15 15  
16 16  Um die entsprechenden Abhängigkeiten zu {{formcycle case="dat"/}} bereitzustellen, ist das Repository unter der URL [[https:~~/~~/artifactory.xima-services.de/artifactory/fc-plugin-dev>>url:https://artifactory.xima-services.de/artifactory/fc-plugin-dev]] zu benutzen. Dieses enthält alle öffentlich zur Verfügung stehenden Artefakte, welche dem Plugin zur Laufzeit bereitgestellt und während der Entwicklung benötigt werden.
17 17  
... ... @@ -33,7 +33,7 @@
33 33   <enabled>false</enabled>
34 34   </snapshots>
35 35   <id>xima</id>
36 - <name>fc-plugin-dev</name>
37 + <name>libs-release</name>
37 37   <url>https://artifactory.xima-services.de/artifactory/fc-plugin-dev</url>
38 38   </repository>
39 39   </repositories>
... ... @@ -44,7 +44,7 @@
44 44   <enabled>false</enabled>
45 45   </snapshots>
46 46   <id>xima</id>
47 - <name>fc-plugin-dev</name>
48 + <name>plugins-release</name>
48 48   <url>https://artifactory.xima-services.de/artifactory/fc-plugin-dev</url>
49 49   </pluginRepository>
50 50   </pluginRepositories>
... ... @@ -65,25 +65,23 @@
65 65  {{/code}}
66 66  {{/panel}}
67 67  
68 -== Maven-Projekteinrichtung ==
69 +== Maven-Projekteinrichtung
69 69  
70 70  Im Folgenden werden einige Punkte beschrieben, die beim Einrichten eines Maven-Projekts für ein {{formcycle/}}-Plugin beachtet werden müssen. Für den schnellen Einstieg gibt auch einige [[Maven-Archetypes>>||anchor="HMaven-Archetypes"]].
71 71  
72 -=== Artekfakte und Abhängigkeiten ===
73 +=== Artekfakte und Abhängigkeiten
73 73  
74 74  {{info}}
75 75  Alle Abhängigkeiten zu {{formcycle case="dat"/}} sind im scope "provided" zu definieren!
76 76  {{/info}}
77 77  
78 -Eine fertige einfache //pom.xml// können Sie [[hier herunterladen>>attach:pom.xml||rel="__blank"]].
79 +Ausgangspunkt für die Entwicklung von Plugin ist das Maven-Artefakt //fc-plugin-common//. Dieses enthält die einzelnen Plugin-Schnittstellen und steht auch auf [[unserere Downloadseite zur Verfügung>>url:http://artifactory.xima-services.de/artifactory/fc-plugin-dev/de/xima/fc/fc-plugin-common||target="_blank"]].
79 79  
80 -Ausgangspunkt für die Entwicklung von Plugin ist das Maven-Artefakt //fc-plugin-common//. Dieses enthält die einzelnen Plugin-Schnittstellen und steht auch auf [[unsererer Downloadseite zur Verfügung>>url:http://artifactory.xima-services.de/artifactory/fc-plugin-dev/de/xima/fc/fc-plugin-common||rel="noopener noreferrer" target="_blank"]].
81 -
82 82  In der //pom.xml// des Plugin-Projekts kann diese Abhängigkeit wie folgt eingebunden werden:
83 83  
84 84  {{code language="xml"}}
85 85   <properties>
86 - <xfc.version>7.2.1</xfc.version>
85 + <xfc.version>7.0.10</xfc.version>
87 87   </properties>
88 88  
89 89   <dependencies>
... ... @@ -96,7 +96,7 @@
96 96   </dependencies>
97 97  {{/code}}
98 98  
99 -Ferner steht je nach Tiefe der Integration in die bestehende Umgebung von {{formcycle case="dat"/}} und deren Benutzung als höchste Implementierung das Artefakt //fc-logic// zur Verfügung. Dieses wird wie folgt als weitere (oder einzige) Abhängigkeit definiert:
98 +Ferner steht je nach Tiefe der Integration in die bestehende Umgebung von {{formcycle case="dat"/}} und dessen Benutzung als höchste Implementierung das Artefakt //fc-logic// zur Verfügung. Dieses wird wie folgt als weitere (oder einzige) Abhängigkeit definiert:
100 100  
101 101  {{code language="xml"}}
102 102   <dependency>
... ... @@ -107,44 +107,23 @@
107 107   </dependency>
108 108  {{/code}}
109 109  
110 -Eine entsprechende Benutzung ist vor allem bei der Verwendung der Datenbankschnittstelle sowie bei der Implementierung von eigenen Verarbeitungen nötig.
109 +Eine entsprechende Benutzung ist vor allem bei der Verwendung der Datenbankschnittstelle sowie bei der Implementierung von eigenen Verarbeitungen nötig. Eine Vorlage für ein somit entstehendes Project Object Model finden Sie [[hier>>attach:pom.xml||rel="__blank"]].
111 111  
112 -Ferner ist zu beachten, dass sämtliche Abhängigkeiten zu {{formcycle case="dat"/}} im scope //provided //anzugeben sind. Dies verhindert neben Classpath-Problemen auch das unnötige Anschwellen der Plugin-Größe. Ebenso sollten diesbezüglich Abhängigkeiten auf bereits von {{formcycle case="dat"/}} benutzten und damit bereitstehenden Bibliotheken wiederverwendet werden (z.B. diverse Apache Commons-Implementierungen). Solche Abhängigkeit sind auch im Scope //provided// zu definieren. Eine einfache Möglichkeit, Fehler zu vermeiden, ist das Importieren der FORMCYCLE-Bom:
111 +Ferner ist zu beachten, dass sämtliche Abhängigkeiten zu {{formcycle case="dat"/}} im scope //provided //anzugeben sind. Dies verhindert neben Classpath-Problemen auch das unnötige Anschwellen der Plugin-Größe. Ebenso sollten diesbezüglich Abhängigkeiten auf bereits von {{formcycle case="dat"/}} benutzten und damit bereitstehenden Bibliotheken wiederverwendet werden (z.B. diverse Apache Commons-Implementierungen).
113 113  
114 -{{code language="xml"}}
115 - <dependencyManagement>
116 - <dependencies>
117 - <!--Import dependency versions from FORMCYCLE -->
118 - <dependency>
119 - <groupId>de.xima.fc</groupId>
120 - <artifactId>fc</artifactId>
121 - <version>${xfc.version}</version>
122 - <type>pom</type>
123 - <scope>import</scope>
124 - </dependency>
125 - </dependencies>
126 - </dependencyManagement>
127 -{{/code}}
113 +=== Manifest und Fat JAR
128 128  
129 -Dann einfach die gewünschte Abhängigkeit ohne {{code}}<version>...</version>{{/code}} definieren. Wenn FORMCYCLE die Abhängigkeit schon enthält, gibt es keinen Build-Fehler. Andernfalls muss diese im Plugin mitgeliefert werden. In dem Fall die Version hinzufügen und den Provided-Scope entfernen.
130 -
131 -=== Manifest und Fat JAR ===
132 -
133 133  In der //META-INF/MANIFEST.MF// in der Plugin-JAR-Datei sollten folgende Informationen stehen:
134 134  
135 135  ; formcycle-version-requirement
136 -: Erforderlich. Version von {{formcycle/}}, für die das Plugin gedacht ist. Ist erforderlich, damit {{formcycle/}} bei der Installation die Kompatibilität prüfen kann.
118 +: Erforderlich. Version von {{formcycle/}}, für die das Plugin gedacht ist.Ist erforderlich, damit {{formcycle/}} bei der Installation die Kompatibilität prüfen kann.
137 137  ; Implementation-Version
138 -: Erforderlich. Version des Plugins; Diese wird z.B. in der Oberfläche angezeigt.
139 -; Plugin-Key
140 -: Erforderlch. Wird zur Identifizierung des Plugin innherhalb von {{formcycle/}} verwendet, und auch von etwa dem Deploy-Plugin oder Server-Plugin. Empfohlener Wert ist {{code}}${project.groupId}:${project.artifactId}{{/code}}.
120 +: Erforderlich. Version des Plugins, wird etwa in der Oberfläche angezeigt.
141 141  ; Build-Time oder Build-Timestamp
142 -: Optional. Wird bei SNAPSHOT-Versionen mit angezeigt, um den SNAPSHOT zu identifizieren.
122 +: Optional, wird bei SNAPSHOT-Versionen mit angezeigt, um den SNAPSHOT zu identifizieren.
123 +; Implementation-Title
124 +: Optional, wird standardmäßig etwa vom Deploy-Plugin verwendet, um das Plugin zu identifzieren.
143 143  
144 -{{info}}
145 -Bis einschließlich Version 7.x von {{formcycle/}} ist noch {{code}}Implementation-Title{{/code}} mit dem gleichen Wert wie {{code}}Plugin-Key{{/code}} erforderlich.
146 -{{/info}}
147 -
148 148  Diese Informationen können wie unten beschrieben mittels des //maven-assembly-plugin// in die Manifest-Datei geschrieben werden.
149 149  
150 150  Weiterhin ist beim Bauen zu beachten, dass eine sogenannte Fat-JAR gebaut werden muss. Abhängigkeiten zu {{formcycle case="dat"/}} sowie anderen Bibliotheken, welche bereits durch {{formcycle case="acc"/}} mitgeliefert werden, sollten wie bereits erwähnt im scope //provided// eingebunden werden. Falls im Plugin aber noch andere Abhängigkeiten benutzt werden, müssen diese in der JAR-Datei inkludiert werden (Fat JAR).
... ... @@ -159,7 +159,7 @@
159 159   <maven-assembly-plugin.version>3.3.0</maven-assembly-plugin.version>
160 160   </properties>
161 161   <build>
162 - <finalName>${project.artifactId}</finalName>
140 + <finalName>${project.parent.artifactId}</finalName>
163 163   <plugins>
164 164   <plugin>
165 165   <groupId>org.apache.maven.plugins</groupId>
... ... @@ -173,7 +173,7 @@
173 173   <goal>single</goal>
174 174   </goals>
175 175   <configuration>
176 - <finalName>${project.artifactId}</finalName>
154 + <finalName>${project.parent.artifactId}</finalName>
177 177   <appendAssemblyId>false</appendAssemblyId>
178 178   <descriptorRefs>
179 179   <descriptorRef>jar-with-dependencies</descriptorRef>
... ... @@ -223,7 +223,7 @@
223 223   Auswahl eines Archetypes beim Erstellen eines Maven-Projekts in Eclipse
224 224  {{/figure}}
225 225  
226 -Für einige häufig verwendete Plugin-Typen stehen [[Maven-Archetypes>>url:https://maven.apache.org/guides/introduction/introduction-to-archetypes.html||rel="noopener noreferrer" target="_blank"]] bereits, um schnell ein Maven-Projekt aufsetzen zu können.
204 +Für einige häufig verwendete Plugin-Typen stehen [[Maven-Archetypes>>url:https://maven.apache.org/guides/introduction/introduction-to-archetypes.html||target="_blank"]] bereits, um schnell ein Maven-Projekt aufsetzen zu können.
227 227  
228 228  Voraussetzung für die Verwendung ist, dass in den //~~/.m2/settings.xml// wie oben beschrieben das XIMA-Artifactory eingerichtet wurde. Dann kann etwa über die Kommandozeile wie folgt eine Archetype generiert werden:
229 229  
... ... @@ -233,15 +233,13 @@
233 233  
234 234  Es werden dann einige wenige Informationen wie die gewünschten Maven-Koordinaten des neuen Plugin-Projekts abgefragt und anschließend ein neues vorkonfiguriertes Projekt erstellt.
235 235  
236 -Alle vorhandenen Archetypes und deren Versionen können im [[Archetype-Katalog>>url:https://artifactory.xima-services.de/artifactory/libs-release-local/archetype-catalog.xml||rel="noopener noreferrer" target="_blank"]] eingesehen werden.
214 +Alle vorhandenen Archetypes und deren Versionen können im [[Archetype-Katalog>>url:https://artifactory.xima-services.de/artifactory/libs-release-local/archetype-catalog.xml||target="_blank"]] eingesehen werden.
237 237  
238 238  In Eclipse kann der Archetype-Katalog in den Einstellungen hinzugefügt werden. Bei der Erstellung eines neuen Maven-Projekt werden dann alle verfügbaren Archetypes angezeigt:
239 239  
240 -{{code language="plaintext"}}
241 -https://artifactory.xima-services.de/artifactory/libs-release-local/archetype-catalog.xml
242 -{{/code}}
218 +{{code language="plaintext"}}https://artifactory.xima-services.de/artifactory/libs-release-local/archetype-catalog.xml{{/code}}
243 243  
244 -== Deploy-Plugin ==
220 +== Deploy-Plugin
245 245  
246 246  Um beim Entwickeln nicht jedes Mal eine neue Plugin-Version manuell über die Oberfläche hochladen zu müssen, kann das Deploy-Plugin verwendet werden. Dieses besteht aus 2 Teilen:
247 247  
... ... @@ -248,40 +248,39 @@
248 248  * Ein Maven-Plugin, welches nach dem Bauen das Plugin via HTTP an einen laufenden {{formcycle/}}-Server sendet
249 249  * Ein Plugin für {{formcycle/}}, welche die Gegenstelle in {{formcycle/}} bereitstellt und das Plugin aus dem HTTP-Request in {{formcycle/}} installiert.
250 250  
251 -Weitere Details können im [[Hilfe-Artikel zum Deploy-Plugin>>doc:Formcycle.PluginDocumentation.FormcycleDeployPluginPlugin]] nachgelesen werden. Für die meisten Fälle ist kene Konfiguration in der //pom.xml// erforderlich. Es empfiehlt sich aber, wenigstens die Version festzusetzen:
227 +Weitere Details können im [[Hilfe-Artikel zum Deploy-Plugin>>doc:Formcycle.PluginDocumentation.FormcycleDeployPluginPlugin]] nachgelesen werden. Für die meisten Fälle reicht folgende Konfiguration in der //pom.xml// des Plugin-Projekts aus:
252 252  
253 253  {{code language="xml"}}
254 254   <properties>
255 - <fc-deploy-plugin-maven-plugin.version>7.0.1<fc-deploy-plugin-maven-plugin.version></fc-deploy-plugin-maven-plugin>
231 + <fc-deploy-plugin-maven-plugin.version>7.0.1<fc-deploy-plugin-maven-plugin.version/>
256 256   <build>
257 257   <plugins>
258 - <plugin>
234 + <plugin>
259 259   <groupId>de.xima.fc.maven.plugin</groupId>
260 260   <artifactId>fc-deploy-plugin-maven-plugin</artifactId>
261 261   <version>${fc-deploy-plugin-maven-plugin.version}</version>
238 + <executions>
239 + <execution>
240 + <id>upload</id>
241 + <phase>install</phase>
242 + <goals>
243 + <goal>deploy</goal>
244 + </goals>
245 + </execution>
246 + </executions>
262 262   </plugin>
263 263   </plugins>
264 264   </build>
265 265  {{/code}}
266 266  
267 -Sofern das Deploy-Plugin bereits in {{formcycle/}} installiert ist, kann das Plugin-Projekt dann wie folgt gebaut und hochgeladen werden:
252 +Sofern das Deploy-Plugin bereits in {{formcycle/}} installiert ist, kann das Plugin-Projekt dann beim Bauen wie folgt hochgeladen werden:
268 268  
269 269  {{code language="bash"}}
270 -mvn fc-deploy:deploy
255 +mvn clean install -DfcDeployUrl=http://localhost:8080/xima-formcycle -DfcDeployToken=admin
271 271  {{/code}}
272 272  
273 -Es wird hierbei davon ausgegangen, dass {{formcycle/}} unter der Standard-URL {{code}}http://localhost:8080/xima-formcycle{{/code}} läuft und das Standard-Passwort "admin" für das Deploy-Plugin verwendet wird. Ist dies nicht der Fall, können die Werte auch angepasst werden:
258 +Wird Eclipse benutzt, kann auch eine Launch-Configuration mit den //fcDeployUrl// und dem //fcDeployToken// angelegt werden.
274 274  
275 -{{code language="bash"}}
276 -mvn package fc-deploy:deploy -DfcDeployUrl=http://localhost:8080/xima-formcycle -DfcDeployToken=admin
277 -{{/code}}
278 -
279 -{{info}}
280 -Bis einschließlich Version 7.x von {{formcycle/}} und dem Maven-Plugin ist es noch erforderlich, die package-Phase explizit aufzuführen. Zudem müssen die URL und das Passwort angegeben werden. Ab Version 8.x sind die Standardwerte gesetzt und die package-Phase wird automatisch ausgeführt.
281 -{{/info}}
282 -
283 -Soll das Plugin im Bereich eines bestimmten Mandanten registriert werden, so kann dies über den zusätzlichen Launch-Configuration Parameter //fcDeployClientId //erreicht werden. Dieser Parameter muss als Wert die Id des Mandanten enthalten.
284 -
285 285  == FC-Server-Plugin ==
286 286  
287 287  Zum Testen eines Plugins ist es erforderlich, einen laufenden {{formcycle/}}-Server zu haben. Zur Vereinfachung der Entwicklung gibt es das //fc-server-maven-plugin//, welches mittels eines einzigen Befehls ein fertig eingerichtetes {{formcycle/}} lokal startet, wo auch bereits das Deploy-Plugin vorinstalliert ist.
... ... @@ -289,30 +289,8 @@
289 289  Sofern wie oben beschrieben in //~~/.m2/settings.xml// die //pluginGroup// hinterlegt wurde, kann in einem beliebiegen Verzeichnis wie folgt ein {{formcycle/}}-Server per Maven gestartet werden:
290 290  
291 291  {{code language="bash"}}
292 -# Aktuelle Version starten
293 -mvn fc-server:run-ms-war
294 -
295 -# Spezifische Version starten
296 -mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:7.0.4:run-ms-war -DxfcVersion=7.0.16
267 +mvn fc-server:run-ms-war -DxfcVersion=7.0.10
297 297  {{/code}}
298 298  
299 -{{info}}
300 -Wir empfehlen die Nutzung von Java 11. Bei Nutzung von Java 17 kann es aktuell zu Problemen beim Starten von {{formcycle/}} kommen.
301 -{{/info}}
270 +Dies funktioniert auch in einem Ordner ohne Maven-Projekt. Falls keine {{formcycle/}} angegeben ist, wird eine Standard-Version genommen.
302 302  
303 -{{info}}
304 -Bis einschließlich Version 7.x von {{formcycle/}} und dem Maven-Plugin ist es noch erforderlich, die package-Phase explizit aufzuführen: {{code}}mvn package fc-server:run-ms-war{{/code}}. Ab Version 8.x geschieht dies automatisch.
305 -{{/info}}
306 -
307 -{{info}}
308 -Die Major- und Minor-Version des Maven-Plugins sollte immer der Major- und Minor-Version des zu startenden {{formcycle case="gen"/}} entsprechen. Für {{formcycle/}} 7.0.x sollte also das Maven-Plugin in Version 7.0.x verwendet werde, für {{formcycle/}} 7.1.x das Maven-Plugin in Version 7.1.x usw.
309 -{{/info}}
310 -
311 -Nach kurzer Wartezeit (beim ersten Mal kann es länger dauern) ist dann ein {{formcycle/}}-Server gestartet. Die URL steht am Ende in der Kommandozeile, standardmäßig http://localhost:8080/xima-formcycle Der Zugang für den Superadmin ist {{code language="plaintext"}}sadmin{{/code}} (Passwort {{code language="plaintext"}}admin{{/code}}), der Zugang für den Mandantadministrator {{code language="plaintext"}}admin{{/code}} (Passwort {{code language="plaintext"}}/admin_{{/code}}).
312 -
313 -Falls der Befehl in einem Maven-Projekt eines {{formcycle/}}-Plugins ausgeführt wird, dann wird das Plugin automatisch gebaut und nach dem Starten des Servers hochgeladen und installiert. Zudem wird versucht, die {{formcycle/}}-Version aus dem Plugin-Projekt auszulesen.
314 -
315 -Dies funktioniert auch in einem Ordner ohne Maven-Projekt. Falls keine {{formcycle/}}-Version angegeben ist, wird eine Standard-Version genommen, abhängig von der Maven-Plugin-Version.
316 -
317 -Für fortgeschrittenen Gebrauch siehe die [[README.md>>attach:README.md||rel="__blank"]].
318 -
README-FC-SERVER.md
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.awa
Größe
... ... @@ -1,1 +1,0 @@
1 -15.2 KB
Inhalt
... ... @@ -1,497 +1,0 @@
1 -Maven plugin for starting a FORMCYCLE server, similar to the Jetty maven plugin, but initializes the FORMCYCLE application.
2 -
3 -## TL;DR
4 -
5 -Version 8:
6 -
7 -```bash
8 -# Standalone
9 -mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:8.0.0:ms -DxfcVersion=8.0.4
10 -
11 -# FORMCYCLE plugin project
12 -mvn fc-server:run-ms-war
13 -```
14 -
15 -Version 7:
16 -
17 -> mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:7.0.4:ms -DxfcVersion=7.0.16
18 -
19 -See [changelog](./CHANGELOG.md) for a list of versions.
20 -
21 -## Versioning
22 -
23 -* The major and minor version are always equal to the FORMCYCLE major version against which the project was built.
24 -* The patch version is for the plugin.
25 -
26 -## Terms
27 -
28 -A "FORMCYCLE plugin project" is Maven project packaged as a fat jar, with a (possibly transitive)
29 -compile dependency on `de.xima.fc:fc-plugin-common` in the `provided` scope.
30 -
31 -A Maven project "packaged as a fat jar" is Maven project with its `packaging` set to `jar` and
32 -that includes a plugin execution for either the `maven-assembly-plugin` or the `maven-shade-plugin`.
33 -
34 -## Goals
35 -
36 -See the site above for more in-depth info.
37 -
38 -* `ms` Intended for use as a command line tool to start a server without a Maven project:
39 - `mvn fc-server:ms`.
40 -* `run-ms-war` Intended for use as a command line tool to start a server on an existing
41 - [FORMCYCLE plugin project](#terms): `mvn fc-server:ms`.
42 -* `start-ms-war` Goal for integration into an existing lifecycle defined in a pom.xml, should be
43 - bound to a particular phase. Does not block by default.
44 -
45 -## Usage
46 -
47 -This is a Maven plugin with several goals. You can run it via the command line:
48 -
49 -```bash
50 -# When you have no Maven project
51 -mvn fc-server:ms
52 -
53 -# When you have an existing FORMYCLE plugin project
54 -mvn fc-server:run-ms-war
55 -```
56 -
57 -If the command is run from within an existing Maven project, it first packages the project, then starts the server and finally (if `-DdeployMavenProject=true` is set), installs the main artifact file of the Mavne project automatically into the started FORMCYCLE instance.
58 -
59 -The first command can be used in a directory without a Maven project.
60 -
61 -If the second command is run on an existing [FORMCYCLE plugin project](#terms), it first packages that project, then
62 -starts the server and finally installs the main artifact file of the Maven project automatically into the started
63 -FORMCYCLE instance.
64 -
65 -If Maven cannot find the plugin or you need to run a specific version of the plugin, you have to use the full coordinates:
66 -
67 -> mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:8.0.0-SNAPSHOT:run-ms-war
68 -
69 -To get Maven to find the plugin without the full name, either add the plugin to `<plugin>` section of your `pom.xml` or add the following to the `~/.m2/settings.xml`:
70 -
71 -```xml
72 -<settings>
73 - <pluginGroups>
74 - <pluginGroup>de.xima.fc.maven.plugin</pluginGroup>
75 - </pluginGroups>
76 -</settings>
77 -```
78 -
79 -If you want to configure the plugin, you can do so via a `<plugin>` section in the `pom.xml`. See the
80 -site above for documentation. Below are some example configurations.
81 -
82 -### Use a different FORMCYCLE version
83 -
84 -The FORMCYCLE version defaults to the version against which the version of the plugin was built. The plugin major and minor version always follow the FORMCYCLE version, e.g. plugin version 7.0.9 will default to some `7.0.x` release of FORMCYCLE.
85 -
86 -To set the version of the FORMCYCLE app:
87 -
88 -```xml
89 -<plugin>
90 - <groupId>de.xima.fc.maven.plugin</groupId>
91 - <artifactId>fc-server-maven-plugin</artifactId>
92 - <version>${fc-server-maven-plugin.version}</version>
93 - <configuration>
94 - <xfcVersion>7.0.7</xfcVersion>
95 - </configuration>
96 -</plugin>
97 -```
98 -
99 -Note that you can also use:
100 -
101 -> mvn fc-server:ms -DxfcVersion=7.0.7
102 -
103 -You may have to use a different version of the plugin for older FC versions (major and minor plugin version always follow the FC version)
104 -
105 -> mvn de.xima.fc.maven.plugin:fc-server-maven-plugin:7.0.4:ms -DxfcVersion=7.0.16
106 -
107 -### Use a custom FORMCYCLE war file
108 -
109 -If you need to, you can also use a custom FORMCYCLE WAR file, e.g. a local build etc.
110 -
111 -
112 -```xml
113 -<plugin>
114 - <groupId>de.xima.fc.maven.plugin</groupId>
115 - <artifactId>fc-server-maven-plugin</artifactId>
116 - <version>${fc-server-maven-plugin.version}</version>
117 - <configuration>
118 - <warFile>/path/to/formcycle.war</warFile>
119 - </configuration>
120 -</plugin>
121 -```
122 -
123 -You can also use specify this setting on the command line:
124 -
125 -> mvn fc-server:ms -DwarFile=/path/to/formcycle.war
126 -
127 -### Change servlet container settings
128 -
129 -You can change the server context path and port:
130 -
131 -```xml
132 -<plugin>
133 - <groupId>de.xima.fc.maven.plugin</groupId>
134 - <artifactId>fc-server-maven-plugin</artifactId>
135 - <version>${fc-server-maven-plugin.version}</version>
136 - <configuration>
137 - <contextPath>form-server</contextPath>
138 - <port>8099</port>
139 - </configuration>
140 -</plugin>
141 -```
142 -
143 -You can also use specify these settings on the command line:
144 -
145 -> mvn fc-server:ms -DcontextPath=form-server -Dport=8090
146 -
147 -### Change app persistence directory
148 -
149 -All FORMCYCLE specific data such as the log files, configuration files or temporary files are stored in the application directory in the `target` folder. You can use a different app directory if you want.
150 -
151 -```xml
152 -<plugin>
153 - <groupId>de.xima.fc.maven.plugin</groupId>
154 - <artifactId>fc-server-maven-plugin</artifactId>
155 - <version>${fc-server-maven-plugin.version}</version>
156 - <configuration>
157 - <appDir>${project.basedir}/xfc-server</appDir>
158 - </configuration>
159 -</plugin>
160 -```
161 -
162 -You can also use specify this setting on the command line:
163 -
164 -> mvn fc-server:ms -DappDir=target/apps/xfc-server
165 -
166 -### Use a different servlet container
167 -
168 -By default, Jetty is used, but this can be changed:
169 -
170 -```xml
171 -<plugin>
172 - <groupId>de.xima.fc.maven.plugin</groupId>
173 - <artifactId>fc-server-maven-plugin</artifactId>
174 - <version>${fc-server-maven-plugin.version}</version>
175 - <configuration>
176 - <container>tomcat:9</container>
177 - </configuration>
178 -</plugin>
179 -```
180 -
181 -You can also use specify this setting on the command line:
182 -
183 -> mvn fc-server:ms -Dcontainer=tomcat:9
184 -
185 -By default, supported values are currently
186 -
187 -* `jetty:10` - Jetty Servlet Container Version 10.x
188 -* `tomcat:9` - Apache Tomcat Version 9.x
189 -
190 -To use a custom container, include a `de.xima.servletcontainer.api.IServletContainerProvider` in
191 -the classpath and specify the corresponding name.
192 -
193 -### Use in-memory H2 database
194 -
195 -By default, the H2 database is stored in a file, so the data is persisted when you restart the server. But you can also use an in-memory database:
196 -
197 -```xml
198 -<plugin>
199 - <groupId>de.xima.fc.maven.plugin</groupId>
200 - <artifactId>fc-server-maven-plugin</artifactId>
201 - <version>${fc-server-maven-plugin.version}</version>
202 - <configuration>
203 - <h2Storage>ram</h2Storage>
204 - </configuration>
205 -</plugin>
206 -```
207 -
208 -You can also use specify this setting on the command line:
209 -
210 -> mvn fc-server:ms -Dh2Storage=ram
211 -
212 -### Use a different database
213 -
214 -Include the driver via `dbDrivers` and configure the `database.properties`:
215 -
216 -```xml
217 -<plugin>
218 - <groupId>de.xima.fc.maven.plugin</groupId>
219 - <artifactId>fc-server-maven-plugin</artifactId>
220 - <version>${fc-server-maven-plugin.version}</version>
221 - <configuration>
222 - <dbDrivers>
223 - <dbDriver>postgresql</dbDriver>
224 - </dbDrivers>
225 - <databaseProperties>
226 - <properties>
227 - <property>
228 - <name>db.connection.dbms.shortname</name>
229 - <value>postgresql</value>
230 - </property>
231 - <property>
232 - <name>db.connection.jdbcurl</name>
233 - <value>jdbc:postgresql://localhost:5432/my_database</value>
234 - </property>
235 - <property>
236 - <name>db.connection.login.username</name>
237 - <value>USERNAME</value>
238 - </property>
239 - <property>
240 - <name>db.connection.login.password</name>
241 - <value>PASSWORD</value>
242 - </property>
243 - </properties>
244 - </databaseProperties>
245 - </configuration>
246 -</plugin>
247 -```
248 -
249 -You can also use specify this setting on the command line (separate multiple drivers with a comma):
250 -
251 -> mvn fc-server:ms -DaddDbDrivers=postgresql,h2 -DdbShortname=postgresql -DdbJdbcUrl=jdbc:postgresql://localhost:5432/my_database -DdbUsername=USERNAME -DdbPassword=PASSWORD
252 -
253 -Supported database drivers are
254 -
255 -* `h2`
256 -* `mariadb`
257 -* `mysql`
258 -* `oracle`
259 -* `postgresql`
260 -* `sqlserver`
261 -* `custom` (does not add any driver, add your own driver via `dependencies`)
262 -
263 -### Create default clients
264 -
265 -You can add additional clients to be created when the FORMCYCLE app starts. When the client exists already, it is updated with the configured settings. Clients are identified by their `name`.
266 -
267 -```xml
268 -<plugin>
269 - <groupId>de.xima.fc.maven.plugin</groupId>
270 - <artifactId>fc-server-maven-plugin</artifactId>
271 - <version>${fc-server-maven-plugin.version}</version>
272 - <configuration>
273 - <bootstrap>
274 - <clientManagement>
275 - <!-- Do not create the default client -->
276 - <excludeDefaults>true</excludeDefaults>
277 - <clients>
278 - <!-- Create a default client -->
279 - <client>
280 - <baseSettings>
281 - <name>myforms</name>
282 - <alias>Formular</alias>
283 - <languageTag>de</languageTag>
284 - <baseUrl>http://10.42.42.50/form-server</baseUrl>
285 - <description>Client for testing forms</description>
286 - </baseSettings>
287 - <adminUser>
288 - <userName>awa</userName>
289 - <email>awa@xima.de</email>
290 - <givenName>Andre</givenName>
291 - <lastName>Wachsmuth</lastName>
292 - <password>12345678</password>
293 - </adminUser>
294 - </client>
295 - </clients>
296 - </clientManagement>
297 - </bootstrap>
298 - </configuration>
299 -</plugin>
300 -```
301 -
302 -### Including additional plugins
303 -
304 -You can include additional plugins that should be installed after the FORMYCLE app was started:
305 -
306 -```xml
307 -<plugin>
308 - <groupId>de.xima.fc.maven.plugin</groupId>
309 - <artifactId>fc-server-maven-plugin</artifactId>
310 - <version>${fc-server-maven-plugin.version}</version>
311 - <configuration>
312 - <bootstrap>
313 - <pluginManagement>
314 - <plugins>
315 - <!-- You can specify a Maven coordinate when the plugin is available via Maven -->
316 - <plugin>
317 - <location>de.xima.fc.plugin:fc-plugin-bundle-leitfaden:2.0.22</location>
318 - </plugin>
319 - <!-- You can also specify a local path -->
320 - <plugin>
321 - <location>/path/to/some-plugin.jar</location>
322 - </plugin>
323 - </plugins>
324 - </pluginManagement>
325 - </bootstrap>
326 - </configuration>
327 -</plugin>
328 -```
329 -
330 -You can also use specify this setting on the command line:
331 -
332 -> mvn fc-server:ms -DaddSystemPlugins=de.xima.fc.plugin:fc-plugin-bundle-leitfaden:2.0.22
333 -
334 -Supported plugin sources:
335 -
336 -* Store coordinate:
337 - * `store:/1ce83c47-7b8d-4da8-844e-723cf5e3c426/2.0.7`(no double slash!)
338 - * in general: `store://[itemKey]/[version]/[fileName]?store=[storeKey]&server=[baseUrl]`
339 - * only the `itemKey` and `version` are required
340 -* Maven coordinate
341 - * `-DaddSystemPlugins=de.xima.fc.plugin:fc-plugin-bundle-leitfaden:2.0.22`
342 -* File:
343 - * `-DaddSystemPlugins=/home/user/Downloads/myPlugin.jar`
344 -* URL:
345 - * `-DaddSystemPlugins=https://example.com/plugin.jar`
346 -
347 -### Use a different or no license
348 -
349 -By default, a demo license is used. To use a different license:
350 -
351 -```xml
352 -<plugin>
353 - <groupId>de.xima.fc.maven.plugin</groupId>
354 - <artifactId>fc-server-maven-plugin</artifactId>
355 - <version>${fc-server-maven-plugin.version}</version>
356 - <configuration>
357 - <licenseFile>/path/to/license.lic</licenseFile>
358 - </configuration>
359 -</plugin>
360 -```
361 -
362 -You can also use specify this setting on the command line:
363 -
364 -> mvn fc-server:ms -DlicenseFile=/path/to/license.lic
365 -
366 -Sometimes you may want to start the server without a preinstalled license:
367 -
368 -```xml
369 -<plugin>
370 - <groupId>de.xima.fc.maven.plugin</groupId>
371 - <artifactId>fc-server-maven-plugin</artifactId>
372 - <version>${fc-server-maven-plugin.version}</version>
373 - <configuration>
374 - <licenseFile>builtin:none</licenseFile>
375 - </configuration>
376 -</plugin>
377 -```
378 -
379 -The value for `licenseFile` can be either
380 -* a file path
381 - * `file:/path/to/license.lic`
382 -* a file URI
383 - * `file:/path/to/license.lic`
384 -* a builtin URI:
385 - * `builtin:<name>`
386 - * `builtin:demo` Uses a simple demo license.
387 - * `builtin:none` Uses no license.
388 -
389 -### Deploy current plugin project on startup
390 -
391 -By default, the `run-ms-war` goal checks whether the current Maven project is a
392 -[FORMCYCLE plugin project](#terms). If so, it automatically picks up the main artifact file
393 -of the project and installs the plugin after the FORMCYCLE app was started.
394 -
395 -To configure this behavior, add the following configuration in your pom:
396 -
397 -```xml
398 -<plugin>
399 - <groupId>de.xima.fc.maven.plugin</groupId>
400 - <artifactId>fc-server-maven-plugin</artifactId>
401 - <version>${fc-server-maven-plugin.version}</version>
402 - <configuration>
403 - <deployMavenProject>true</deployMavenProject>
404 - </configuration>
405 -</plugin>
406 -```
407 -
408 -You can also use specify this setting on the command line:
409 -
410 -> mvn fc-server:run-ms-war -DdeployMavenProject=false
411 -
412 -### Include additional dependencies
413 -
414 -Sometimes you may want to include additional dependencies in the classpath, e.g. for custom servlet container
415 -providers or database drivers.
416 -
417 -You can add additional dependencies on a per-execution basis like this:
418 -
419 -```xml
420 -<plugin>
421 - <groupId>de.xima.fc.maven.plugin</groupId>
422 - <artifactId>fc-server-maven-plugin</artifactId>
423 - <version>${fc-server-maven-plugin.version}</version>
424 - <executions>
425 - <execution>
426 - <goals>
427 - <goal>run-ms-war</goal>
428 - </goals>
429 - <phase>package</phase>
430 - <configuration>
431 - <dependencies>
432 - <dependency>
433 - <groupId>com.ibm.db2</groupId>
434 - <artifactId>jcc</artifactId>
435 - <version>11.5.8.0</version>
436 - </dependency>
437 - </dependencies>
438 - </configuration>
439 - </execution>
440 - </executions>
441 -</plugin>
442 -```
443 -
444 -You can also use specify this setting on the command line (separate multiple dependenies with a comma):
445 -
446 -> mvn fc-server:run-ms-war -DaddDependencies=com.ibm.db2:jcc:com.ibm.db2
447 -
448 -### Skip execution for multi-module projects
449 -
450 -By default, the `run-ms-war` goal skips execution when run on a Maven project that is not a
451 -[FORMCYCLE plugin project](#terms). This can be useful e.g. when you have a multi-module project
452 -where only one project is a FORMYCLE plugin. You can then simply invoke `mvn fc-server:run-ms-war`
453 -on the parent project. This builds the entire project until it reaches the FORMCYCE plugin, at which
454 -point it starts the server and installs the built plugin.
455 -
456 -To disable this default behavior, use `-DskipNonPluginProject=false` or use the following configuration in your pom:
457 -
458 -```xml
459 -<plugin>
460 - <groupId>de.xima.fc.maven.plugin</groupId>
461 - <artifactId>fc-server-maven-plugin</artifactId>
462 - <version>${fc-server-maven-plugin.version}</version>
463 - <configuration>
464 - <skipNonPluginProject>true</skipNonPluginProject>
465 - </configuration>
466 -</plugin>
467 -```
468 -
469 -You can also force the execution to be always skipped via the `skip` parameter in your pom:
470 -
471 -
472 -```xml
473 -<plugin>
474 - <groupId>de.xima.fc.maven.plugin</groupId>
475 - <artifactId>fc-server-maven-plugin</artifactId>
476 - <version>${fc-server-maven-plugin.version}</version>
477 - <configuration>
478 - <skip>true</skip>
479 - </configuration>
480 -</plugin>
481 -```
482 -
483 -You can also use specify this setting on the command line:
484 -
485 -> mvn fc-server:run-ms-war -Dskip.fc.server
486 -
487 -### Remote debugging
488 -
489 -To remote debug the the application server, start it with
490 -
491 -> MAVEN_OPTS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=1044 mvn fc-server:ms
492 -
493 -Then attach the debugger to port 1044.
494 -
495 -Note: When you start this goal from within your IDE, you usually do no need to specify this manually
496 -as your IDE will usually attach to the JVM process automatically already.
497 -
pom.xml
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.awa
1 +XWiki.rth
Größe
... ... @@ -1,1 +1,1 @@
1 -5.8 KB
1 +2.2 KB
Inhalt
... ... @@ -2,89 +2,55 @@
2 2   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
3 3   <modelVersion>4.0.0</modelVersion>
4 4  
5 - <!-- MUST BE FILLED IN -->
6 6   <groupId></groupId>
7 7   <artifactId></artifactId>
8 8   <version></version>
9 - <name></name>
10 -
11 11   <packaging>jar</packaging>
12 12  
10 + <name></name>
11 +
13 13   <properties>
14 14   <!-- Configuration -->
15 15   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
16 16  
17 17   <!-- Dependencies -->
18 - <xfc.version>7.2.1</xfc.version>
19 - <junit-jupiter.version>5.6.0</junit-jupiter.version>
17 + <xfc-version>7.0.9</xfc-version>
20 20  
21 21   <!-- Plugins -->
22 - <maven-surefire-plugin.version>2.22.2</maven-surefire-plugin.version>
23 - <maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
24 - <maven-jar-plugin.version>3.1.0</maven-jar-plugin.version>
25 - <maven-assembly-plugin.version>3.3.0</maven-assembly-plugin.version>
26 - <fc-deploy-plugin-maven-plugin.version>7.0.1</fc-deploy-plugin-maven-plugin.version>
27 - <fc-server-maven-plugin.version>7.0.1</fc-server-maven-plugin.version>
20 + <maven-compiler-plugin-version>3.8.1</maven-compiler-plugin-version>
21 + <maven-jar-plugin-version>3.1.0</maven-jar-plugin-version>
28 28   </properties>
29 29  
24 + <repositories>
25 + <repository>
26 + <id>xima</id>
27 + <name>fc-plugin-dev</name>
28 + <url>http://artifactory.xima-services.de/artifactory/fc-plugin-dev</url>
29 + </repository>
30 + </repositories>
31 +
30 30   <dependencies>
31 - <!-- Reference FORMCYCLE libraries. The plugin is installed in a running -->
32 - <!-- FORMCYCLE system, , so you do not need to include the FORMCYCLE libraries -->
33 - <!-- in the plugin JAR. This is done by setting the scope to "provided" -->
34 34   <dependency>
35 35   <groupId>de.xima.fc</groupId>
36 - <artifactId>fc-logic</artifactId>
37 - <version>${xfc.version}</version>
35 + <artifactId>fc-plugin-common</artifactId>
36 + <version>${xfc-version}</version>
38 38   <scope>provided</scope>
39 39   </dependency>
40 40  
41 - <!-- JUnit for writing unit tests -->
42 42   <dependency>
43 - <groupId>org.junit.jupiter</groupId>
44 - <artifactId>junit-jupiter</artifactId>
45 - <version>${junit-jupiter.version}</version>
46 - <scope>test</scope>
41 + <groupId>de.xima.fc</groupId>
42 + <artifactId>fc-logic</artifactId>
43 + <version>${xfc-version}</version>
44 + <scope>provided</scope>
47 47   </dependency>
48 -
49 - <!-- You can add additional dependencies here. -->
50 - <!-- Some common libraries as apache-commons and guava are provided by -->
51 - <!-- FORMCYCLE and can be set to scope=provided. -->
52 -
53 53   </dependencies>
54 54  
55 55   <build>
56 - <finalName>${project.artifactId}</finalName>
57 -
58 58   <plugins>
59 -
60 - <!-- Upload the plugin to a running FORMCYCLE server as part of the Maven build process -->
61 - <!-- mvn package fc-deploy:deploy -DfcDeployUrl=http://localhost:8080/xima-formcycle -DfcDeployToken=admin -->
62 62   <plugin>
63 - <groupId>de.xima.fc.maven.plugin</groupId>
64 - <artifactId>fc-deploy-plugin-maven-plugin</artifactId>
65 - <version>${fc-deploy-plugin-maven-plugin.version}</version>
66 - </plugin>
67 -
68 - <!-- Start a preconfigured FORMCYCLE server-->
69 - <!-- mvn fc-server:run-ms-war -->
70 - <plugin>
71 - <groupId>de.xima.fc.maven.plugin</groupId>
72 - <artifactId>fc-server-maven-plugin</artifactId>
73 - <version>${fc-server-maven-plugin.version}</version>
74 - <configuration>
75 - <bootstrap>
76 - <pluginManagement>
77 - <deployMavenProject>true</deployMavenProject>
78 - </pluginManagement>
79 - </bootstrap>
80 - </configuration>
81 - </plugin>
82 -
83 - <!-- Configure the compilation process. At least Java 11 is required. -->
84 - <plugin>
85 85   <groupId>org.apache.maven.plugins</groupId>
86 86   <artifactId>maven-compiler-plugin</artifactId>
87 - <version>${maven-compiler-plugin.version}</version>
53 + <version>${maven-compiler-plugin-version}</version>
88 88   <configuration>
89 89   <release>11</release>
90 90   <encoding>UTF-8</encoding>
... ... @@ -93,11 +93,10 @@
93 93   </configuration>
94 94   </plugin>
95 95  
96 - <!-- Configure how the JAR is created, including manifest entries -->
97 97   <plugin>
98 98   <groupId>org.apache.maven.plugins</groupId>
99 99   <artifactId>maven-jar-plugin</artifactId>
100 - <version>${maven-jar-plugin.version}</version>
65 + <version>${maven-jar-plugin-version}</version>
101 101   <configuration>
102 102   <archive>
103 103   <manifest>
... ... @@ -104,59 +104,11 @@
104 104   <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
105 105   </manifest>
106 106   <manifestEntries>
107 - <formcycle-version-requirement>${xfc.version}</formcycle-version-requirement>
108 - <Build-Timestamp>${maven.build.timestamp}</Build-Timestamp>
109 - <Implementation-Title>${project.groupId}:${project.artifactId}</Implementation-Title>
110 - <Implementation-Vendor-Id>${project.groupId}</Implementation-Vendor-Id>
111 - <Implementation-Version>${project.version}</Implementation-Version>
72 + <formcycle-version-requirement>${xfc-version}</formcycle-version-requirement>
112 112   </manifestEntries>
113 113   </archive>
114 114   </configuration>
115 115   </plugin>
116 -
117 - <!-- Build a fat JAR with all dependencies included -->
118 - <plugin>
119 - <groupId>org.apache.maven.plugins</groupId>
120 - <artifactId>maven-assembly-plugin</artifactId>
121 - <version>${maven-assembly-plugin.version}</version>
122 - <executions>
123 - <execution>
124 - <id>fat-jar</id>
125 - <phase>package</phase>
126 - <goals>
127 - <goal>single</goal>
128 - </goals>
129 - <configuration>
130 - <finalName>${project.artifactId}</finalName>
131 - <appendAssemblyId>false</appendAssemblyId>
132 - <descriptorRefs>
133 - <descriptorRef>jar-with-dependencies</descriptorRef>
134 - </descriptorRefs>
135 - <archive>
136 - <manifest>
137 - <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
138 - </manifest>
139 - <manifestEntries>
140 - <formcycle-version-requirement>${xfc.version}</formcycle-version-requirement>
141 - <Build-Timestamp>${maven.build.timestamp}</Build-Timestamp>
142 - <Plugin-Key>${project.groupId}:${project.artifactId}</Plugin-Key>
143 - <Implementation-Title>${project.groupId}:${project.artifactId}</Implementation-Title>
144 - <Implementation-Vendor-Id>${project.groupId}</Implementation-Vendor-Id>
145 - <Implementation-Version>${project.version}</Implementation-Version>
146 - </manifestEntries>
147 - </archive>
148 - </configuration>
149 - </execution>
150 - </executions>
151 - </plugin>
152 -
153 - <!-- Use JUnit to run test classes -->
154 - <plugin>
155 - <groupId>org.apache.maven.plugins</groupId>
156 - <artifactId>maven-surefire-plugin</artifactId>
157 - <version>${maven-surefire-plugin.version}</version>
158 - </plugin>
159 159   </plugins>
160 160   </build>
161 161  </project>
162 -