Seitenhistorie
Ab 4.41 unterstützt Nuclos die Entwicklung und Ausführung von Regeln aus Extensions (JAR Bibliothek).
Generierung der Businessobjekt Klassen & Co. in eine Extension
Einstiegspunkt in dieses Thema ist die Generierung der für die Regeln essentiell benötigten Klassen. Hierfür muss ein Environment Parameter DEV_EXTENSION_GENERATOR_OUTPUTDIR beim Starten des Servers mitgegeben werden. Inhalt muss der Pfad zum Maven Modul sein, in dem die von Nuclos automatisch erzeugen Klassen abgelegt werden sollen.
...
Die generierten Sourcen werden unter src/nuclos-generated/java abgelegt, wie in diesem Beispiel zu sehen:
Ablage der Regeln
Die Regeln sollten im Normalfall unter src/main/java abgelegt werden. Auch dieses Verzeichnis wird von Nuclos ignoriert und nicht angefasst.
...
| Info | ||
|---|---|---|
| ||
Sollen vorhandene Regeln überführt werden? Am schnellsten geht es, in dem die Regeln aus dem alten NUCLOS_HOME/data/codegenerator/src-rule Verzeichnis gesichert werden. Es ist denkbar, dass neben der Nuclos API weitere Drittbibliotheken in den Regeln Verwendung finden, oder eine bereits vorhandene Server-Extension. Hierfür müssen in der pom.xml entsprechende Dependencies nachgetragen werden. |
Verwendung der Regeln
Regeln aus einer Extension stehen zur Konfiguration ganz normal zur Verfügung. Können also einem BO, Job etc. zugewiesen werden.
...
| Codeblock | ||||
|---|---|---|---|---|
| ||||
package extension.example.rest;
public class CustomRestTestRuleExtension {} |
Regel Kompilierung
Hier kann die volle Bandbreite des Maven Frameworks eingesetzt werden.
...
Bei Bedarf kann auf viele vom System bereitgestellte Funktion wie AspectJ zurückgegriffen werden, wie im Beispiel der Nuclos Intergrationstest eingestellt: https://bitbucket.org/nuclos/nuclos/src/master/nuclos-integration-tests-rules/pom.xml
Auslieferung einer Regel Extension
Allgemein gibt es 2 Möglichkeiten eine Regel Extension in einem System zu installieren. Grundlegend, also wenn man sich im Standard Java Umfeld und der Nuclos API bewegt, sind beide Verfahren miteinander gleichzusetzen. Jedoch wird eine über einen Nuclos Installer (1. Möglichkeit) installierte Extension vom Spring Framework gleich gefunden, gescannt und geladen. Bei einer Nuclet Extension wird dies erst nachträglich beim Starten des Server durchgeführt, damit ergeben sich Unterschiede beim ClassLoading, welche Nuclos versucht auszugleichen (siehe auch "Weitere Anmerkungen zum ClassLoading" weiter unten).
Wir empfehlen bei einem Verfahren zu bleiben, bzw. das Gleiche beim testen wie auch produktiv einzusetzen!
...
Die Jar Bibliothek kann auch als Extension im Nuclet hinterlegt werden. Unter Nuclet Management das gewünschte Nuclet öffnen und im Reiter Extensions die Datei als Server Extension (Checkbox setzen nicht vergessen!) hochladen. Ein Neustart des Server wird gefordert. Im Anschluss ist diese Extension im exportierten Nuclet enthalten und wird auf einem anderen System mit dem Nuclet Import automatisch installiert (ebenfalls nach einem Neustart).
Codegenerator deaktivieren
Der Standard Codegenerator kann mit dem Systemparameter CODEGENERATOR_ENABLED (Wert: false) komplett deaktiviert werden. Damit zwingt man ein System nur noch Regeln aus Extensions zu verwenden. Ein eingestellter Environment Parameter DEV_EXTENSION_GENERATOR_OUTPUTDIR (siehe oben) ist hiervon nicht betroffen und bleibt für die Entwicklung aktiv.
Weitere Anmerkungen zum ClassLoading
Wie unter dem Punkt der Auslieferung bereits angedeutet sind bereits ein paar Unterschiede bekannt die hier beschrieben werden. Diese Liste darf gerne um weitere Erfahrungen erweitert werden 
...
Überblick
Inhalte