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.
    • Method Detail

      • addScriptRequest

        void addScriptRequest​(de.bsvrz.dav.daf.main.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​(de.bsvrz.dav.daf.main.ResultData[] resultData)
        Übergeben einer Protokoll-bezogenen Anfrage
        Parameters:
        resultData - Objekt mit den Anfrageparametern
      • process

        ProcessingInformation process​(ProcessingParameter parameter)
                               throws de.bsvrz.sys.funclib.losb.exceptions.FailureException
        Startet die Interpretation eines Skriptes.
        Parameters:
        parameter - Auftragsparameter
        Returns:
        Aus dem Skript gewonnene Informationen.
        Throws:
        de.bsvrz.sys.funclib.losb.exceptions.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​(de.bsvrz.dav.daf.main.config.SystemObject script)
        Liefert den Dateinamen der Metainformationen.
        Parameters:
        script - Skriptobjekt
        Returns:
        Dateiname
      • getAbsolutFileNameMeta

        java.lang.String getAbsolutFileNameMeta​(de.bsvrz.dav.daf.main.config.SystemObject script)
        Liefert Pfad und Dateiname der Metainformation
        Parameters:
        script - Skriptobjekt
        Returns:
        Pfad und Dateiname
      • getFileNameSource

        java.lang.String getFileNameSource​(de.bsvrz.dav.daf.main.config.SystemObject script)
        Liefert den Dateinamen des Skriptquelltexts.
        Parameters:
        script - Skriptobjekt
        Returns:
        Dateiname
      • getAbsolutFileNameSource

        java.lang.String getAbsolutFileNameSource​(de.bsvrz.dav.daf.main.config.SystemObject script)
        Liefert Pfad und Dateiname des Skriptquelltextes
        Parameters:
        script - Skriptobjekt
        Returns:
        Pfad und Dateiname
      • getMetaInformation

        de.bsvrz.sys.funclib.losb.datk.AtlMeta getMetaInformation​(de.bsvrz.dav.daf.main.config.SystemObject script)
                                                           throws de.bsvrz.sys.funclib.losb.exceptions.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:
        de.bsvrz.sys.funclib.losb.exceptions.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 - ProtocolId
        Throws:
        NoncriticalException - Fehler beim Löschen.
      • getSavedProtocol

        ProtocolInputStream getSavedProtocol​(long protocolId)
                                      throws de.bsvrz.sys.funclib.losb.exceptions.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:
        de.bsvrz.sys.funclib.losb.exceptions.FailureException - Fehler.
      • getUnreadProtocol

        ProtocolInputStream getUnreadProtocol​(long protocolId)
                                       throws de.bsvrz.sys.funclib.losb.exceptions.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:
        de.bsvrz.sys.funclib.losb.exceptions.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.