Untergeordnete Seiten
  • Regeln als Maven Projekt in einer IDE einbinden
Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Ab Nuclos v4.30 können Geschäftsregeln einfach als Maven Projekt in einer IDE eingebunden werden. Nuclos generiert hier für automatisch eine pom.xml unter <NUCLOS-HOME>/data/codegenerator

Voraussetzungen:

  1. Der Server wird lokal ausgeführt und das codegenerator Verzeichnis befindet sich entsprechend auf dem Entwicklungsrechner.
  2. Der Server wird im Entwicklungsmodus betrieben (Siehe Installation)
  3. Eine IDE Ihrer Wahl mit Maven Unterstützung. Hier im Beispiel wird die IntelliJ IDEA Community Edition verwendet.


Berechtigung

Es ist auch ratsam Nuclos mit normalen Benutzerrechten zu installieren und zu betreiben, nicht als Dienst. Ansonsten könnte es Probleme mit den Berechtigungen und den Zugriff auf die Dateien geben. Auch kann es unter Umständen helfen das codegenerator Verzeichnis zu löschen und beim nächsten Start vom Server neu erstellen zu lassen.





Neues Projekt anlegen.

Wählen Sie das codegenerator Verzeichnis aus. Normalerweise befindet sich in <NUCLOS-HOME>/data Ihrer Installation.

Intellij erkennt dieses Verzeichnis automatisch als Maven Projekt an.

*Import Maven projects automatically" wurde hier zusätzlich ausgewählt.

Gefundenes codegenerator Projekt bestätigen.

(warning) Wichtig, der Server sollte im Hintergrund ausgeführt werden. Nur dann ist sichergestellt, das auch alle verwendeten Bibliotheken gefunden werden.

Beim ersten Start wird vermutlich noch ein SDK fehlen. Derzeit benötigt Nuclos ein Java JDK der Version 8. Über den Plus-Button können Sie eines hinzufügen. Am besten verwenden Sie das Gleiche womit auch der Server betrieben wird.

So sollte es dann mit ausgewählten SDK aussehen.

Der Name kann so übernommen werden. Schließen Sie den Wizard mit Finish ab.

Im Projekt Fenster können Sie nun zu Ihren bereits geladenen Regeln navigieren. Durch den Import und das Erkennen als Maven Projekt sind bereits alle Abhängigkeiten korrekt gesetzt.

Über das Menü

Run → Attach to Process...

können Sie sich mit dem Server verbinden. Dies ermöglicht einerseits das Debuggen Ihrer Regeln über Breakpoints, als auch Änderungen direkt in die laufenden VM zu übernehmen.

Eine Auswahl mit den laufenden Java Prozessen wird angezeigt. Wählen Sie Ihren Nuclos Server aus. Standardmäßig lautet der Debug Port 8000.

Nun können Sie mit Hilfe von Breakpoints komfortabel Ihre Regeln debuggen.

Damit nicht noch zusätzlich alle Regeln von Nuclos kompiliert werden, sollten Sie die Automatische Kompilierung von Nuclos deaktivieren.

Über das Menü

Build → Build Project...

wird eine Neukompilierung der Regeln angestoßen.

Nach Bestätigen der Rückfrage (siehe Screenshot) werden die geänderten Klassen ohne Umwege sofort an die laufende VM übermittelt. Dies geschieht über den Debug Port.

Die Kompilierung schlägt mit folgender Meldung fehl?
Error: java: JDK isn't specified for module 'codegenerator'

Dann müssen Sie das SDK neu setzen. Lesen Sie hier wie Sie am besten vorgehen.

Ein kleiner Test für eine zusätzliche Ausgabe in das Server.log war in unserem Beispiel erfolgreich.


Die Möglichkeit zu debuggen und die Code Completion einer IDE wird Ihre Produktivität deutlich steigern. Probieren Sie es aus!

Viel Spaß (wink)



Probleme mit der IDE?



Nicht immer erkennt eine IDE schnell genug das sich Sourcecode geändert hat, in diesem Fall sollte ein Reimport durch Maven Abhilfe schaffen.

Ein typisches Beispiel wäre ein Wechsel des Datenbank Schemas mit einem ganz anderem Nuclet, oder nach dem Einspielen eines Datenbank Dumps.


  • Keine Stichwörter