Marcin Wolański

Trac na Windows

2010-11-15T00:00:00Z

Kiedy VisualSVN Server zainstalowałem tak, jak chciałem, zachciało mi się systemu do zarządzania błędami. Padło na Trac. Do instalacji postanowiłem wykorzystać Apache VisualSVN Servera. Wiem, że mógłbym wziąć sobie paczkę z Trac dla VisualSVN Server, ale nie zrobiłem tego, bo po pierwsze, nie zawiera najnowszej, stabilnej wersji Trac, a po drugie – niezależna instalacja Trac uprości aktualizację narzędzia w przyszłości.

Przygotowanie środowiska

Zainstalowałem po kolei używając defaultowych ścieżek:

Niestety najnowsze bindingi SVN dla Pythona 2.5 nie pomogą w integracji Trac z VisualSVN Server (gdzieś znalazłem informację, że winne są zmodyfikowane biblioteki SVN w VisualSVN Server). Ale poradziłem sobie z tym pobierając wspomnianą paczkę Trac dla VisualSVN Server i kopiując z archiwum katalogi trac\python\Lib\site-packages\libsvn oraz trac\python\Lib\site-packages\svn do c:\Python25\Lib\site-packages.

Konfiguracja Trac

Z wiersza poleceń wykonujemy:

c:\Python25\Scripts\trac-admin.exe c:\trac initenv

Na pytania instalatora odpowiadamy następująco:

Project Name: Moja_nazwa
Database connection string [sqlite:db/trac.db]: <enter>

Do katalogu c:\trac dajemy prawa do odczytu i zapisu użytkownikowi, na którym uruchomiona jest usługa.

Na tym etapie można już uruchomić webserwer Traca poleceniem:

tracd --port 8000 c:\trac

My chcemy jednak, żeby Trac serwowany był przez Apache. W związku z tym trzeba doinstalować mod_python dla Apache 2.2 i Python 2.5. Instalator zapyta nas, gdzie jest zainstalowany Apache. Chcemy wykorzystać serwer dostarczany razem z VisualSVN Server. W związku z tym tworzymy katalog modules w C:\Program Files\VisualSVN Server\bin i wskazujemy instalatorowi katalog C:\Program Files\VisualSVN Server\bin, a w konfiguracji Apache C:\Program Files\VisualSVN Server\conf\httpd.conf dodajemy linie:

LoadModule python_module bin/modules/mod_python.so

Dodajemy do konfiguracji Apache katalog Trac:

<Location /trac>
    SetHandler mod_python
    PythonInterpreter main_interpreter
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv "C:/trac"
    PythonOption TracUriRoot /trac
</Location>

Chcemy, aby w Trac mogli się zalogować użytkownicy domenowi. W związku z tym w konfiguracji dodajemy jeszcze poniższy fragment:

<Location /trac/login>
    AuthType SSPI
    AuthName "Trac"
    SSPIAuth On
    SSPIAuthoritative On
    SSPIDomain NAZWA_DOMENY
    SSPIOfferBasic Off
    Require valid-user
</Location>

Pod adresem http://nazwa_hosta//trac mamy dostęp do Trac.

External Tools w Visual Studio 2010 Express

2010-10-25T00:00:00Z

Zainstalowałem sobie Visual Studio 2010 Express. Jest kilka narzędzi, które lubię mieć zdefiniowane jako External Tools. Wchodzę zwyczajowo w menu Tools i… nie ma opcji External Tools.

Okazało się, że autorzy nie usunęli tego wielce przydatnego narzędzia, ale je ukryli. Wystarczy włączyć opcję Tools > Settings > Expert Settings i External Tools wrócą na swoje miejsce.

Użytkownicy domenowi w VisualSVN Server

2010-10-10T00:00:00Z

Korzystałem kiedyś z VisualSVN Server, ale wówczas wystarczała mi autoryzacja Basic, czyli każdy użytkownik ma swoją nazwę i hasło. Rozwiązanie to jest niewygodne, jeśli działamy w ramach domeny Windows. Po co nowa nazwa i hasło użytkownika specjalnie dla Subversion?

