Kamil Kliczbor @ asptip.net

31Dec/100

101 przykładów zapytań w NHibernate 3.x – HQL, Criteria API, QueryOver i Linq – Restrykcje

Wprowadzenie

Wpis ten jest częścią artykułu poświęconemu wykonywaniu zapytań w NHibernate przy użyciu różnych sposobów jakie udostępnia ten mapper - HQL, Criteria API, QueryOver i Linq.

Część ta opisuje stosowanie restrykcji w zapytaniach. Jeżeli piszesz instrukcję SELECT i chcesz określić w niej warunek, musisz użyć słowa kluczowego WHERE w podstawowej formule w następujący sposób:

SELECT NazwyKolumn FROM NazwaTabeli WHERE Warunek

Wyrażenia używane w warunku są budowane przy użyciu operatorów algebraicznych, logicznych i ciągów znakowych. W tym wpisie zostały przedstawione przykłady użycia klauzuli WHERE.

Spis zapytań

27Dec/102

101 przykładów zapytań w NHibernate 3.x – HQL, Criteria API, QueryOver i Linq.

Wprowadzenie

Postanowiłem stworzyć ten artykuł ponieważ nie mogłem odnaleźć w necie całościowego kompendium wiedzy w temacie odpytywania bazy danych przez NHibernate. Ponieważ NHibernate udostępnia wiele sposobów zadawania pytań, moim celem jest umieszczenie ich w jednym miejscu. Wśród nich wyróżnić można HQL, criteria query API wraz z rozszerzeniem Lambda Extensions, QueryOver oraz Linq for NHibernate (NHLQ). Jednym z moich założeń jest stworzenie zbioru zapytań na coś w rodzaju 101 Linq Samples. Nie wydaje mi się, żebym był w stanie odwzorować jeden do jednego to, co znajduje się na MSDNie, ale przynajmniej będę miał materiał referencyjny do którego będę mógł się odnieść.

Zapytania będę dodawać sukcesywnie oraz uaktualniać do nich odnośniki.

Wymagania

Aby móc wykonywać w miarę sensowne zapytania postanowiłem zamapować ulepszoną wersję Northwinda, którą opisałem i umieściłem w poprzednim poście. Oczywiście jeżeli chodzi o wymagane oprogramowanie jest to co najmniej Visual Studio 2008 oraz MS-SQL 2005.

Podział zapytań

  1. Restrykcje (klauzula WHERE)
    • Prosty przykład
    • Wyrażenia <, <=, ==, !=, >, >=
    • Wyrażenie Between
    • Wyrażenie In
    • Wyrażenie Like
    • Wyrażenie Like bez uwzględniania wielkości liter
    • Wyrażenie Is Null
    • Wyrażenie Not
    • Wyrażenie Exists / IsNotEmpty
    • Wyrażenie Not Exists / IsEmpty
    • Łączenie wyrażeń (koniunkcja i alternatywa - AND i OR)
    • Wyrażenia z aliasem
  2. Projekcje
    • Prosty przykład
    • Funkcje agregujące (MAX, AVG)
    • Wywołanie funkcji MS-SQL ROUND
    • Funkcja COUNT(*)
    • Funkcja COUNT(NazwaKolumny)
    • Funkcja COUNT DISTINCT
  3. Sortowanie (klauzula ORDER BY)
    • Prosty przykład
    • Sortowanie po długości wartości
    • Sortowanie po kilku kolumnach
    • Sortowanie po kilku kolumnach przez alias (różne tabele)
  4. Złączenia (klauzula JOIN)

    • Złączenie przez CreateCriteria()
    • Złączenie przez alias
    • Definiowanie typu złączenia
  5. Dzielenie danych
    • Pobranie pierwszych wyników - instrukcja TOP
    • Pobranie określonej "strony" - instrukcja TOP i ROW_NUMBER OVER
  6. Podzapytania
  7. Grupowanie

Projekt

Do pobrania już wkrótce!

Bibliografia

27Dec/100

NHibernate 3.x i FluentNHibernate: Płynne mapowanie – Północny wiatr (Northwind)

Wprowadzenie

Celem niniejszego wpisu jest wykonanie mapowania bazy danych Northwind przy użyciu ORM-a jakim jest NHibernate w wersji 3.x. Dodatkowo, zamiast pisać xml-e konfiguracyjne posłużymy się FluentNHibernate. Model domenowy będzie stanowić całkiem niezłe podwaliny pod serię artykułów na temat pisania dedykowanych zapytań, które chcę popełnić w niedalekiej przyszłości. Za zgodą Davy Briona zmieniłem mapowania lekko zmodyfikowanej, myślę że również oklepanej bazy danych Northwind. Oryginalny projekt wraz z objaśnieniami można znaleźć pod adresem http://davybrion.com/blog/2007/07/nhibernate-mapping-examples/.

