Kategoriarkiv: .NET

Geo IP redirigering

GeoLite City er et praktisk lille Open Source-værktøj fra firmaet MaxMind, som kan være til stor hjælp ved IP redirigering. Applikationen består i al sin enkelthed af en database-fil, samt en række C# klasser, som bruges til at tilgå databasen. Databasen kan bruges til at finde oplysninger om bl.a. land, landekode, region, by, postnummer, længde- og breddegrader og meget andet for en given IP-adresse.

Det Open Source API fra MaxMind som vi har anvendt består af seks C# klasser, hvoraf kun to skal instantieres for at benytte applikationen til fulde (der er API til yderligere programmeringssprog også, se forrige link). Det drejer sig om klasserne: LookupService og Location.

LookupService instantieres med en sti til databasen, samt (optionelt) en int, der fortæller om databasen skal læses direkte fra filen, eller gemmes i en buffer. Som standard læses der direkte fra filen, men i hastighedskritiske sammenhænge, kunne man muligvis ønske at cache databasen. Dernæst bruges LookupService objektet til at instantiere Location.

Location instantieres ved at kalde getLocation() på LookupService med den ønskede IP-adresse som parameter. Når det er gjort, er man klar til at udnytte de mange muligheder GeoLite City tilbyder. Dette gøres i første omgang ved at tilgå de public attributter der ligger i Location.

Dette eksempel udskriver land og breddegrad for IP-adressen, 208.77.188.166:
Bemærk at der kastes en exception hvis IP’en ikke findes, og koden bør derfor sættes i en try-catch blok.

LookupService ls = new LookupService(@"C:\...\...\GeoLiteCity.dat", GEOIP_STANDARD);
Location l = ls.getLocation("208.77.188.166");
Console.WriteLine("Land: " + l.countryName);
Console.WriteLine("Breddegrad: " + l.longitude.ToString());

Oplysninger om land ville i praksis f.eks. kunne bruges til, at redirigere en hjemmesidebruger hen til en version af siden i det pågældende lands sprog.

Man kunne også forestille sig, at en hjemmeside ønskede at vise mindre ressourcekrævende udgaver af siden til langsomme forbindelser. Her ville man også kunne benytte sig af GeoLite City. I dette tilfælde kunne koden se nogenlunde sådan her ud:
Bemærk at man her benytter LookupService og ikke Location.

int i = ls.getID("208.77.188.166");
if (i == LookupService.GEOIP_UNKNOWN_SPEED)
{
   Response.Redirect("http://example.net/standard.asp");
}
else if (i == LookupService.GEOIP_CABLEDSL_SPEED)
{
   Response.Redirect("http://example.net/fast.asp");
}
else if(i == LookupService.GEOIP_DIALUP_SPEED)
{
   Response.Redirect("http://example.net/slow.asp");
}

Her er et eksempel på en lille webapplikation, der oplyser land, by og koordinater for angivne IP adresser. Eksemplet vælger som standard www.hinnerup.net serverens globale IP. Der kan indtastes såvel IPv4 som IPv6 adresser i IP-adressefeltet.

GeoLite City kan hentes her og opdateres en gang om måneden.

Udvidelses- og klassemetoder i C#

Jeg havde brug for at forklare forskellen på extension methods og almindelige klassemetoder idag, og det forbavsede mig i anledningen hvor længe siden det egentligt er jeg har brugt det selv i .NET sprog. Jeg bruger nemlig tit og ofte den “tilsvarende” mekanisme i JavaScript (f.eks. prototype nøgleordet).

Her er et eksempel på hvordan man kunne tælle alle ord i en streng ved brug af en almindelig klassemetode:

TestProgram.cs:

using System;
using System.Text;

namespace TestApplication
{
  public class Utilities 
  {
    public static int CountWords(String str)
    {
      return str.Split(new char[] { ' ', '.', '?' },
        StringSplitOptions.RemoveEmptyEntries).Length;
    }
  }