VisualSVN Server w darmowej wersji Standard Edition nie udostępnia możliwości zmiany sposobu autoryzacji użytkowników z poziomu konsoli serwera. Trzeba zakupić wersję Enterprise Edition za 950 dolarów. Jako, że nie znalazłem na stronie narzędzia informacji, że modyfikacja serwera jest niezgodna z licencją, postanowiłem spróbować zmusić darmową wersję do autoryzacji użytkowników domenowych.

Ściągnąłem i zainstalowałem najnowszą wersję narzędzia (zachowałem defaultowe ustawienia instalatora).

Aby móc skorzystać z logowania użytkowników domenowych w darmowej wersji VisualSVN Server należy ściągnąć moduł mod_auth_sspi. Archiwum rozpakowujemy do katalogu C:\Program Files\VisualSVN Server\bin. Trzeba jeszcze zmienić konfigurację Apache znajdującą się w pliku C:\Program Files\VisualSVN Server\conf. Deklarujemy załadowanie modułu:

LoadModule sspi_auth_module bin/mod_auth_sspi.so

W tym samym pliku linie:

AuthType Basic
AuthBasicProvider file
AuthUserFile "C:/Repositories/htpasswd"

zastępujemy następującymi:

AuthType SSPI
SSPIAuth On
SSPIAuthoritative On
SSPIDomain NAZWA_DOMENY
SSPIOfferBasic On

Użytkownika o nazwie NAZWA_DOMENY\uzytkownik można dodać zarówno z poziomu konsoli VisualSVN Server, jak i edytując plik C:\Repositories\authz.

Wykorzystanie Rake do budowy projektu .NET

2010-10-06T00:00:00Z

Przy okazji rozpoczęcia nowego projektu chciałem w prosty sposób umożliwić budowę projektu z linii komend. Do tej pory używałem do tego NAnta, ale tym razem chciałem dać szansę narzędziu, z którego korzysta wiele projektów open-source: Rake.

Wymagania miałem dwa: kompilacja projektu wykorzystującego .NET 4.0 oraz uruchomienie testów jednostkowych wykorzystujących bibliotekę xUnit.net.

Rozpocząłem od ściągnięcia i instalacji środowiska Ruby dla Windows. Aby nie wynajdywać od nowa koła, zainstalowałem bibliotekę Albacore, która znacznie ułatwia pracę ze skryptem wykorzystywanym do budowy projektu .NET. Aby zainstalować Albacore, należy w wierszu poleceń uruchomić komendę:

gem install albacore

Mój projekt ma w uproszczeniu taką strukturę:

MyApplication\lib
MyApplication\lib\xunit-1.6.1
MyApplication\source
MyApplication\source\MySolution.sln
rakefile.rb

Aby nie musieć wskazywać w wywołaniu w wierszu poleceń narzędzia rake pliku ze zadaniami, skrypt budujący projekt należy utworzyć w pliku o nazwie rakefile, Rakefile, rakefile.rb lub Rakefile.rb. Ja wybrałem sobie nazwę rakefile.rb. Dzięki temu, aby wywołać defaultowe zadanie dla Rake, będąc w katalogu projektu, w wierszu poleceń wystarczy wykonać komendę:

rake nazwa_zadania

Na początku pliku rakefile.rb deklarujemy użycie biblioteki Albacore:

require 'albacore'

Następnie dodajemy zadanie budujące solucję:

desc "Build solution"
msbuild :build do |msb|
    msb.path_to_command =  File.join(ENV['windir'], 'Microsoft.NET',
        'Framework',  'v4.0.30319', 'MSBuild.exe')
    msb.properties :configuration => :Debug
    msb.targets :Clean, :Build
    msb.solution = "source/MySolution.sln"
end

Pierwsza linijka zawiera opis zadania i ma tylko znaczenie dokumentujące. W drugiej linii msbuild oznacza nazwę zadania z Albacore, a :build alias dla tego zadania. Dzięki temu, aby zbudować projekt, w wierszu poleceń należy wykonać komendę:

