org.kapott.hbci.callback.HBCICallback.callback()
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 {@link #HAVE_CRC_ERROR} zu beachten!
@param passport enth�lt das Passport-Objekt, bei dessen Benutzung derCallback erzeugt wurde. Falls also in einer Anwendung mehrere Passport-Objekte gleichzeitig benutzt werden, so kann anhand dieses Parameters festgestellt werden, welches Passport (und damit welches HBCIHandle) HBCI4Java gerade benutzt.
@param reason gibt den Grund f�r diesen Aufruf an. Dieser Parameter kannalle 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.
@param msg ein Hinweistext, der den Grund des Callbacks n�her beschreibt.Dieser Parameter muss nicht ausgewertet werden, der Parameter reason ist bereits eindeutig. Er dient nur dazu, bei Anwendungen, die nicht f�r jeden Ursache des Callback-Aufrufes einen eigenen Hinweistext bereitstellen wollen, eine Art default-Wert f�r den anzuzeigenden Text bereitzustellen.
@param datatype legt fest, welchen Datentyp die vom HBCI-Kernel erwartetenAntwortdaten 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).
@param retData In diesem StringBuffer-Objekt m�ssen die Antwortdatenabgelegt werden. Beim Aufruf der Callback-Methode von HBCI4Java wird dieser StringBuffer u.U. mit einem vorgeschlagenen default-Wert f�r die Nutzereingabe gef�llt.