de.bsvrz.pua.prot.manager.datamanager
Interface DataManagerInterface

All Known Implementing Classes:
DataManager

public interface DataManagerInterface

Schnittstelle des Submoduls Daten Manager. Der Daten Manager übernimmt die Verwaltung der Skriptquelltexte, Skriptobjekte und gespeicherten Protokolle. Außerdem bietet Das Objekt, das diese Schnittstelle implementiert muss das Verzeichnis, in dem Skripte und Protokolle abgelegt werden kennen! Dies muss ggf. über den Konstruktor eingestellt werden können.

Version:
$Revision: 1.2 $ / $Date: 2008/01/22 16:55:50 $ / ($Author: yvonnes $)
Author:
beck et al. projects GmbH, Martin Hilgers

Method Summary
 void addProtocolRequest(ResultData[] resultData)
          Übergeben einer Protokoll-bezogenen Anfrage
 void addScriptRequest(ResultData[] resultData)
          Übergeben einer Skript-bezogenen Anfrage
 void addScriptRequest(ScriptRequest request)
          Übergeben einer Skript-bezogenen Anfrage
 ProtocolOutputStream createProtocolStream(long protocolId, ProcessingParameter pp)
          Erzeugt einen Ausgabestream für ein Protokoll.
 void deleteProtocol(long protocolId)
          Löscht ein gespeichertes Protokoll.
 java.lang.String getAbsolutFileNameMeta(SystemObject script)
          Liefert Pfad und Dateiname der Metainformation
 java.lang.String getAbsolutFileNameSource(SystemObject script)
          Liefert Pfad und Dateiname des Skriptquelltextes
 java.lang.String getFileNameMeta(SystemObject script)
          Liefert den Dateinamen der Metainformationen.
 java.lang.String getFileNameSource(SystemObject script)
          Liefert den Dateinamen des Skriptquelltexts.
 AtlMeta getMetaInformation(SystemObject script)
          Liefert die zum Skript gehörenden Metainformationen.
 java.lang.String getPath()
          Gibt den Pfad der Protokoll- und Skriptdateien zurück.
 ProtocolInputStream getSavedProtocol(long protocolId)
          Liefert ein Objekt zum Zugriff auf ein gespeichertes Protokoll zurück.
 ProtocolInputStream getUnreadProtocol(long protocolId)
          Liefert ein Objekt zum Zugriff auf ein gespeichertes Protokoll zurück.
 DataManagerRequest[] getUpcomingOps(DataManagerRequest[] dmr)
          Liefert eine Liste mit anstehenden Aufgaben.
 boolean isUnique(long protocolId)
          Überprüft ob es zu der gegebenen Protokoll-Id bereits ein gespeichertes Protokoll gibt.
 ProcessingInformation process(ProcessingParameter parameter)
          Startet die Interpretation eines Skriptes.
 ProcessingInformation process(java.lang.String source)
          Startet die Interpretation eines Skriptes.
 void shutdown()
          Fährt den Data-Manager herunter.
 

Method Detail

addScriptRequest

void addScriptRequest(ResultData[] resultData)
Übergeben einer Skript-bezogenen Anfrage

Parameters:
resultData - Objekt mit den Anfrageparametern

addScriptRequest

void addScriptRequest(ScriptRequest request)
Übergeben einer Skript-bezogenen Anfrage

Parameters:
request - Anfrage

addProtocolRequest

void addProtocolRequest(ResultData[] resultData)
Übergeben einer Protokoll-bezogenen Anfrage

Parameters:
resultData - Objekt mit den Anfrageparametern

process

ProcessingInformation process(ProcessingParameter parameter)
                              throws FailureException
Startet die Interpretation eines Skriptes.

Parameters:
parameter - Auftragsparameter
Returns:
Aus dem Skript gewonnene Informationen.
Throws:
FailureException - Fehler beim Interpretieren des Skripts.

process

ProcessingInformation process(java.lang.String source)
                              throws CriticalParserException
Startet die Interpretation eines Skriptes. Dabei werden dem Interpreter keine Aufrufparameter übergeben. Daher können die Daten, die zurückgegeben werden, nicht von der Datenaufbereitung verwendet werden.