rake build

Jeśli pominąłbym alias, to budowę solucji mógłbym uruchomić tak:

rake msbuild

Trzecia linia nie wygląda najlepiej, ale jest niestety konieczna, jeśli projekt używa .NET 4.0. A to dlatego, że zadanie msbuild z Albacore domyślnie używa .NETa 3.5 i wykonanie go, bez zdefiniowania ścieżki do msbuild.exe z właściwego frameworka, zakończy się błędem.

Pozostała część kodu zadania jest oczywista: chcemy zbudować solucję MySolution.sln w trybie Debug, uprzednio robiąc porządki.

Zadanie uruchomienia testów jednostkowych jest krótkie:

desc "Run unit tests"
xunit :test => :build do |xunit|
    xunit.path_to_command = "lib/xunit-1.6.1/xunit.console.clr4.exe"
    xunit.assembly = "unit_tests_file.dll"
end

Podajemy ścieżkę do narzędzia uruchamiającego z wiersza poleceń testy jednostkowe wykorzystujące bibliotekę xUnit.net i wskazujemy bibliotekę z naszymi testami.

Aby uruchomić testy jednostkowe, w wierszu poleceń należy wykonać komendę:

rake test

Jeśli mamy jakieś zadanie, które wykonujemy wyjątkowo często, to przed definicją zadań można dodać linię:

task :default => :nazwa_lub_alias_zadania

Dzięki temu, aby wykonać to zadanie, w wierszu poleceń wystarczy wywołać komendę:

rake

Nie bawiłem się zbyt długo tym rozwiązaniem, ale póki co, przynajmniej dla mnie, nie ma porównania czytelność skryptu napisanego w Ruby z plikami dla NAnta czy też msbuilda. Chcę jeszcze dodać kilka różnych zadań i zintegrować wszystko z narzędziem CI. Zobaczymy, czy się uda.

Recenzja: Debugowanie. Jak wyszukiwać i naprawiać błędy w kodzie oraz im zapobiegać

2010-09-30T00:00:00Z

Debugowanie jest procesem niezwykle złożonym. Istnieją publikacje opisujące techniczne aspekty wyszukiwania błędów w kodzie w ten właśnie sposób. Czasami warto jednak zapoznać się z jakimś zagadnieniem w oderwaniu się od konkretnej technologii. Taką właśnie pozycją jest Debugowanie. Jak wyszukiwać i naprawiać błędy w kodzie oraz im zapobiegać (oryg. Debug It!: Find, Repair, and Prevent Bugs in Your Code).

Książka nie jest opisem jakiegoś narzędzia wspomagającego debugowanie, platformy uruchomieniowej czy też języka programowania (kodu jest bardzo niewiele). Autor skupił się raczej na mentalnym podejściu programisty do wyszukiwania błędów w aplikacji.

Książka składa się z 3 części: Istota problemu, Szersza perspektywa oraz Debug-Fu.

W części pierwszej autor opisuje metodę empiryczną debugowania tj. reprodukcję błędów, diagnozowanie ich przyczyny, poprawki oraz refleksja nad tym, co zrobić, aby w przyszłości nie musieć usuwać takich samych usterek.

Część druga poświęcona jest miejscu debugowania w całym procesie tworzenia aplikacji m.in. współpracy z użytkownikami aplikacji, innymi zespołami, czy błędy powinny być naprawiane od razu po ich stwierdzeniu, czy może lepiej dodać jakąś nową funkcjonalność itd.

W części trzeciej autor skupił się na technicznym aspekcie procesu debugowania: stworzeniu odpowiedniego środowiska umożliwiającego skuteczne debugowanie, systemach kontroli wersji, ciągłej integracji, testach jednostkowych, użyteczności asercji, kontraktów i bibliotek ułatwiających logowanie itd.

Podobało mi się

Książki podejmujące tematykę debugowania od strony technicznej nie są, przynajmniej dla mnie, lekką lekturą. Trzeba znaleźć wolną chwilę, aby wiedzę zgłębiać w skupieniu i koniecznie przy komputerze. Opisywana pozycja ma tą cechę, że takich fragmentów jest naprawdę niewiele.

