Veränderungen des Inhalts
Klicken Sie für eine detaillierte Beschreibung auf die geänderten Stellen:
Benutzen sie die linke oder die rechte Maustaste, um zur jeweils vorherigen bzw. nachfolgenden Änderung zu gelangen.
Job Java Job
Zweck
Der
Purpose
The Java Job kompiliert beziehungsweise lädt eine konfigurierbare Java-Klasse zur Laufzeit und führt deren öffentliche Methode compiles or loads a configurable Java class at runtime and executes its public method run() aus. Dadurch können kundenspezifische Erweiterungen innerhalb der Webdesk-Laufzeit ausgeführt werden. Im mitgelieferten Job-Descriptor ist der Job konfigurierbar, aber standardmäßig nicht aktiv.
Voraussetzungen und Sicherheit
-
Die konfigurierte Klasse benötigt einen öffentlichen parameterlosen Konstruktor und eine öffentliche Methode
run().
-
Der Code läuft innerhalb der Webdesk-Anwendung und kann auf verfügbare Webdesk-Services und Daten zugreifen. Es darf daher nur geprüfter und vertrauenswürdiger Quellcode verwendet werden.
-
Für die dynamische Kompilierung muss die Laufzeit in einer JDK-Installation mit verfügbarem Java-Compiler ausgeführt werden.
-
Fehlt eine kompilierte Klasse und soll Quellcode kompiliert werden, muss die Option Write JAVA source file aktiviert sein.
Konfiguration
| Feld | Bedeutung |
Filename (including package declaration) | Vollqualifizierter Klassenname einschließlich Paket, zum Beispiel
. This allows customer-specific extensions to be executed within the Webdesk runtime. In the job descriptor that ships with the product, the job is configurable but not active by default.
Prerequisites and security
-
The configured class requires a public no-argument constructor and a public method
run().
-
The code runs within the Webdesk application and can access available Webdesk services and data. Only reviewed and trustworthy source code may therefore be used.
-
For dynamic compilation, the runtime must be executed in a JDK installation with an available Java compiler.
-
If a compiled class is missing and source code is to be compiled, the option Write JAVA source file must be activated.
Configuration
| Filename (including package declaration) | Fully qualified class name including package, for example at.workflow.webdesk.custom.jobs.TestSystemOut. Daraus werden Pfad und FileName abgeleitet. |
| JAVA source | Der vollständige Quellcode der kundenspezifischen Klasse. |
| Use a transaction | Legt fest, ob der kundenspezifische Job innerhalb einer Datenbanktransaktion ausgeführt wird. Die Einstellung wird bereits vor dem eigentlichen Lauf aus der Job-Konfiguration gelesen. |
| Write JAVA source file | Schreibt den Quellcode unter The path and FileName are derived from it. |
| JAVA source | The complete source code of the customer-specific class. |
| Use a transaction | Determines whether the customer-specific job is executed within a database transaction. The setting is read from the job configuration before the actual run. |
| Write JAVA source file | Writes the source code to the Java file matching the package structure under WEB-INF/work/runtime in die zur Paketstruktur passende Java-Datei. |
Ausführung
Die Job-Konfiguration wird vor dem Start gelesen.
Wenn
Execution
-
The job configuration is read before the start.
-
If Write JAVA source file aktiviert ist, wird der Quellcode im Runtime-Verzeichnis gespeichert.
-
Der Klassenlader verwendet zuerst eine bereits verfügbare Klasse. Andernfalls lädt er eine vorhandene kompilierte Klasse aus dem Runtime- beziehungsweise Klassenverzeichnis oder kompiliert den hinterlegten Quellcode.
-
Die geladene Klasse wird instanziiert und ihre Methode
run() ausgeführt.
Unterbrechen
Der Webdesk-Job ist unterbrechbar. Damit auch der kundenspezifische Code auf eine Unterbrechung reagieren kann, muss die Klasse zusätzlich eine öffentliche Methode interrupt() bereitstellen. Ohne diese Methode kann der kundenspezifische Code nicht zuverlässig unterbrochen werden.
Fehlerdiagnose
Ist weder eine erreichbare kompilierte Klasse noch eine passende Quelldatei vorhanden, schlägt das Laden fehl.
Bei Kompilierungsfehlern werden die Compilerfehler als Jobfehler weitergegeben.
Prüfen Sie bei Fehlern den vollqualifizierten Klassennamen, die Paketstruktur, die Option Write JAVA source file, den verfügbaren JDK-Compiler und das Job-Log
-
is activated, the source code is saved in the runtime directory.
-
The class loader first uses a class that is already available. Otherwise it loads an existing compiled class from the runtime or class directory, or compiles the stored source code.
-
The loaded class is instantiated and its method
run() is executed.
Interrupting
The Webdesk job is interruptible. So that the customer-specific code can also react to an interruption, the class must additionally provide a public method interrupt(). Without this method, the customer-specific code cannot be reliably interrupted.
Troubleshooting
-
If neither a reachable compiled class nor a matching source file exists, loading fails.
-
In the case of compilation errors, the compiler errors are passed on as job errors.
-
In the event of errors, check the fully qualified class name, the package structure, the option Write JAVA source file, the available JDK compiler and the job log.
erste
