Definition
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:
- Der Server wird lokal ausgeführt und das codegenerator Verzeichnis befindet sich entsprechend auf dem Entwicklungsrechner, oder es wurden die Parameter CODEGENERATOR_POM_LIBDIR, CODEGENERATOR_POM_AXIS_LIBDIR und CODEGENERATOR_POM_EXTENSION_LIBDIR konfiguriert.
- Der Server wird im Entwicklungsmodus betrieben (Siehe Installation fortgeschritten)
- Eine IDE Ihrer Wahl mit Maven Unterstützung. Hier im Beispiel wird die IntelliJ IDEA Community Edition verwendet.
Stand:
Die aktuelle Anleitung wurde getestet mit Nuclos 4.2024.8 und IntelliJ IDEA 2024.1.1 (Community Edition)
| 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.
|
|
| 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. |
|
Ü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? Dann müssen Sie das SDK neu setzen. Lesen Sie hier wie Sie am besten vorgehen. |
|
Um Konflikte mit dem Nuclos Compiler zu vermeiden (automatisch erzeugte Klassen werden ncht gefunden) sollte die Option "Delegate IDE build/run actions to Maven" aktiviert werden. Eine andere Lösung ist, die Automatische Kompilierung in Nuclos zu deaktivieren, dies erfordert aber ein Neuladen der Regeln vom Dateisystem (siehe nächster Schritt). |
|
Alternativ (ab Nuclos 4.53) können Sie über den Button Importiere Dateiänderungen (Ergebnisliste der Regeln) Änderungen an Dateien direkt eingelesen werden. Dies ist z.B. hilfreich, wenn der Server in einer VM (oder Docker Container) betrieben wird und die automatische Überwachung von Dateiänderungen nicht greift, da die Dateien möglicherweise auf einem "Share" Laufwerk abgelegt werden (im Falle von Docker z.B. auf dem volume /opt/nuclos/home/data/codegenerator) |
|
| Ein kleiner Test für eine zusätzliche Ausgabe in das Server.log war in unserem Beispiel erfolgreich. |
Wichtig, der Server sollte im Hintergrund ausgeführt werden. Nur dann ist sichergestellt, das auch alle verwendeten Bibliotheken gefunden werden.
Die Möglichkeit zu debuggen und die Code Completion einer IDE wird Ihre Produktivität deutlich steigern. Probieren Sie es aus!
Viel Spaß 
Probleme mit der IDE?
Dateikonflikte: Beim gleichzeitigen Arbeiten in Nuclos und der IDE kann es sein, dass Nuclos eine neuere Version einer Regel erzeugt, die die in der IDE gemacht Änderungen rückgängig machen würde. In dem Fall muss der Dateikonflikt zugunsten der in intelliJ bearbeiteten variante aufgelöst werden ("Keep Memory Changes" bzw. Alt+K). Um das Auftreten solcher Konflikte zu reduzieren, kann die Autosave-Funktion von intelliJ weitgehend deaktiviert werden. Änderungen können dann wenn nötig per Strg+S auf das Dateisystem geschrieben werden. |
|
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. |
|
Sie erhalten die obige Fehlermeldung beim kompilieren der Regeln? Dann tragen Sie das JDK erneut ein. Dieser Fehler kann bei einem ganz neuen Projekt oder auch wenn Sie das JDK ändern auftreten. Gehen Sie wie folgt vor: Im Menü File → Poject Structure... aufrufen Das Project SDK einmal leeren mit dem Eintrag <No SDK> → Apply Im Anschluss sollten Ihre Regeln wieder kompilieren. |
Überblick
Inhalte