Dodatkowo jej gabaryty zdecydowanie nie przeszkadzają w czytaniu np. w drodze do pracy.

Nie podobało mi się

Choć tematyka książki sugeruje, że powinno się ją czytać lekko i przyjemnie, to tak niestety nie było w moim przypadku. Nie czytałem oryginału, ale wydaje mi się, że to kwestia przekładu.

Dawno nie czytałem nic wydawanego przez Helion. Zraziły mnie do tego skutecznie przede wszystkim nieudane tłumaczenia. Do zakupu opisywanej pozycji skusiła mnie cena dużo niższa niż w Amazon. Następnym razem się zastanowię, bo w tym przypadku skąpstwo nie popłaciło.

Moim zdaniem nie powinno się tłumaczyć niektórych angielskich zwrotów. “Zaślepki testowe” (ang. test doubles), “atrapy” (ang. mocks), “namiastki” (ang. stubs) czy też mój ulubiony “profilator” (ang. profiler), to tylko niektóre kwiatki.

Czego się nauczyłem

Lubię od czasu do czasu przeczytać trochę mniej techniczną książkę. Lektura Debugowania… zmusiła mnie do refleksji nad tym, czy w codziennej pracy właściwie podchodzę do procesu diagnozy przyczyn błędów w rozwijanych i utrzymywanych aplikacjach.

Polecam, ale raczej w języku angielskim.

Zaznaczanie błędów w Visual Studio a deinstalacja Resharpera

2010-09-24T00:00:00Z

Po odinstalowaniu Resharpera zauważyłem, że w edytorze nie są zaznaczane błędy. Chwila grzebania w opcjach i udało się doprowadzić Visual Studio do stanu sprzed instalacji narzędzia.

Wystarczy wybrać Tools > Options > Text Editor > C# > Advanced i zaznaczyć w Editor Helper opcje Underline errors in the editor oraz Show live semantic errors.

NHibernate i wyjątki ADO

2010-03-03T00:00:00Z

Próba zapisania obiektu naruszającego więzy integralności przy użyciu biblioteki NHibernate spowoduje wygenerowanie wyjątku GenericADOException. Dopiero sięgając do wartości właściwości InnerException możemy przekonać się, co jest przyczyną niepowodzenia. Istnieje jednak sposób na zastąpienie standardowego wyjątku własnym.

W przykładzie użyję prostej klasy:

public class User
{
    public virtual int Id { get; set; }
    public virtual string UserName { get; set; }
    public virtual int Age { get; set; }
}

i mapowania:

public class UserMap : ClassMap<User>
{
    public UserMap()
    {
        Id(x => x.Id);
        Map(x => x.UserName).Unique();
        Map(x => x.Age);
    }
}

Próba zapisu dwóch użytkowników o tej samej nazwie kończy się wyjątkiem GenericADOException:

[Test, ExpectedException(typeof(NHibernate.Exceptions.GenericADOException))]
public void CannotAddTwoUsersWithTheSameUsername()
{
    var janKowalski1 = new User {UserName = "Jan Kowalski"};
    var janKowalski2 = new User {UserName = "Jan Kowalski"};

    using (var session = DataAccessFacade.OpenSession())
    using (var tx = session.BeginTransaction())
    {
        session.Save(janKowalski1);
        session.Save(janKowalski2);
        tx.Commit();
    }
}

Oczywiście można sprawdzić, co jest przyczyną błędu przy zapisie:

var janKowalski1 = new User {UserName = "Jan Kowalski"};
var janKowalski2 = new User {UserName = "Jan Kowalski"};

using (var session = DataAccessFacade.OpenSession())
using (var tx = session.BeginTransaction())
{
    try
    {
        session.Save(janKowalski1);
        session.Save(janKowalski2);
        tx.Commit();
    }
    catch (GenericADOException ex)
    {
        if (ex.InnerException is SQLiteException)
        {
            var sqLiteException = (SQLiteException) ex.InnerException;
            switch(sqLiteException.ErrorCode)
            {
                case SQLiteErrorCode.Constraint:
                    // do something with constaint exception
                default:
                    throw;
            }
        }
        throw;
    }
}

