Sprache: Deutsch · English

Event - Job

...

Allgemein

Regeln des Typs "Job" können nur Fristen zugewiesen werden und müssen das Interface "JobRule" implementieren.

Innerhalb des Baums mit der Regelbibliothek werden sie dem Knoten "Job" zugeschrieben.

Struktur

Quellcode einer Klasse des Typs "Job":

...

Wann greift die Regel?

Diese serverseitige Regel wird ausgeführt zeitgesteuert durch einen Job/Timer. Sie kann einem Timer/Job zugewiesen werden.

Struktur

Grundgerüst der Regelklasse (der Regeleditor legt es automatisch an):

package org.nuclet.lager; 

import org.nuclos.api.rule.JobRule; 
import org.nuclos.api.context.JobContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 

/** @name        
  * @description 
  * @usage       
  * @change      
*/

@Rule(name="Job Lager", description="Job Lager")
public class JobLager implements JobRule {
   
 public void execute(JobContext context) { 

//So werden Logs während des Ausführen in den Reiter Log Info in der Jobsteuerung geschrieben
 			context.joblog(e.getMessage());
            context.joblogError("TEST");
            context.joblogWarn("Warnung");
    }
}

...

Das entsprechende Interface schreibt die Implementierung der Methode "execute" vor und liefert als Kontext die Klasse JobContext. Darin enthalten ist die Session-Id. 

Innerhalb der execute-Methode kann der Regelprogrammierer auch eine BusinessException auslösen, die zwar geloggt wird, aber nicht zum Abbruch der Jobdurchführung führt.

Die Angabe der Annotation "Rule" ist nicht zwingend notwendig, wird aber empfohlen, da die Beschreibungen (name und description) im Regelbibliotheksbaum angezeigt werden.

Transaktionale Jobs

Normalerweise wird die gesamte Verarbeitung des Jobs in nur einer Transaktion ausgeführt. Wenn man die Verarbeitung auf mehrere Transaktionen verteilen möchte muss das Interface TransactionalJobRule zusätzlich implementiert werden. Die Methode getTransactionalObjects(JobContext context) liefert eine Liste vom Typ Object wobei nun für jedes Element in der Liste eine eigene Transaktion eröffnet wird. Dabei wird für jedes Object die Methode execute(JobContext context) aufgerufen. Das Object kann vom JobContext mittels .getTransactionalObject() abgeholt werden.

Struktur TransactionalJobRule

Quellcode einer Klasse des Typs "Job" mit "TransactionalJobRule":

...

Zuweisung

Im Server-Regelmanager per Drag-and-Drop dem Ziel zuweisen. Optional lässt sich die Ausführung auf einen Status oder eine Aktion einschränken; die Reihenfolge steuerst du über die Pfeil-Buttons.

Image Added

Zuweisung „Job“.

Beispiel

Das folgende Beispiel soll den Aufbau einer Regel vom Typ „Job„ veranschaulichen.

package org.nuclet.company; 

import java.util.

...

List;

import org.nuclos.api.annotation.Rule;
import org.nuclos.api.context.JobContext

...

;
import org.nuclos.api.provider.QueryProvider;
import org.nuclos.api.rule.JobRule;

...

...

/** @name        
  * @description 
  * @usage       
  * @change      
*/

...

@Rule(name="

...

JobBestellungenPruefen", description="

...

JobBestellungenPruefen")
public class 

...

JobBestellungenPruefen implements JobRule

...

...

{

...

    public void execute(JobContext context){ 

...

        // 

...

Get 

...

all 

...

Bestellungen
        List<Bestellung> lstBestellungen = QueryProvider.execute(
                QueryProvider.create(Bestellung.class));
        
        for (Bestellung b : lstBestellungen) {
            // orders that are not confirmed are ok, but should be logged as infos
            if (Boolean.FALSE.equals(b.getBestaetigt())) {
                context.joblog("Info: Bestellung " + b.getNummer() + " wurde noch nicht bestätigt.");
            }
            
            // orders without articles are formally valid, but dont make sense
            if (b.getPosition().size() <= 0) {
                context.joblogWarn("Warnung: Bestellung " + b.getNummer() + " besitzt keine Positionen");
            }
            
            // orders without an internal advisor are formally invalid 
            if (b.getSachbearbeiter() == null) {
                context.joblogError("Fehler: Bestellung " + b.getNummer() + " besitzt keinen Sachbearbeiter");
            }
                        
        }
        
    }
}

Verwandte Seiten