inchorus Scheduler Plugin Dokumentation
1 Einführung #
Das Scheduler Plugin bietet Ihnen die Möglichkeit einen Java Task zu einem bestimmten, wiederkehrenden Zeitpunkt geplant auszuführen.
Folgende Funktionalitäten stehen zur Verfügung:
Freie, minutengenaue Konfiguration des Ausführungszeitpunkts mit dem Crontab Syntax
Starten und Stoppen des Schedulers
Den nächsten Ausführungszeitpunkt abfragen
Das Scheduler Plugin basiert auf dem cron4j Paket.
2 Wie wird das Plugin verwendet? #
Plugin einbinden
Öffnen Sie die Datei pom.xml Ihres inchorus Gadget Projektes und ergänzen Sie folgende Zeilen im Abschnitt "dependencies":
<dependency>
<groupId>de.guh.plugin</groupId>
<artifactId>inchorus-scheduler-plugin</artifactId>
<version>2.0.2</version>
</dependency>Initialisieren und Starten einer Scheduler-Engine
SchedulerEngine schedulerEngine = new SchedulerEngine(
schedule,
task
);
schedulerEngine.start();Folgende Parameter werden mindestens benötigt:
String schedule – Der Ausführungsplan im Crontab Syntax.
Beispielsweise das Pattern
*\2 12 * * *um den Task jeden Tag zwischen 12 Uhr und 13 Uhr zu jeder vollen ungeraden Minute auszuführen.
Task task – Der auszuführende Task.
Die SchedulerEngine bleibt aktiv, solange die Referenz auf ihn gültig ist, i.d.R. bis der aufrufende Prozess bzw. der Server beendet wird.
Scheduler Task
Eine SchedulerEngine erhält genau einen Task, den sie ausführt.
Ein benutzerdefinierter Task erbt von der Klasse Task, die das Runnable Interface implementiert.
Als einzige Voraussetzung muss die Methode run() implementiert werden, um benutzerdefinierten Sourcecode auszuführen.
Diese Methode wird aufgerufen, wenn der Scheduler den Task ausführt.
public class CustomTask extends Task{
@Override
public void run(){
// Anweisungen
}
}3 Weitere Informationen #
Nähere Informationen zu den Klassen und Methoden finden Sie in der API Dokumentation.
Beispiele finden Sie im Ordner Beispiele.
Bei Fragen und Anregungen nutzen Sie unser inchorus Forum.
Dieses Dokument erhalten Sie hier auch als PDF.
4 Ihr Kontakt #
G+H Systems GmbH
Professionell, effizient und zuverlässig.
Ludwigstraße 8
63067 Offenbach am Main
Deutschland
Telefon: +49 (0) 69 85 00 02 - 0
Fax: +49 (0) 69 85 00 02 - 51
Email: info@guh-systems.de
Web: www.guh-systems.de
5 Rechtliche Hinweise #
Die G+H Systems leistet keinerlei Gewähr bezüglich des Inhaltes oder Gebrauchs dieser Dokumentation. Insbesondere werden keine ausdrücklichen oder stillschweigenden Gewährleistungen hinsichtlich der handelsüblichen Qualität oder Eignung für einen bestimmten Zweck übernommen. Die G+H Systems behält sich weiterhin das Recht vor, diese Dokumentation zu revidieren und ihren Inhalt jederzeit und ohne vorherige Ankündigung zu ändern.
Des Weiteren übernimmt die G+H Systems für Software keinerlei Haftung und schließt insbesondere jegliche ausdrücklichen oder impliziten Gewährleistungsansprüche bezüglich der Marktfähigkeit oder der Eignung für einen bestimmten Zweck aus. Außerdem behält sich die G+H Systems das Recht vor, G+H Software ganz oder teilweise jederzeit inhaltlich zu ändern, ohne dass für die G+H Systems die Verpflichtung entsteht, Personen oder Organisationen von diesen Überarbeitungen oder Änderungen in Kenntnis zu setzen.
Copyright © inchorus ist ein Produkt der G+H Systems GmbH
Ohne ausdrückliche, schriftliche Genehmigung des Herausgebers darf kein Teil dieser Veröffentlichung reproduziert, fotokopiert, übertragen oder in einem Speichersystem verarbeitet werden.