ch.elexis.actions
Class JobPool

java.lang.Object
  ch.elexis.actions.JobPool

All Implemented Interfaces:

BackgroundJob.BackgroundJobListener

Deprecated. Neuer Code sollte das Eclipse Job API verwenden

@Deprecated
public class JobPool
extends java.lang.Object
implements BackgroundJob.BackgroundJobListener

Ein Sammelbecken für Background-Jobs. Der JobPool steuert den Ablauf der Jobs: Er achtet darauf, dass derselbe Job nicht mehrmals gleichzeitig gestartet wird, und dass nicht zuviele Jobs parallel laufen. Dafür können Jobs in eine Warteschlange eingereiht werden, wo sie nacheinander abgearbeitet werden. Die Priorität der Jobs wird aus org.eclipse.core.runtime.jobs.Job entnommen. Die Werte bedeuten:

• Job.INTERACTIVE: Höchste Priorität, nur für kurzlaufende Jobs, die ummittelbare Auswirkung auf die Benutzeroberfläche haben.
• Job.SHORT: Hohe Priorität, für Jobs die höchstens ein bis zwei Sekunden laufen, und auf die der Anwender wartet
• Job.LONG: Mittlere Priorität für Jobs, die mehrere Sekunden lang laufen, und die deshalb die Benutzeroberfläche nicht beeinträchtigen sollen
• Job.DECORATE; Niedrigste Priorität für allgemeine Hintergrundjobs, die nur laufen, wenn sonst nichts zu tun ist

Author:

gerry

See Also:

BackgroundJob, BackgroundJob

Method Summary

boolean	activate(java.lang.String name, int priority) Deprecated. Einen Job starten
boolean	addJob(BackgroundJob job) Deprecated. Einen neuen Job hinzufügen.
void	dispose() Deprecated.
BackgroundJob	getJob(java.lang.String name) Deprecated. Einen Job anhand seines Namens finden
static JobPool	getJobPool() Deprecated. Den JobPool erzeugen bzw. holen.
void	jobFinished(BackgroundJob j) Deprecated. Diese Funktion ist für internen Gebrauch.
void	queue(java.lang.String name) Deprecated. Einen Job in die Warteschlange setzen.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

dispose

public void dispose()

Deprecated.

getJobPool

public static JobPool getJobPool()

Deprecated.

Den JobPool erzeugen bzw. holen. Es soll nur einen geben, deswegen als Singleton implementiert

addJob

public boolean addJob(BackgroundJob job)

Deprecated.

Einen neuen Job hinzufügen. Ein Job bleibt im Pool bis zum Programmende. Er hat entweder den Status running, waiting oder queued. Jobs, die waiting oder queued sind, brauchen keine Systemressourcen. addJob lässt den Job zunächst im status waiting

Parameters:

job - der Job

Returns:

true wenn erfolgreich, false wenn dieser Job oder ein Job gleichen Namens schon im Pool ist oder bei einem sonstigen Fehler.

getJob

public BackgroundJob getJob(java.lang.String name)

Deprecated.

Einen Job anhand seines Namens finden

Parameters:

name - Name des Jobs

Returns:

den Job oder null, wenn nicht vorhanden.

activate

public boolean activate(java.lang.String name,
                        int priority)

Deprecated.

Einen Job starten

Parameters:

name - Name des Jobs

priority - gewpnschte Priorität (Job.INTERACTIVE bis JOB.DECORATIONS)

Returns:

true wenn der Job gestartet wurde, d.h. er läuft dann noch bei Rückkehr dieser Funktion. false, wenn der Job schon lief, oder wenn er nicht gefunden wurde.

queue

public void queue(java.lang.String name)

Deprecated.

Einen Job in die Warteschlange setzen. Er wird gestartet, sobald ein eventuell schon laufender Job beendet ist.

Parameters:

name - Name des Jobs

jobFinished

public void jobFinished(BackgroundJob j)

Deprecated.

Diese Funktion ist für internen Gebrauch. Organisation der Warteschlange

Specified by:

jobFinished in interface BackgroundJob.BackgroundJobListener