Top   Module   Use   Manual   Index 
 EXPORTING SERVICES | METHODS' SUMMARY | METHODS' DETAILS 

com :: sun :: star :: task ::

interface XTaskManager

Base Interface
com::sun::star::uno::XInterface

Description
Ein Instanz dieser Klasse verwaltet alle Auftrge in einem ObjektEnvironment die mit Resourcen zu tun haben. Sie hat die Aufgabe die Auftrge einzuordnen, die Reihenfolge festzulegen, den nebenlufigen Ablauf zu organisieren und Threads zur Auftragsbearbeitung bereitzustellen. Eine Instanz wartet bis neue Auftrge zur Bearbeitung anstehen oder alte Auftrge fertig sind. Mit der Methode insert() knnen neue Auftrge angemeldet werden. Es werden nur transacted oder nicht transacted Auftrge parallel bearbeitet. Es werden also niemals beiden Typen nebenlufig bearbeitet. Es gibt keine Reihenfolge der Auftrge, sie knnen sich also berholen, selbst wenn sie die gleichen Resourcen bentigen. Sie laufen dann natrlich nicht parallel. Deshalb werden transacted Auftrge bevorzugt, da sie im allgemeinen einen zu geringen Resourcebedarf anmelden.
Es wird aber Sichergestellt, da die transaktionsorientierten Auftrge die anderen nicht stren.
See also
com.sun.star.resource.Task
See also
com.sun.star.resource.TaskThread
See also
concepts#Resourcen


Methods' Summary

createResource Es wird eine Resource erzeugt. Die bergebenen Werte knnen whrend der Lebensdauer der Resource nicht gendert werden. Die Resource wird beim Taskmanager angemeldet. The resource must implement XAggregation.
createSimpleTask Erzeugen eines Auftrages mit seinen unvernderlichen Einstellungen. Es gibt allerdings die Ausnahme, da ein Auftrag, wenn er im Zustand isActive() == true ist, auf nicht TRANSACTED umgesetzt wird.
createTask
getRunningTasks
getWaitingTasks
insert Es wird ein Auftrag zur Bearbeitung angemeldet. Es wird nicht sichergestellt, da die Auftrge in der Reihenfolge bearbeitet werden, wie angemeldet werden. Handelt es sich um einen Auftrag mit seinem eigenen Thread, (Task.HASTHREAD gesetzt), dann mu hinter dieser Methode sofort task.schedule() gerufen werden.
terminateTaskAndDepTasks Beendet die Ausfuehrung der bergebenen Task und aller von dieser Task abhngigen Tasks. An allen Tasks, die im Zustand "Running" sind, wird "terminate()" gerufen.
terminateDependendTasks Beendet die Ausfuehrung der von dieser Task abhngigen Tasks.

Methods' Details

createResource
 
com::sun::star::task::XResource
createResource(
[ in ] string Name,
[ in ] com::sun::star::task::XResource Parent );

Description
Es wird eine Resource erzeugt. Die bergebenen Werte knnen whrend der Lebensdauer der Resource nicht gendert werden. Die Resource wird beim Taskmanager angemeldet. The resource must implement XAggregation.
Parameter name
Ein mglichst eindeutiger lesbarer englischer Name fr die Resource.
Parameter parent
Resourcen sind hierarchisch Aufgebaut. The parent may be null.
See also
#Resource(java.lang.String,
com.sun.star.resource.TaskManager)
See also
#getTaskManager()
See also
#getParent()
See also
#getName()
createSimpleTask
 
com::sun::star::task::XTask
createSimpleTask(
[ in ] com::sun::star::task::XSimpleTask aggregateTask,
[ in ] sequence< com::sun::star::task::XResource > resources,
[ in ] sequence< com::sun::star::task::XTask > preTasks );

Description
Erzeugen eines Auftrages mit seinen unvernderlichen Einstellungen. Es gibt allerdings die Ausnahme, da ein Auftrag, wenn er im Zustand isActive() == true ist, auf nicht TRANSACTED umgesetzt wird.
Parameter aName
Ein kurzer sprechender Name fr den Auftrag.
Parameter xResources
Die Liste der Resourcen fr diesen Auftrag. Sie darf nur verndert werden, wenn der Auftrag TRANSACTED ist. Wird Null bergeben, dann bentigt der Auftrag keine Resourcen und es wird eine leere Resourceliste angelegt.
Parameter iTypeFlags
Es kann TRANSACTED, FAST, HASTHREAD und ASYNCHRON bitweise geodert werden.
TRANSACTED steht fr eine transaktionsorientierten Auftrag.
FAST bedeutet, da die Aufhrungszeit kurz ist.
Bei HASTHREAD wird dem Auftrag kein neuer Thread zugeteilt. Es wird der benutzt, mit dem dieser bei der Auftragsverwaltung angemeldet wird.
Ist der Auftrag ASYNCHRON, dann wird die Methode run gerufen, wenn der Auftrag zugeteilt wird.
Parameter preTasks
Das Array mit den Vorgngerauftrgen. Die Auftrge, die vor Aktivierung dieses Auftrags beendet werden mssen, damit dieser aktiviert werden kann.
See also
#run()
See also
#getResources()
See also
#getTypeFlags()
See also
#isActive()
See also
#setActive(boolean)
See also
#isReady()
createTask
 
com::sun::star::task::XTask
createTask(
[ in ] com::sun::star::task::XTask aggregateTask );

getRunningTasks
 
sequence< com::sun::star::task::XTask >
getRunningTasks();
getWaitingTasks
 
sequence< com::sun::star::task::XTask >
getWaitingTasks();
insert
 
void
insert(
[ in ] com::sun::star::task::XTask task );

Description
Es wird ein Auftrag zur Bearbeitung angemeldet. Es wird nicht sichergestellt, da die Auftrge in der Reihenfolge bearbeitet werden, wie angemeldet werden. Handelt es sich um einen Auftrag mit seinem eigenen Thread, (Task.HASTHREAD gesetzt), dann mu hinter dieser Methode sofort task.schedule() gerufen werden.
Parameter task
Dieser Auftrag wird zur Bearbeitung angemeldet.
See also
#ready(com.sun.star.resource.Task)
See also
com.sun.star.resource.Task#schedule()
terminateTaskAndDepTasks
 
void
terminateTaskAndDepTasks(
[ in ] com::sun::star::task::XTask task );

Description
Beendet die Ausfuehrung der bergebenen Task und aller von dieser Task abhngigen Tasks. An allen Tasks, die im Zustand "Running" sind, wird "terminate()" gerufen.
Parameter aTask
Dieser Auftrag wird aus der Verwaltung entfernt.
See also
com.sun.star.resource.Task#needTasks(com.sun.star.resource.Task)
See also
com.sun.star.resource.Task#terminate()
See also
#terminateTaskDependendTasks(com.sun.star.resource.Task)
terminateDependendTasks
 
void
terminateDependendTasks(
[ in ] com::sun::star::task::XTask task );

Description
Beendet die Ausfuehrung der von dieser Task abhngigen Tasks.
Parameter aTask
Dieser Auftrag wird aus der Verwaltung entfernt.
See also
com.sun.star.resource.Task#needTasks(com.sun.star.resource.Task)
See also
com.sun.star.resource.Task#terminate()
See also
#terminateTaskAndDepTasks(com.sun.star.resource.Task)

Top of Page