Parameters:
source - Source des Skriptobjekts
Returns:
Aus dem Skript gewonnene Informationen
Throws:
CriticalParserException - Fehlermeldung

isUnique

boolean isUnique(long protocolId)
Überprüft ob es zu der gegebenen Protokoll-Id bereits ein gespeichertes Protokoll gibt. Wenn nicht, dann ist die Protokoll-Id eindeutig.

Parameters:
protocolId - Protokoll-Id
Returns:
true falls die protokoll-Id bereits verwendet wurde und das Protokoll auf dem Datenträger gespeichert wurde, false sonst.

getPath

java.lang.String getPath()
Gibt den Pfad der Protokoll- und Skriptdateien zurück. Endet mit File.separator

Returns:
Pfad der Protokoll- und Skriptdateien.

getFileNameMeta

java.lang.String getFileNameMeta(SystemObject script)
Liefert den Dateinamen der Metainformationen.

Parameters:
script - Skriptobjekt
Returns:
Dateiname

getAbsolutFileNameMeta

java.lang.String getAbsolutFileNameMeta(SystemObject script)
Liefert Pfad und Dateiname der Metainformation

Parameters:
script - Skriptobjekt
Returns:
Pfad und Dateiname

getFileNameSource

java.lang.String getFileNameSource(SystemObject script)
Liefert den Dateinamen des Skriptquelltexts.

Parameters:
script - Skriptobjekt
Returns:
Dateiname

getAbsolutFileNameSource

java.lang.String getAbsolutFileNameSource(SystemObject script)
Liefert Pfad und Dateiname des Skriptquelltextes

Parameters:
script - Skriptobjekt
Returns:
Pfad und Dateiname

getMetaInformation

AtlMeta getMetaInformation(SystemObject script)
                           throws FailureException
Liefert die zum Skript gehörenden Metainformationen. Dazu werden die auf der Festplatte gespeicherten Informationen eingelesen. Überprüft zudem die Prüfsumme.

Parameters:
script - Skriptobjekt.
Returns:
Metainformationen oder null falls keine Metainformation existiert.
Throws:
FailureException - Korrupte Metainformation.

shutdown

void shutdown()
Fährt den Data-Manager herunter.


deleteProtocol

void deleteProtocol(long protocolId)
                    throws NoncriticalException
Löscht ein gespeichertes Protokoll.

Parameters:
protocolId -
Throws:
NoncriticalException - Fehler beim Löschen.

getSavedProtocol

ProtocolInputStream getSavedProtocol(long protocolId)
                                     throws FailureException
Liefert ein Objekt zum Zugriff auf ein gespeichertes Protokoll zurück.

Parameters:
protocolId - Id des Protokolls, das gelesen werden soll.
Returns:
Objekt zum Zugriff auf das gespeicherte Protokoll
Throws:
FailureException - Fehler.

getUnreadProtocol

ProtocolInputStream getUnreadProtocol(long protocolId)
                                      throws FailureException
Liefert ein Objekt zum Zugriff auf ein gespeichertes Protokoll zurück.

Parameters:
protocolId - Id des Protokolls, das gelesen werden soll.
Returns:
Objekt zum Zugriff auf das gespeicherte Protokoll.
Throws:
FailureException - Fehler.

createProtocolStream

ProtocolOutputStream createProtocolStream(long protocolId,
                                          ProcessingParameter pp)
                                          throws NoncriticalException
Erzeugt einen Ausgabestream für ein Protokoll.

Parameters:
protocolId - Protokoll-Id.
pp - Auftragsparameter.
Returns:
Stream zum schreiben des Protokolls.
Throws:
NoncriticalException - Die Datei kann nicht angelegt werden; Fehler beim Schreiben der Protokollinformationen.

getUpcomingOps

DataManagerRequest[] getUpcomingOps(DataManagerRequest[] dmr)
Liefert eine Liste mit anstehenden Aufgaben.

Parameters:
dmr - Array, in den das Ergebnis kopiert wird. Ist der Array zu klein, so wird ein neuer Array angelegt.
Returns:
Anstehende Aufgaben.


Copyright © 2005-2008 beck et al. projects GmbH All Rights Reserved.