Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Kommentar: TransactionalJobRule hinzugefügt

...

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

 

Transaktionale Jobs

(ab Nuclos 4.3)

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":

Codeblock
package example.rest; 

import java.util.ArrayList;
import java.util.List;

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

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

@Rule(name="OrderJob", description="Example transactional job rule")
public class OrderJob implements JobRule, TransactionalJobRule {

	public void execute(JobContext context) {
		// encapsulated transaction begin
		Order myOrder = (Order) context.getTransactionalObject();
		// do something ...

		// encapsulated transaction end
	}

	public List<Object> getTransactionalObjects(JobContext context) {
		List<Object> result = new ArrayList<Object>();
		try {
			result.addAll(QueryProvider.getByState(Order.class, ExampleorderSM.State_80));
		} catch (BusinessException e) {
			context.joblogError(e.getMessage());
		}
		return null;
	}
}


Zuweisung

Klassen des Typs "Job" können nur Fristen zugewiesen werden. Nach der Verknüpfung erscheint die Klasse nach Auswahl der Frist und des Typs im Zuweisungsfenster.

...