Jednak ten sposób uzależniamy nasz kod od konkretnego providera. Ewentualna zmiana silnika bazy danych powoduje konieczność zmian w wielu klasach warstwy dostępu do danych. Poza tym obsługa wydawałoby się trywialnego problemu wymaga każdorazowo napisania wielu linii kodu.

Czy powyższy fragment nie mógłby wyglądać tak:

var janKowalski1 = new User {UserName = "Jan Kowalski"};
var janKowalski2 = new User {UserName = "Jan Kowalski"};

using (var session = DataAccessFacade.OpenSession())
using (var tx = session.BeginTransaction())
{
    try
    {
        session.Save(janKowalski1);
        session.Save(janKowalski2);
        tx.Commit();
    }
    catch (ConstraintViolationException ex)
    {
        // do something with constaint exception
    }
}

O ile krócej, prawda? I nie obchodzi nas, że w danej chwili wykorzystujemy bazę danych SQLite, Oracle czy MSSQL Server.

Aby osiągnąć ten efekt używając NHibernate, musimy stworzyć własną implementację interfejsu ISQLExceptionConverter:

public class MyCustomSQLExceptionConverter: ISQLExceptionConverter
{
    public Exception Convert(AdoExceptionContextInfo adoExceptionContextInfo)
    {
        var ex = ADOExceptionHelper.ExtractDbException(
            adoExceptionContextInfo.SqlException) as SQLiteException;
        if (ex != null)
        {
            switch (ex.ErrorCode)
            {
                case SQLiteErrorCode.Constraint:
                    return
                        new NHibernate.Exceptions.ConstraintViolationException(
                            adoExceptionContextInfo.Message,
                            ex.InnerException,
                            adoExceptionContextInfo.Sql,
                            null
                        );
            }
        }
        return SQLStateConverter.HandledNonSpecificException(
            adoExceptionContextInfo.SqlException,
            adoExceptionContextInfo.Message,
            adoExceptionContextInfo.Sql
        );
    }
}

Metoda ADOExceptionHelper.ExtractDbException wyłuskuje pierwszy wyjątek System.Data.Common.DbException z drzewa wraz z jego InnerExceptionami. Reszta jest chyba oczywista.

Konfigurujemy jeszcze NHibernate w pliku konfiguracyjnym:

<property name="sql_exception_converter">
    NameSpace.MyCustomSQLExceptionConverter, AssemblyName
</property>

albo za pomocą Fluent NHibernate:

_configuration.SetProperty(
    NHibernate.Cfg.Environment.SqlExceptionConverter,
    typeof(MyCustomSQLExceptionConverter).AssemblyQualifiedName
);

NHibernate.Validator: komunikaty przyjazne dla użytkownika

2010-01-16T00:00:00Z

Jakiś czas temu przedstawiłem sposób użycia biblioteki NHibernate.Validator w aplikacji Windows Forms. Miał on jedną zasadniczą wadę: komunikaty walidatora były takie, jakie stworzyli autorzy biblioteki.

Przypomnę, że poprzednio stworzyliśmy użytkownika z właściwościami: imię, nazwisko i wiek. Założyliśmy, że imię i nazwisko nie mogą być puste i użytkownik musi mieć przynajmniej 18 lat:

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }
}

public class UserValidationDef: ValidationDef<User>
{
    public UserValidationDef()
    {
        Define(x => x.FirstName)
            .NotNullableAndNotEmpty();
        Define(x => x.LastName)
            .NotNullableAndNotEmpty();
        Define(x => x.Age)
            .GreaterThanOrEqualTo(18);
    }
}

Niewypełnienie imienia i nazwiska skutkowało niskopoziomowym komunikatem: nie może być nieokreślony i pusty, natomiast wpisanie wieku mniejszego niż 18: musi być większe lub równe od 18.