W międzyczasie chciałem iść troszeczkę na łatwiznę i zabawić się z generatorem MyGeneration. Niestety do Fluenta jeszcze nie ma szablonu :(. Wprawdzie do mapowań w xmlu dobry jest szablon o nazwie L-99, jednakże przerobienie go na wersję generującą płynne mapowania byłoby czasochłonne, więc odłożę tą pracę  na później :)

Wymagania

Do przebrnięcia przez artykuł potrzebne będzie Visual Studio co najmniej 2008 oraz co najmniej Ms Sql Server Express 2005.

Mapujemy!

W poniższych kilku krokach postaram się w miarę zwięźle przedstawić procedurę przenoszenia modelu relacyjnego z bazy danych na encje w postaci mapowań do NHibernate. Ponieważ projekt Davy'ego był dla starszej wersji NHibernate (1.2), wypadałoby uaktualnić ją do nowszej - 3.x

  1. Źródła do NHibernate wraz z towarzyszącymi bibliotekami log4neta oraz  proxy znajdują się w repozytorium na sourceforgu: http://sourceforge.net/projects/nhibernate/files/NHibernate/3.0.0.GA/.
  2. FluentNHibernate dostarcza już pierwsze binarki dla wersji 3.x, które dostępne są na stronie projektu: http://fluentnhibernate.org/downloads.
  3. Łączymy się z bazą danych i wykonujemy skrypt tworzący schemat bazy danych wraz ze stowarzyszonymi elementami (skrypt northwind_create_script.sql).
  4. Otwieramy projekt Davy'ego i modyfikujemy go:
    • Usuwamy wszystkie pliki mapowań (z rozszerzeniem *.hbm.xml), albo ustawiamy we wszystkich "Build Action" na "None"
    • Konfigurujemy ustawienia połączenia z bazą danych
    • W projekcie Domain dodajemy katalog Mappings oraz tworzymy odpowiednie mapowania.
  5. W temacie mapowań nie będę się rozpisywał. Zachęcam do przeglądnięcia dokumentacji Fluenta. W celu weryfikacji możemy ewentualnie porównać pliki hbm-ów wygenerowanych przez Fluenta  z tymi Davy'a.
  6. Uruchamiamy testy.

Warto wspomnieć również o przyjętych konwencjach Fluenta. Można zdefiniować, aby domyślnie każdy identyfikator encji miał jeden spójny sposób mapowania. Realizuje się to poprzez implementację interfejsu IIdConvention , a następnie wskazanie na tą konwencję podczas konfiguracji. Oczywiście nic nie stoi na przeszkodzie, aby konwencję nadpisać w mapowaniu konkretnej encji.

public class IdentityConvention : IIdConvention
{
    public void Apply(IIdentityInstance instance)
    {
        instance.Access.ReadOnlyPropertyThroughLowerCaseField(LowerCasePrefix.Underscore);
        instance.UnsavedValue("-1");
        instance.GeneratedBy.Native();
    }
}

Gotowy projekt jest do pobrania tutaj.

IIdConvention
6Jul/100

Wywołanie funkcji z Oracle w NHibernate

Wywołanie funkcji w NHibernacie można zrealizować z poziomu SQLQuery w następującym bloku kodu:

public string DajAdres(string typAdresu)

        {
            var query = Session.CreateSQLQuery("select pakiet.FunkcjaZwracajacaAdres (:parametr) from dual")
                .SetString("parametr", typAdresu);
 
            string address = query.UniqueResult<string>();
            return address;
        }
14Apr/100

ArgumentOutOfRangeException : Index was out of range w mapowaniu NHibernate

Może się czasem zdarzyć, że otrzymamy wyjątek od NHibernate i nie wiemy, na czym polega błąd, ponieważ rzucany wyjątek nie ma szczegółowych informacji. Gdy wydaje nam się, że wszystkie mapowania są poprawne , a otrzymujemy poniższy wyjątek, należy upewnić się, czy gdzieś w definicji mapowania nie ma próby podmapowania dwóch właściwości do tej samej kolumny tabeli:

Index was out of range. Must be non-negative and less than the size of the collection. Parameter name: index.

np.(mapowanie Fluent)

...
Map(e => e.Code, "Code");
Map(e => e.CodeType, "Code");
...