Seitenhistorie
...
CKONTO_CHECK: legt fest, ob eine Kontoprüfung über die cKonto-Schnittstelle erfolgen soll
CKONTO_KEY: definiert den Authentifizierungsschlüssel für die cKonto-Schnittstelle; der Default-Wert für Testzwecke ist „demo“
| Codeblock | ||||
|---|---|---|---|---|
| ||||
public class CkontoUtils
{
private static final String CKONTO_KEY = "demo"; // Authentifizierungsschlüssel
private static final String CKONTO_CHECK = "Y"; // Soll eine Kontovalidierung durchgeführt werden?
(...)
} |
...
Das nun folgende Beispiel dient der Veranschaulichung dieser Einbindung.
| Codeblock | ||||
|---|---|---|---|---|
| ||||
(...)
org.nuclet.ckonto.CkontoCheck check = null;
org.nuclet.ckonto.CkontoConstants.Status status = null;
try {
// Übergabe einer Kontonummer und einer Bankleitzahl an die cKonto-Validierung...
check = org.nuclet.ckonto.CkontoUtils.validiereKontoverbindung(strKontonummer, strBankleitzahl);
} catch (javax.xml.bind.JAXBException jaxbe) {
// eigene Fehlerbehandlung einsetzen
// (...)
} catch (java.net.MalformedURLException me) {
// eigene Fehlerbehandlung einsetzen
// (...)
}
status = org.nuclet.ckonto.CkontoConstants.Status.valueOf("STATUS_" + Check.getStatus().toString());
if (!org.nuclet.ckonto.CkontoConstants.Status.STATUS_1.equals(status)) {
// eigener Code, zur Verarbeitung der Status-Informationen
// (...)
}
(...) |
Die Enumeration-Klasse CkontoConstants umfasst alle möglichen Rückgabewerte der cKonto-Schnittstelle, so dass eine einfache Einordnung über den Enumeration-Vergleich möglich ist.
| Codeblock | |||
|---|---|---|---|
| |||
| |||
public class CkontoConstants
{
public enum Status
{
STATUS_0(0, "Die Kontonummer ist ungültig, sie kann von diesem Institut nicht vergeben werden."),
STATUS_1(1, "Die Kontonummer ist gültig, sie kann von diesem Institut vergeben werden."),
STATUS_2(2, "Fehler bei der Eingabe der Bankleitzahl. Sie ist entweder nicht 8-stellig oder enthält Buchstaben."),
STATUS_3(3, "Fehler bei der Eingabe der Kontonummer. Sie ist entweder zu lang oder enthält Buchstaben."),
STATUS_4(4, "Eingabefehler bei der Kontonummer und Bankleitzahl (siehe 2 und 3) oder der IBAN."),
STATUS_5(5, "Genereller Eingabefehler des Übergabeparameters - enthält evtl. Leerzeichen."),
STATUS_6(6, "Fehler im Format des Übergabeparameters."),
STATUS_7(7, "Die Bankleitzahl wurde in der Datenbank nicht gefunden (existiert nicht)."),
STATUS_8(8, "Die von der Bank verwendete Prüfmethode ist im Demonstrations-Modus nicht verfügbar."),
STATUS_9(9, "Die Kontonummer kann nicht geprüft werden, da die Bank entweder keine Prüfziffern verwendet oder es sich um eine spezielle Kontonummer handelt.");
(...)
} |
...
Soll zusätzlich die Möglichkeit genutzt werden, die Validierung (temporär) zu deaktivieren, dann empfielt es sich, den Validierungsaufruf mit einem Aufruf der Methode istKontovalidierungAktiviert() zu kombinieren.
...
Überblick
Inhalte