Chciałbym, aby komunikaty były bardziej przyjazne dla użytkownikowa np. Imię jest wymagane czy też Wiek musi być większy lub równy 18. Można dostosować komunikaty dla każdej reguły:

public class UserValidationDef: ValidationDef<User>
{
    public UserValidationDef()
    {
        Define(x => x.FirstName)
            .NotNullableAndNotEmpty()
            .WithMessage("Imię jest wymagane.");
        Define(x => x.LastName)
            .NotNullableAndNotEmpty()
            .WithMessage("Nazwisko jest wymagane.");
        Define(x => x.Age)
            .GreaterThanOrEqualTo(18)
            .WithMessage("Wiek musi być większy lub równy 18.");
    }
}

Rozwiązanie jest zadowalające dla niewielkiej aplikacji. W bardziej skomplikowanej kosmetyczna zmiana jest wymagane na musi być wypełnione wymaga przejrzenia i aktualizacji kilku/kilkunastu/kilkudziesięciu klas. Autorzy przewidzieli taki przypadek: komunikaty można zdefiniować w zewnętrznym pliku zasobów.

Dodajmy plik zasobów do projektu:

Definiujemy komentarze przyjazne dla użytkownika:

Obrazek chyba nie wymaga wyjaśnień, może poza {Value} w komunikacie message.user.age.GreaterThanOrEqualTo. Jest to właściwość publiczna atrybutu MinAttribute wykorzystywanego w metodzie GreaterThanOrEqualTo. Dzięki temu argument wspomnianej metody będzie przekazywany do komunikatu. Jeśli zmieni się wartość dopuszczalnego wieku, wystarczy edycja reguły bez konieczności uaktualniania pliku z komunikatami.

Zmieńmy klasę UserValidationDef tak, aby wykorzystywała komunikaty z pliku zasobów:

public class UserValidationDef: ValidationDef<User>
{
    public UserValidationDef()
    {
        Define(x => x.FirstName)
            .NotNullableAndNotEmpty()
            .WithMessage("{message.user.firstname.NotNullableAndNotEmpty}");
        Define(x => x.LastName)
            .NotNullableAndNotEmpty()
            .WithMessage("{message.user.lastname.NotNullableAndNotEmpty}");
        Define(x => x.Age)
            .GreaterThanOrEqualTo(18)
            .WithMessage("{message.user.age.GreaterThanOrEqualTo}");
    }
}

Ostatni krok, to konfiguracja biblioteki tak, aby wykorzystywał plik zasobów ValidationMessages.resx:

Environment.SharedEngineProvider = new NHibernateSharedEngineProvider();

var config = new FluentConfiguration();
config.SetCustomResourceManager("NHVWinForms.Properties.ValidationMessages",
         typeof(Program).Assembly)
      .Register(typeof (UserValidationDef).Assembly.ValidationDefinitions())
      .SetDefaultValidatorMode(ValidatorMode.UseExternal);

var ve = Environment.SharedEngineProvider.GetEngine();
ve.Configure(config);

I mamy przyjazne i łatwo modyfikowalne komunikaty: Imię jest wymagane zamiast nie może być nieokreślony i pusty i Wiek musi być większy lub równy 18 zamiast musi być większe lub równe od 18.

Mapowanie bool na...

2009-12-10T00:00:00Z

W Oracle nie ma możliwości przechowywania wartości typu bool. Najbardziej powszechnym rozwiązaniem jest użycie kolumny typu CHAR(1) z wartościami 'Y' i 'N'. Autorzy NHibernate się na to przygotowali udostępniając typ YesNo.

Mój przypadek był inny. Z bazy danych korzystała już aplikacja, która wartości typu bool zapisywała w kolumnach typu INT. Wartość true zdefiniowana była jako -1, wartość false - 0. Moja miała robić tak samo. Da radę. Tylko niestety trzeba się trochę napisać.

Tworzymy klasę MyTrueFalseType implementującą interfejs NHibernate.Types.IUserType:

using System;
using System.Data;
using NHibernate;
using NHibernate.SqlTypes;
using NHibernate.UserTypes;

