Seit dem Google die SOAP API für Google Search eingestellt hat, läuft alles über die neue Google Ajax API. Dabei werden sogenannte JSON-Objekte bei Anfragen über die Google Ajax API übergeben. Leider gibt Google keine Beispiele für C#, sondern nur für PHP, Java, Flash, Python und Perl, wie man die Google Ajax API benutzt. Aus diesem Grund habe ich mich dazu entschlossen ein eigenes kleines Tutorial zu schreiben, wie man einfach und schnell Google Suchergebnisse in CSharp bekommt.

Hierzu gibt es bereits eine hilfreiche Dotnet-Library namens GAPI.NET, die einem das ungewohnte Hantieren mit JSON-Objekten erspart. Der Vorteil des Einsatzes einer externen Library ist, dass man sich nicht um das Ansprechen von Google kümmern muss und auch kein Einarbeiten in JSON notwendig ist. Wer sich trotzdem nicht auf fremden Code verlässt kann alles selbst nachvollziehen, denn GAPI ist Open Source.

Nachdem GAPI.NET heruntergeladen wurde muss die Assembly nur noch als Referenz in ein Visual Studio Projekt und die Using-Direktive “Gapi.Search” hinzugefügt werden. Jetzt geht es auch schon mit einem Beispiel-Codeschnipsel los, wie wir unsere Antworten von Google über C# bekommen.

SearchResults googleResults = Searcher.Search(SearchType.Web, "Stephan Hawking", 0);
 
for (int pageIndex = 0; pageIndex < googleResults.EstimatedResultCount; pageIndex = pageIndex + 8)
  {
      googleResults = Searcher.Search(SearchType.Web, keyword, pageIndex);
 
      foreach (SearchResult item in googleResults.Items)
         {
              Console.WriteLine(item.Title + " " + item.Url);
         }
   }

Dieser Code bewirkt, dass eine Suchabfrage nach “Stephan Hawking” gestartet wird. Bei jeder Suchanfrage spuckt GAPI bzw. Google nur 8 Ergebnisse aus, sodass jedesmal die Search-Methode erneut aufgerufen werden muss, wenn man die nächsten 8 Suchergebnisse haben möchte. Um zu verdeutlichen, wie die Search-Methode aufgerufen werden muss habe ich hier ein weiteres Code-Beispiel, die dies verdeutlichen soll.

// Gibt die zweite Seite mit 8 Suchergebnissen aus
Searcher.Search(SearchType.Web, "Stephan Hawking", 8)
 
// Gibt die dirtte Seite mit 8 Suchergebnissen aus
Searcher.Search(SearchType.Web, "Stephan Hawking", 16)
 
// Gibt die vierte Seite mit 8 Suchergebnissen aus
Searcher.Search(SearchType.Web, "Stephan Hawking", 24)

Jetzt dürfte jedem klar sein, wie er GAPI bis zum letztem Suchergebnis ausquetscht. GAPI kann aber nicht nur die Google Web Search API ansprechen, sondern alle anderen APIs wie beispielsweise die Google Maps API ansprechen. Hierzu muss in der Search-Methode der gewünschte Search-Typ, der als Enum definiert ist, eingestellt werden.

Möchte der Benutzer die Bücher als PDF downloaden, einzelne Buchseiten kommentieren oder Seiten drucken bezahlt pro Seite 10 Cent. Dabei muss das Benutzerkonto vorher via Paypal in vordefinierten Beträgen mit 1, 5 oder 10 Euro aufladen. Nach dem “Kauf ” einer einzelnen Seite kann der Text auch problemlos via Copy & Paste kopiert werden bspw. in ein Word-Dokument. Das Durchsuchen eines Buches ist trotz “Freemium”-Modells für registrierte Benutzer kostenlos.

Die Gründer von PaperC sind Felix Hofmann, Martin Fröhlich und Lukas Rieder. Der Sitz von PaperC ist in Leipzig. PaperC ist deutsches Startup des Jahres 2009 und Gewinner des AKEP Award für Innovationen im digitalen Publizieren.

So sieht C#-Code mit WP-Syntax in WordPress aus:

private string GetSourceCode(string url)
{
     // Comment: Initialize the web client and download the source code
     WebClient webClient = new WebClient();
     string sourceCode = webClient.DownloadString("http://www.bitpage.de");
     return sourceCode;
}

In Zukunft wird es von mir ab und zu auch mal einen Code-Schnipsel für C-Sharp geben. Im Moment bin ich ein wenig mit der Google API am testen und da die Dokumentation seitens Google sehr schlecht ist, was CSharp angeht wäre das genau das Richtige.

