org.kapott.hbci.callback

Class AbstractHBCICallback

java.lang.Object

org.kapott.hbci.callback.AbstractHBCICallback

All Implemented Interfaces:

HBCICallback

Direct Known Subclasses:

HBCICallbackIOStreams

public class AbstractHBCICallback
extends Object
implements HBCICallback

Field Summary

Fields inherited from interface org.kapott.hbci.callback.HBCICallback

CLOSE_CONNECTION, HAVE_CHIPCARD, HAVE_CRC_ERROR, HAVE_ERROR, HAVE_HARDPIN, HAVE_IBAN_ERROR, HAVE_INST_MSG, NEED_BLZ, NEED_CHIPCARD, NEED_CONNECTION, NEED_COUNTRY, NEED_CUSTOMERID, NEED_HARDPIN, NEED_HOST, NEED_INFOPOINT_ACK, NEED_PASSPHRASE_LOAD, NEED_PASSPHRASE_SAVE, NEED_PORT, NEED_PROXY_PASS, NEED_PROXY_USER, NEED_PT_PHOTOTAN, NEED_PT_PIN, NEED_REMOVE_CHIPCARD, NEED_SIZENTRY_SELECT, NEED_SOFTPIN, NEED_USERID, STATUS_DIALOG_END, STATUS_DIALOG_END_DONE, STATUS_DIALOG_INIT, STATUS_DIALOG_INIT_DONE, STATUS_INIT_SIGID, STATUS_INIT_SIGID_DONE, STATUS_INIT_SYSID, STATUS_INIT_SYSID_DONE, STATUS_INIT_UPD, STATUS_INIT_UPD_DONE, STATUS_INST_BPD_INIT, STATUS_INST_BPD_INIT_DONE, STATUS_INST_GET_KEYS, STATUS_INST_GET_KEYS_DONE, STATUS_LOCK_KEYS, STATUS_LOCK_KEYS_DONE, STATUS_MSG_CREATE, STATUS_MSG_CRYPT, STATUS_MSG_DECRYPT, STATUS_MSG_PARSE, STATUS_MSG_RAW_RECV, STATUS_MSG_RAW_SEND, STATUS_MSG_RECV, STATUS_MSG_SEND, STATUS_MSG_SIGN, STATUS_MSG_VERIFY, STATUS_SEND_INFOPOINT_DATA, STATUS_SEND_KEYS, STATUS_SEND_KEYS_DONE, STATUS_SEND_TASK, STATUS_SEND_TASK_DONE, TYPE_BOOLEAN, TYPE_NONE, TYPE_SECRET, TYPE_TEXT, USERID_CHANGED, WRONG_PIN

Constructor Summary

Constructors

Constructor and Description
AbstractHBCICallback()

Method Summary

Modifier and Type	Method and Description
void	callback(int reason, List<String> messages, int datatype, StringBuilder retData) Wird vom HBCI-Kernel aufgerufen, wenn die Interaktion mit der Anwendung erforderlich ist.
String	needTAN()
void	status(int statusTag, Object o) Kurzform für HBCICallback.status(int, Object[]) für den Fall, dass das Object[] nur ein einziges Objekt enthält
void	status(int statusTag, Object[] o) Wird vom HBCI-Kernel aufgerufen, um einen bestimmten Status der Abarbeitung bekanntzugeben.
void	tanChallengeCallback(String orderRef, String challenge, String challenge_hhd_uc, HHDVersion.Type type)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractHBCICallback

public AbstractHBCICallback()

Method Detail

callback

public void callback(int reason,
                     List<String> messages,
                     int datatype,
                     StringBuilder retData)

Description copied from interface: HBCICallback

Wird vom HBCI-Kernel aufgerufen, wenn die Interaktion mit der Anwendung erforderlich ist. In bestimmten Situationen benötigt der HBCI-Kernel zusätzliche Daten bzw. muss auf die Ausführung einer Aktion des Nutzers warten. Dann wird diese Methode aufgerufen. Dabei wird ein Code (reason) übergeben, der anzeigt, welche Ursache dieser Callbackaufruf hat, d.h. welche Daten oder Aktionen erwartet werden. Falls Daten erwartet werden (z.B. ein Passwort, eine Benutzerkennung, ...), so ist legt der Parameter datatype fest, wie diese Daten erwartet werden. Die eigentlichen Daten muss die Anwendung im Objekt retData ablegen (keinen neuen StringBuffer erzeugen, sondern den Inhalt von retData überschreiben!). Bei einigen Callbacks übergibt HBCI4Java einen vorgeschlagenen default-Wert für die Nutzereingabe im retData-Objekt. Diese Tatsache ist besonders bei der Auswertung des Callbacks HBCICallback.HAVE_CRC_ERROR zu beachten!

Specified by:

callback in interface HBCICallback

Parameters:

reason - gibt den Grund für diesen Aufruf an. Dieser Parameter kann alle Werte annehmen, die als "Ursache des Callback-Aufrufes" in der Dokumentation aufgeführt sind. Je nach Wert dieses Parameters werden vom Nutzer Aktionen oder Eingaben erwartet.

datatype - legt fest, welchen Datentyp die vom HBCI-Kernel erwarteten Antwortdaten haben müssen. Ist dieser Wert gleich TYPE_NONE, so werden keine Antwortdaten (also keine Nutzereingabe) erwartet, bei TYPE_SECRET und TYPE_TEXT wird ein normaler String erwartet.
Der Unterschied zwischen beiden ist der, dass bei TYPE_SECRET sensible Daten (Passwörter usw.) eingegeben werden sollen, so dass die Eingaberoutine evtl. anders arbeiten muss (z.B. Sternchen anstatt dem eingegebenen Text darstellen).

retData - In diesem StringBuffer-Objekt müssen die Antwortdaten abgelegt werden. Beim Aufruf der Callback-Methode von HBCI4Java wird dieser StringBuffer u.U. mit einem vorgeschlagenen default-Wert für die Nutzereingabe gefüllt.

tanChallengeCallback

public void tanChallengeCallback(String orderRef,
                                 String challenge,
                                 String challenge_hhd_uc,
                                 HHDVersion.Type type)

Specified by:

tanChallengeCallback in interface HBCICallback

needTAN

public String needTAN()

Specified by:

needTAN in interface HBCICallback

status

public void status(int statusTag,
                   Object[] o)

Description copied from interface: HBCICallback

Wird vom HBCI-Kernel aufgerufen, um einen bestimmten Status der Abarbeitung bekanntzugeben.

Specified by:

status in interface HBCICallback

Parameters:

statusTag - gibt an, welche Stufe der Abarbeitung gerade erreicht wurde (alle oben beschriebenen Konstanten, die mit STATUS_ beginnen)

o - ein Array aus Objekten, das zusätzliche Informationen zum jeweiligen Status enthält. In den meisten Fällen handelt es sich um einen String, der zusätzliche Informationen im Klartext enthält. Welche Informationen das jeweils sind, ist der Beschreibung zu den einzelnen STATUS_*-Tag-Konstanten zu entnehmen.

status

public void status(int statusTag,
                   Object o)

Description copied from interface: HBCICallback

Kurzform für HBCICallback.status(int, Object[]) für den Fall, dass das Object[] nur ein einziges Objekt enthält

Specified by:

status in interface HBCICallback