org.kapott.hbci.structures.Konto Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of hbci4j-core Show documentation
Show all versions of hbci4j-core Show documentation
HBCI4j - Home Banking Computer Interface for Java
/* $Id: Konto.java,v 1.1 2011/05/04 22:37:49 willuhn Exp $
This file is part of HBCI4Java
Copyright (C) 2001-2008 Stefan Palme
HBCI4Java is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
HBCI4Java is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.kapott.hbci.structures;
import java.io.Serializable;
import java.util.List;
import org.kapott.hbci.manager.HBCIUtils;
/** Kontoverbindung.
Diese Klasse repräsentiert eine einzelne Kontoverbindung
eines Kunden bei einer Bank. */
public class Konto
implements Serializable
{
/** Länderkennzeichen des Kontos.
Normalerweise ist hier der Wert DE für
Deutschland einzustellen. */
public String country;
/** Bankleitzahl der kontoführenden Bank */
public String blz;
/** Kontonummer des Kontos */
public String number;
/** Unterkontomerkmal des Kontos, kann null sein */
public String subnumber;
/** Kontoart (Girokonto, Sparkonto, Festgeldkonto, Kreditkartenkonto, etc.)
laut Segmentversion 5,6 von HIUPD.
Wird bspw. bei DeuBa-Konten benötigt da dort verschiedene Konten genau die gleiche
Kontonummer haben bzw. sich nur in der Kontoart unterscheiden */
public String acctype;
/** Name (Typ) des Kontos. Dieses Feld ist nur für
Konten verfügbar, auf die der Anwender via HBCI Zugriff
hat. Für alle anderen Konten ist dieser Wert null */
public String type;
/** Währung des Kontos. Hier ist in der Regel EUR
für EURO gespeichert. */
public String curr;
/** Kreditinstitusseitiger Kundenname. Dieser Wert gibt an, unter
welcher Kunden-ID ein Bankkunde Zugriff auf dieses Konto hat.
Dieser Wert ist nur für Konten verfügbar, auf die der Anwender
Zugriff via HBCI hat, für alle anderen Konten ist dieser
Wert null. Falls eine Bank Informationen über alle
Konten bereitstellt, auf die ein Nutzer via HBCI Zugriff hat, so
kann dieses Feld beim Hinzufügen von Aufträgen via
{@link org.kapott.hbci.GV.HBCIJob#addToQueue(String)}
ausgewertet werden. */
public String customerid;
/** Name des Kontoinhabers. Hier wird bei eigenen Konten der
Inhabername eingestellt, wie er von der Bank bereitgestellt wird.
Bei fremden Konten (z.B. bei den Konten, die als Gegenkonten auf
einem Kontoauszug erscheinen) wird hier der Name eingestellt,
wie er in den Auftragsdaten von der Bank geführt wird. */
public String name;
/** Name des Kontoinhabers (Fortsetzung) (optional). */
public String name2;
public Limit limit;
public List allowedGVs;
/** BIC des Kontos */
public String bic;
/** IBAN des Kontos */
public String iban;
/** Anlegen eines neuen Konto-Objektes. Die Währung wird auf EUR voreingestellt */
public Konto()
{
this.curr="EUR";
}
/** Anlegen eines neuen Konto-Objektes. Die Währung wird auf EUR
voreingestellt. Es werden BLZ und Kontonummer angegeben. Die Länderkennung
wird auf DE voreingestellt.
@param blz Bankleitzahl der kontoführenden Bank
@param number Kontonummer des Kontos */
public Konto(String blz,String number)
{
this("DE",blz,number);
}
/** Anlegen eines neuen Konto-Objektes. Die Währung wird auf EUR
voreingestellt. Es werden BLZ, Länderkennung und Kontonummer angegeben.
@param country die Länderkennung des kontoführenden Institutes (normalerweise DE)
@param blz Bankleitzahl der kontoführenden Bank
@param number Kontonummer des Kontos */
public Konto(String country,String blz,String number)
{
this(country,blz,number,null);
}
// TODO: doku fehlt
public Konto(String country,String blz,String number,String subnumber)
{
this();
this.country=country;
this.blz=blz;
this.number=number;
this.subnumber=subnumber;
}
/** Umwandeln der Kontoinformationen in einen String.
@return Stringdarstellung der Kontoverbindung */
public String toString()
{
StringBuffer ret=new StringBuffer();
if (type!=null) {
ret.append(type+" ");
}
if (name!=null) {
ret.append(name+" ");
}
if (name2!=null) {
ret.append(name2+" ");
}
if (number!=null) {
ret.append(number);
}
if (subnumber!=null) {
ret.append("/"+subnumber);
}
ret.append(" ");
if (blz!=null) {
ret.append("BLZ "+blz+" ("+HBCIUtils.getNameForBLZ(blz)+") ");
}
if (bic!=null) {
ret.append("BIC "+bic+" ");
}
if (iban!=null) {
ret.append("IBAN "+iban+" ");
}
if (country!=null) {
ret.append("["+country+"] " );
}
if (curr!=null) {
ret.append("("+curr+")");
}
return ret.toString();
}
/** Überprüfen der Kontonummer anhand des Prüfzifferverfahrens, welche für
die Bank mit der Bankleitzahl blz gilt. Der Aufruf dieser
Methode setzt voraus, dass in diesem Kontoobjekt bereits blz
und number gesetzt sind. Diese Werte werden der Methode
{@link org.kapott.hbci.manager.HBCIUtils#checkAccountCRC(String,String)}
zur Überprüfung übergeben.
@return es wird nur dann false zurückgegeben, wenn das Prüfzifferverfahren
für die jeweilige Bank implementiert ist und die Prüfung der Kontonummer einen
Fehler ergibt. In jedem anderen Fall wird true zurückgegeben */
public boolean checkCRC()
{
return HBCIUtils.checkAccountCRC(blz,number);
}
// TODO: doku fehlt
public boolean checkIBAN()
{
return HBCIUtils.checkIBANCRC(iban);
}
public boolean equals(Object o)
{
boolean ret;
if (o instanceof Konto) {
Konto acc=(Konto)o;
ret=true;
// TODO: wenn this.blz==null und acc.blz!=null ist gibts ne exception
ret&=(this.blz==null && acc.blz==null || this.blz.equals(acc.blz));
ret&=(this.country==null && acc.country==null || this.country.equals(acc.country));
ret&=(this.number==null && acc.number==null || this.number.equals(acc.number));
ret&=(this.subnumber==null && acc.subnumber==null || this.subnumber.equals(acc.subnumber));
ret&=(this.curr==null && acc.curr==null || this.curr.equals(acc.curr));
ret&=(this.customerid==null && acc.customerid==null || this.customerid.equals(acc.customerid));
ret&=(this.name==null && acc.name==null || this.name.equals(acc.name));
ret&=(this.name2==null && acc.name2==null || this.name2.equals(acc.name2));
ret&=(this.type==null && acc.type==null || this.type.equals(acc.type));
ret&=(this.bic==null && acc.bic==null || this.bic.equals(acc.bic));
ret&=(this.iban==null && acc.iban==null || this.iban.equals(acc.iban));
} else {
ret=super.equals(o);
}
return ret;
}
/** Gibt true zurück, wenn sich dieses Konto für SEPA-GVs
* verwenden lässt */
public boolean isSEPAAccount()
{
return (bic!=null && iban!=null && bic.length()!=0 && iban.length()!=0);
}
}