Wer jetzt neben einem dunklem Farb-Schema auch noch ein Hintergrund-Bild haben möchte, ist hier genau richtig. Ohne Addin für Visual-Studio geht es hier aber leider nicht, denn Microsoft bietet diese Funktion nicht von Haus aus an. Um dennoch den Code-Editor bzw. die Code-Ansicht von Visual Studio 2008 verschönern zu können, benötigen wir die Slickedit Gadgets, die es zum kostenfreien Download gibt.  Einfach herunterladen, installieren und schon taucht in Visual Studio oben ein neuer Menüpunkt namens “Slickedit” auf. Klickt man dort auf “Editor gadgets” findet sich in einem neu geöffnetem Dialog der Reiter “editor graphic”. Hier kann nun das Hintergrundbild für die Code-Ansicht bzw. dem Code-Editor von Visual Studio 2008 eingestellt werden. Natürlich gibt es an dieser Stelle auch die Funktion das Hintergrund prozentual transparent erscheinen zu lassen. Je höher die Transparenz in Prozent, desto weniger ist das Hintergrundbild sichtbar. Neben Wallpapern eignen sich auch Figuren, Artworks oder Logos die an einer der Ecken oder zentriert angezeigt werden können.

Für mich hat sich diese Addin auf jeden Fall gelohnt und ich muss nicht mehr frustriert sein, dass ich meine Desktop-Wallpaper nur selten zu Gesicht bekomme. Wer eine Lizenz für CodeRush besitzt kann es auch noch mit dem “Random Background Changer” von Benjamin Nitschke so weit treiben, dass sich das Hintergrundbild ständig ändert und der Programmieralltag noch abwechslungsreicher wird. Wer jetzt nur noch das passende Wallpaper sucht, wird hier eventuell fündig.

Ein einfaches Beispiel für ein Struktogramm wäre ein kleines Programm, das den BMI einer Person errechnet. Die Body Mass Index-Formel lautet Körpergewicht / Körpergroesse ². Der Programmablauf sähe in einem Struktogramm etwa wie folgt aus:

DFA steht für dateifreie Ausgabe und DFE für dateifreie Eingabe. Nachdem ich nun kurz darauf eingegangen bin, was ein Struktogramm ist und wie es in etwa aufgebaut ist, bleibt nun die Frage, ob so ein Struktogramm hilfreich ist. Kurz und einfach: Ja, es ist hilfreich, aber nicht unbedingt ein Muss. Ein guter Entwickler macht sich, bevor er wild in der Entwickl

ungsumgebung seinen Code zusammenhackt, darüber Gedanken, was sein Programm können muss. Hierzu hilft oft schon UML, wobei das Struktogramm sich auf einen kleineren Kontext bezieht. Das Programm bzw. die Funktion BMIberechnen() könnte ein Teil einer Fitness-Softwarelösung sein und während in UML das Gesamtkonzept steht, hilft ein Struktogramm sich gedanklich mit einer einfachen oder komplexen Funktion auseinanderzusetzen.

Natürlich ist ein Struktogramm nicht immer die beste Lösung für alle Aufgaben, denn durch das Erstellen eines Nassi-Shneiderman-Diagramms muss man vorher abwägen, ob sich die Zeit lohnt dafür zu investieren. Bei schwierigen und unübersichtlichen Aufgabenstellungen kann dies aber sehr hilfreich sein! Man vermeidet Flüchtigkeits- und vor allem verherende Logikfehler. Logikfehler können große Ausmaße annehmen, vor allem wenn das Programm scheinbar erst einmal fehlerfrei funktioniert. Natürlich ist ein Struktogramm keine Garantie dafür, einen Logikfehler zu vermeiden, doch das Risiko sinkt, da der Programmierer sich zuvor sich mit dem Programm intensiv – ohne eine Zeile Code zu schreiben – mit folgenden Punkten auseinandergesetzt hat:

• Welche Variablen brauche ich?
• Welche Eingaben müssen vom Benutzer gemacht werden?
• Welche Fehler muss ich abfangen?
• Auf welche Besonderheiten muss ich achten?
• Welche Verschachtelungen von Bedinungsabfragen sind sinnvoll und optimal?
• Benötige ich eine Kopf- oder fussgesteuerte Schleife?
• Welche Variabel muss initialisiert werden?

Meiner Meinung nach unterscheidet dies einen guten Programmierer von den Schlechten. “Trial and Error” ist nicht mehr die moderne Programmierform. Sich Gedanken machen und dann loslegen spart oftmals Zeit und Nerven.

Bildquelle (erstes Bild oben): © 2008 Bernd Boscolo / pixelio.de