Betfair API mit Java und Netbeans (Teil3) – Anleitung/Tutorial – Alle Märkte auflisten

Hier im dritten Teil des Tutorials zur Betfair API Programmierung mit Java und Netbeans zeige ich euch wie ihr alle Märkte von Betfair auslesen und auflisten könnt. Voraussetzung für dieses Tutorial ist, dass ihr den Login zur Betfairseite bereits hergestellt habt. Wie das genau geht, hab ich bereits im zweiten Teil des Tutorials beschrieben.

Das Arbeiten mit der Betfair API läuft immer nach dem selben Schema ab. Wenn ihr das Konzept einmal raus habt, könnt ihr nach herzenslust verschiedene Funktionen ausprobieren. Zuerst wird immer eine Anfrage/Request erstellt, dem wir den Header unserer Loginsession übergeben. In diesem Header ist eine Zeichenkette (Session Token) die eine identifikation für unseren aktuellen Login darstellt. Diese Zeichenkette sollte wir immer aus der vorherigen Abfrage übernehmen. In der API Dokumentation können wir sehen, welche Daten wir dem Request noch anfügen müssen. Ist der Request erstellt senden wir diesen über den entsprechenden Webservice an die Betfairseite und erhalten eine Rückgabe/Respone die wir dann auswerden können.

Eine kleine Anmerkung vorweg. Der Array wird bei im Beispielcode am Anfang mit vorgegebener Größe erstellt. Das ist nicht gerade schön und sollte noch so verändert werden, dass dieser erst nach Ermittlung der notwendigen Größe erstellt wird. Es sind ca. 10.000 Märkte auf Betfair. Zum ausprobieren sollte es also auch mit meinem Codebeispiel klappen.

Hier also der Java Code mit dem wir alle Märkte auf Betfair erfragen:

// Ergebnisarray
        String[][] output = new String[20000][20];

        // Felder Beschriftung
        final int MARKETID = 1;
        final int MARKETNAME = 2;
        final int MARKETTYPE = 3;
        final int MARKETSTATUS = 4;
        final int EVENTDATE = 5;
        final int MENUPATH = 6;
        final int EVENTHIERARCHY = 7;
        final int BETDELAY = 8;
        final int EXCHANGEID = 9;
        final int ISO3COUNTRYCODE = 10;
        final int LASTREFRESH = 11;
        final int NUMMBEROFRUNNERS = 12;
        final int NUMMBEROFWINNERS = 13;
        final int TOTALAMOUNTMATCHED = 14;
        final int BSPMARKET = 15;
        final int TURNINGINPLAY = 16;

        // Exchange Service
        BFExchangeService_Service bFExchangeService_Service = new BFExchangeService_Service();
        BFExchangeService bFExchangeService = bFExchangeService_Service.getBFExchangeService();

        // Get Markets
        GetAllMarketsReq getAllMarketsReq = new GetAllMarketsReq();
        com.betfair.publicapi.types.exchange.v5.APIRequestHeader newHeader = new com.betfair.publicapi.types.exchange.v5.APIRequestHeader();
        newHeader.setSessionToken(sessionToken);
        getAllMarketsReq.setHeader(newHeader);
        GetAllMarketsResp getAllMarketsResp = bFExchangeService.getAllMarkets(getAllMarketsReq);

        if (getAllMarketsResp.getErrorCode().equals(GetAllMarketsErrorEnum.OK)) {
            // Market Data
            String marketData = getAllMarketsResp.getMarketData();
            String[] splitMarkets = marketData.split(":");

            int i = 0;
            for (String part1 : splitMarkets) {

                String[] splitMarket = part1.split("~");

                int j = 1;
                for (String part2 : splitMarket) {

                    output[i][j] = part2;

                    j++;

                }

                i++;
            }

            // Beispielanwendung
            // Suchen nach Pferderennen im Menüpfad:
            CharSequence suche = "Pferdergennen";
            for (String[] test : output) {
                if (test[MENUPATH] != null) {
                    if (test[MENUPATH].contains(suche)) {
                        System.out.println("Marktid: " + test[MARKETID]);
                    }
                }
            }

        } else {
            System.out.println("Get All Markets Error: " + getAllMarketsResp.getErrorCode());
        }

Am Anfang lege ich finale Variabeln fest die mit ihrem Namen bestimmte Eigenschaften der Märkte repräsentieren. Dies dient einzig und alleine zur besseren Übersicht für den Programmierer. Seht euch dazu Table 13-3: marketData in der Betfair API Dokumentation an.

Als nächstes erstelle ich mir den entsprechenden Webservice über den ich die GetAllMarkets Anfrage an den Betfairserver senden werde. Dies geschiet auf die selbe weise wie beim Login, nur dass hier der Exchange Service und nicht der Global Service angesprochen wird. Bei einer komplexeren Anwendung könnt ihr die beiden Service an einem zentralen Punkt erstellen und immer wieder darauf zugreifen.

Danach erstelle ich eine GetAllMarkets Anfrage. Dieser muss nur der Header übergeben werden, der wie schon erwähnt den Session Token beinhaltet. Also erstell ich mir einen neuen Header und weise ihm den SessionToken zu. Den Session Token bekommt ihr von der letzten Antwort des Servers. Also zum Beispiel:

sessionToken = loginResp.getHeader().getSessionToken();

Ich erstelle hier im Beispiel einen neuen Header, da der Loginheader einen anderen Typ hat. Ansonsten müsste es auch gehen, den Header aus der Loginantwort zu übernehmen.
Es folgt die eigentlich Anfrage nach dem oben beschrieben Schema. Wie beim Login wird Antwort anhand des Error Codes geprüft.

War die Anfrage erfolgreich bekommen wir mit der Methode getMarketData() aus der Antwort einen elend langen String der alle Märkte mit Trennzeichen(Delimiter) getrennt enthält. Zuerst splitte ich im Beispiel die einzelnen Märkte auseinander und dann die einzelnen Informationen zu den Märkten und speichere das ganze in dem vorbereiteten Array. Jetzt hab ich einen Array bei dem der erste Wert als eine Art ID genutzt wird, und ein weiterer Zähler der die einzelnen Informationen zu den Märkten anspricht. Wir können nun also mit den einzelnen anfangs angelegten Variabeln bequem und gezielt die verschiedenen Eigenschaften der Märkte aufrufen.

Im Code findet ihr ein kleines Anwendungsbeispiel, das alle Märkte nach dem Wort Pferderennen im Menüpfad durchsucht und deren ID ausgibt:

  // Beispielanwendung
            // Suchen nach Pferderennen im Menüpfad:
            CharSequence suche = "Pferdergennen";
            for (String[] test : output) {
                if (test[MENUPATH] != null) {
                    if (test[MENUPATH].contains(suche)) {
                        System.out.println("Marktid: " + test[MARKETID]);
                    }
                }
            }

Nun könnt ihr nach herzenslust die Märkte Filtern und mit der MarktID weiter auf den Markt eingehen, was ich in einem späteren Tutorial zur Betfair API Programmierung erläutern werde.