ShowLowlevelGVRs.java

/*  $Id: ShowLowlevelGVRs.java,v 1.1 2011/05/04 22:37:45 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.tools;

import java.io.BufferedReader;
import java.io.InputStreamReader;

import org.kapott.hbci.callback.HBCICallbackConsole;
import org.kapott.hbci.manager.HBCIKernelImpl;
import org.kapott.hbci.manager.HBCIUtils;
import org.kapott.hbci.manager.MsgGen;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

/** <p>Dieses Tool dient zum Anzeigen der Struktur von HBCI-Job-Ergebnisdaten im
    Rohformat. Diese Struktur wird ben�tigt, wenn Job-Ergebnisdaten nicht �ber
    die Methoden und Felder der entsprechenden Highlevel-Klassen ausgewertet
    werden sollen (Klassen <code>org.kapott.hbci.GV_Result.GVR*</code>), sondern
    wenn die Daten benutzt werden, die durch
    {@link org.kapott.hbci.GV_Result.HBCIJobResult#getResultData()}
    zur�ckgegeben werden.</p>
    <p>In diesem Property-Objekt werden die Job-Ergebnisdaten n�mlich nach der <em>HBCI4Java</em>-internen
    Struktur benannt. Um nun die Bezeichnungen f�r die einzelnen Datenelemente zu erfahren, 
    kann dieses Tool benutzt werden.</p>
    <p>Der Aufruf erfolgt durch
    <pre>java org.kapott.hbci.tools.ShowLowlevelGVRs [hbciversion]</pre>Ist keine
    <code>hbciversion</code> angegeben, so wird diese �ber STDIN erfragt.</p>
    <p>Das Tool gibt eine baumartige Struktur aus, welche die Lowlevelnamen der Gesch�ftsvorf�lle
    (plus dem zus�tzlichen Suffix "<code>Res</code>") sowie die Bezeichnungen f�r die
    dazugeh�rigen Datenfelder enth�lt. Eine Erkl�rung der Ausgaben im Detail ist in der Dokumentation
    zum Tool {@link ShowLowlevelGVs} enthalten.</p>
    <p>Innerhalb einer Anwendung kann mit der Methode
    {@link org.kapott.hbci.manager.HBCIHandler#getSupportedLowlevelJobs()}
    eine Liste aller unterst�tzten Lowlevel-Jobs in Erfahrung gebracht werden. Zus�tzlich gibt diese
    Methode zu jedem Jobnamen die Versionsnummer zur�ck, welche f�r diesen Job von <em>HBCI4Java</em> benutzt
    werden wird (das h�ngt von der aktuellen HBCI-Version und dem benutzten Passport ab, kann von
    au�en also nicht direkt beeinflusst werden). In der Ausgabe dieses Tool kann nun nach einem
    bestimmten Lowlevelnamen eines Jobs und der von <em>HBCI4Java</em> daf�r verwendeten Versionsnummer gesucht werden.
    Ist der entsprechende Eintrag gefunden, so hat man eine �bersicht �ber alle m�glichen
    Job-Ergebnisdaten und wie oft die jeweiligen Datenelemente in einem Antwortsegment auftreten
    k�nnen. Die gleiche �bersicht erh�lt man �brigens, wenn man innerhalb der Anwendung die Methode
    {@link org.kapott.hbci.manager.HBCIHandler#getLowlevelJobResultNames(String)}
    aufruft, allerdings fehlen in der Ausgabe dieser Methode die Informationen �ber die m�glichen
    H�ufigkeiten der einzelnen Datenelemente, daf�r wird hier automatisch die richtige Versionsnummer
    des Jobs ausgew�hlt.</p>*/
public class ShowLowlevelGVRs
    extends AbstractShowLowlevelData
{
    public static void main(String[] args)
        throws Exception
    {
        HBCIUtils.init(null,new HBCICallbackConsole());
        
        String hbciversion;
        if (args.length>=1) {
            hbciversion=args[0];
        } else {
            System.out.print("hbciversion: ");
            System.out.flush();
            hbciversion=new BufferedReader(new InputStreamReader(System.in)).readLine();
        }
        
        HBCIKernelImpl kernel=new HBCIKernelImpl(null,hbciversion);
        MsgGen         msggen=kernel.getMsgGen();
        Document       syntax=msggen.getSyntax();
        
        Element  gvlist=syntax.getElementById("GVRes");
        NodeList gvnodes=gvlist.getChildNodes();
        int      len=gvnodes.getLength();
        
        for (int i=0;i<len;i++) {
            Node gvrefnode=gvnodes.item(i);
            
            if (gvrefnode.getNodeType()==Node.ELEMENT_NODE) {
                String gvname=((Element)gvrefnode).getAttribute("type");
                showData(gvname,syntax);
            }
        }
    }
}