namespace MyNamespace
{
    public class MyTrueFalseType : IUserType
    {
        private const int TRUE_VALUE = -1;
        private const int FALSE_VALUE = 0;

        public object Assemble(object cached, object owner)
        {
            return cached;
        }

        public object DeepCopy(object value)
        {
            return value;
        }

        public object Disassemble(object value)
        {
            return value;
        }

        public new bool Equals(object x, object y)
        {
            return object.Equals(x, y);
        }

        public int GetHashCode(object x)
        {
            if (x == null)
                return 0;
            return x.GetHashCode();
        }

        public bool IsMutable
        {
            get { return false; }
        }

        public object NullSafeGet(IDataReader rs, string[] names, object owner)
        {
            var obj = NHibernateUtil.String.NullSafeGet(rs, names[0]);

            if (obj == null) return null;

            var boolValue = Int32.Parse(obj.ToString());

            if (boolValue != TRUE_VALUE && boolValue != FALSE_VALUE)
                throw new ADOException(
                    String.Format("Expected data to be {0} or {1} but was {2}.",
                        TRUE_VALUE, FALSE_VALUE, boolValue), null);

            return boolValue == TRUE_VALUE;
        }

        public void NullSafeSet(IDbCommand cmd, object value, int index)
        {
            if (value == null)
            {
                ((IDataParameter)cmd.Parameters[index]).Value = DBNull.Value;
            }
            else
            {
                var boolValue = (bool)value;
                ((IDataParameter)cmd.Parameters[index]).Value =
                    boolValue ? TRUE_VALUE : FALSE_VALUE;
            }
        }

        public object Replace(object original, object target, object owner)
        {
            return original;
        }

        public Type ReturnedType
        {
            get { return typeof (bool); }
        }

        public SqlType[] SqlTypes
        {
            get { return new[] { SqlTypeFactory.Int32 }; }
        }
    }
}

Dla przykładowej klasy:

public class MyClass: BaseEntity
{
    public virtual bool Editable { get; set; }
}

definiujemy mapowanie:

public class MyClassMap: ClassMap<MyClass>
{
    public MyClassMap()
    {
        Id(x => x.Id).GeneratedBy.HiLo("1").UnsavedValue("0");
        Map(x => x.Editable).CustomType(typeof(MyTrueFalseType));
        Table("my_class");
    }
}

Od teraz w tabeli my_class w kolumnie editable wartość true będzie zapisywana jako -1, wartość false jako 0.

Własne połączenie w NHibernate

2009-11-26T00:00:00Z

Może czasem się zdarzyć, że chcemy użyć NHibernate, jednak aplikacja korzysta z jakiegoś frameworka, który ma już swoją definicję połączenia z bazą danych. Po co więc w NHibernate ponownie konfigurować to samo połączenie, skoro można wykorzystać już istniejące?

Rozszerzamy klasę DriverConnectionProvider i w przeciążonej metodzie GetConnection zwracamy połączenie pobrane z jakiegoś zewnętrznego mechanizmu:

class MyDriverConnectionProvider
    : NHibernate.Connection.DriverConnectionProvider
{
    public override IDbConnection GetConnection()
    {
        return MyExternalFramework.GetConnection();
    }
}

Wystarczy teraz odpowiednio skonfigurować NHibernate:

var configuration = Fluently.Configure()
    .Database(
        OracleClientConfiguration
        .Oracle10
        .Provider("My.Library.MyDriverConnectionProvider, My.Library")
        .ConnectionString(cs =>
            cs.Instance("my_instance"))
              .ProxyFactoryFactory(@"NHibernate.ByteCode.Castlei
                .ProxyFactoryFactory, NHibernate.ByteCode.Castle")
    )
    .Mappings(m => m.FluentMappings.AddFromAssemblyOf<MyClassMap>())
    .BuildConfiguration();

Niestety definicja ConnectionString jest niezbędna. Inaczej dostaniemy wyjątek z informacją, że nasza konfiguracja jest niekompletna i brakuje właśnie connection stringa.