# Package org.kapott.hbci.status

package org.kapott.hbci.status

Dieses Paket enthält Klassen, die Status-Informationen zu einzelnen Aufträgen, Nachrichten oder Dialogen bereitstellen. Diese Status-Informationen werden an verschiedenen Stellen zurückgegeben.

Zum einen wird beim Ausführen eines HBCI-Dialoges ein Objekt der Klasse HBCIDialogStatus zurückgegeben, anhand dessen sämtliche Status-Informationen, die während der Dialogausführung aufgelaufen sind, ausgewertet werden können.

Außerdem werden in jedem Objekt, welches Rückgabedaten für einen Geschäftsvorfall enthält (siehe HBCIJobResult), die Statusinformationen gespeichert, die konkret diesen Geschäftsvorfall betreffen. Dazu wird ein Objekt der Klasse HBCIStatus verwendet.

Innerhalb einer Anwendung reicht i.d.R. die Anwendung der im folgenden Beispiel gezeigten Methoden aus:

    // initialize HBCI-stuff here
    ...

    // add a business task
    HBCIJob jobSaldo=hbciHandle.newJob("SaldoReq");
    jobSaldo.setParam("my",myAccount);
    hbciHandle.addJob(jobSaldo);

    // add more business tasks here
    ...

    // execute dialog
    HBCIDialogStatus dialogStatus=hbciHandler.execute();

    // print information about complete dialog
    if (!dialogStatus.isOK()) {
        System.out.println("some error has occured during execution of the HBCI dialog:");
        System.out.println(dialogStatus.getErrorString());
    }

    // check each business task
    if (jobSaldo.getJobResult().isOK()) {
        System.out.println("saldo information for account "+myAccount);
        System.out.println(jobSaldo.getJobResult().toString());
    } else {
        System.out.println("an error occured in task SaldoRequest");
        System.out.println(jobSaldo.getJobResult().jobStatus.getErrorString());
    }

    ...

Classes
Class
Description
HBCIDialogStatus
Status-Informationen für einen kompletten HBCI-Dialog.
HBCIExecStatus
Statusinformationen über alle ausgeführten Dialoge.
HBCIExecThreadedStatus
Wird für Status-Informationen bei Verwendung des threaded-callback-Mechanismus' benötigt.
HBCIInstMessage
HBCIMsgStatus
Enthält alle Status-Informationen zu genau einem Nachrichtenaustausch.
HBCIRetVal
Repräsentation eines HBCI-Statuscodes.
HBCIStatus
Menge zusammengehöriger Status-Informationen.