  class TestProgram
  {
    static void Main(string[] args)
    {
      String test = "Hello world, how are you doing?";

      Console.WriteLine(test);
      Console.WriteLine(Utilities.CountWords(test) + " words found.");
      Console.WriteLine("Press any key to quit.");
      Console.ReadKey();
    }
  }
}

Kørselsresultat:

Hello world, how are you doing?
6 words was found in the string.
Press any key to quit.

Metoden CountWords er her kun tilgængelig fra klassen Utilities. Men metoden er jo egentlig ret generel for alle instanser af String klassen, og det kunne nemt tænkes at den specielle funktion skal kaldes i fremtidige applikationer jeg laver, eller blot i andre klasser i samme applikation. Dertil kan man anvende extension methods til udvide de metoder der er tilgængelige i eksisterende klasser.

Extension methods, eller udvidelsesmetoder, implementeres ved at angive statiske metoder i en public static klasse. De klasser man har oprettet der indeholder udvidelsesmetoder skal så blot være i scopet der hvor man ønsker at anvende udvidelsesmetoderne. Dette sikres ved at benytte “using” direktivet for det namespace man har placeret klasserne for udvidelsesmetoderne i. Den første parameter i en udvidelsesmetode specificerer altid hviklen type (klasse) der udvides, og denne parameter skal altid indledes med en this modifikator, da det er denne modifikator sammen med static der får compileren til at genkende metoden som en udvidelsesmetode.   

Her et eksempel hvor Strings klassen får tilføjet en CountWords udvidelsesmetode:

MyExtensions.cs:

using System;
using System.Text;

namespace ExtensionMethods
{
  public static class MyExtensions
  {
    public static int CountWords(this String str)
    {
      return str.Split(new char[] { ' ', '.', '?' },
        StringSplitOptions.RemoveEmptyEntries).Length;
    }
  }
}

Den overstående klasse i namespacet ExtensionMethods udvider nu String klassen med metoden CountWords. Namespace navnet er ikke så vigtigt, det kan være hvad som helst faktisk. Udvidelsen af String klassen sker ved at this er angivet foran første parameter i CountWords metoden. Typen der udvides er String. Vi kan gøre brug af denne udvidelse ved at skrive “using ExtensionMethods;” i vores fremtidige applikationer, for eksempel:

TestProgram.cs:

using System;
using System.Text;
using MyExtensions;

namespace TestApplication
{
  class TestProgram
  {
    static void Main(string[] args)
    {
      String test = "Hello world, how are you doing?";

      Console.WriteLine(test);
      Console.WriteLine(test.CountWords() + " words found.");
      Console.WriteLine("Press any key to quit.");
      Console.ReadKey();
    }
  }
}

Kørselsresultat:

Hello world, how are you doing?
6 words was found in the string.
Press any key to quit.

Det er vigtigt at understrege at udvidelsen ikke finder sted på selve String klassen, men på instanser af String klassen. Helt konkret er det instansen str der modtages i selve CountWords metoden. Dette bevirker at man ikke kan lave klasse udvidelsesmetoder såsom “String.MyClassExtensionMethod” og tilsvarende. Ligeledes er adgangsniveauet for udvidelsesmetoder det samme som når man har med en given instans af en klasse at gøre. Man har således ikke adgang til protected og private metoder og egenskaber/variable på en klasse man udvider.

Microsoft Visual Studio’s Intellisense understøtter extension methods:

Der er lige et par huskeregler man bør have for øje:

  • Husk at udvidelsesmetoder kræver at der er anvendt et “using” direktiv.
  • Husk dermed at enten kildefilen eller DLL’en til ønskede udvidelsesmetoder er tilføjet projektet.
  • Endvidere skal man huske at eksisterende metoder med samme navn og signatur altid vinder over udvidelsesmetoder.
  • Tag ikke udvidelsesmetoder for givet. Anvend system metoder hvor muligt, og indfør kun udvidelsesmetoder under nøje overvejelser.

Se denne MSDN artikel, som mit eksempel herover er inspireret udfra, for flere uddybende eksempler.