NServiceKit OrmLite/基本的な使い方

まずは以下を熟読すべし。基本的な使い方は以下に書かれている。ここではそれに対する補足などを記載する。

• https://github.com/NServiceKit/NServiceKit.OrmLite/blob/master/README.md

注意

これはServiceStack OrmLiteではなくNServiceKit OrmLiteのお話です。

SELECT

一般的なSELECT

英語が読めなくても見ればわかる。

• https://github.com/NServiceKit/NServiceKit.OrmLite/blob/master/README.md

SqlExpressionVisitor<T>クラスを用いる

OrmLiteのSELECTメソッドはWHERE句に相当する。中身はLINQでも直書きSQLでも受け付ける。

ただSELECTメソッドは遅延評価ではなく、いきなり実行される。このためLINQを使った場合は、複数の条件式を徐々に組み立てたり、ORDER BY句によるソートなども一切出来ない。これでは使い物にならない。

そのような用途のためにSqlExpressionVisitor<T>クラスが用意されている。 SqlExpressionVisitorを用いてクエリを組み立て、最後にSELECTメソッドに食わせてやるという、いわゆるSqlBuilderである。

SqlExpressionVisitorが吐き出すSQL文はデータベースに依存するため、事前にOrmLiteConfig.DialectProviderを適切に設定したうえで、ExpressionVisitor<T>()メソッドでインスタンスを取得するようになっている。

なお、一部のデータベースではSqlExpressionVisitorの派生クラスが完璧に実装されていない開発途上のものも存在するので注意を要する。とりあえずMySQLのものはそこそこ動くようだ。

            OrmLiteConfig.DialectProvider = MySqlDialectProvider.Instance;

            var cs = ConfigurationManager.ConnectionStrings["MySQL"].ConnectionString;
            var db = cs.OpenDbConnection();

            db.CreateTable<User>(overwrite: true);
            db.Insert<User>(new User { Id = 1, Name = "上級国民", });
            db.Insert<User>(new User { Id = 2, Name = "一般国民", });
            db.Insert<User>(new User { Id = 3, Name = "その他", });

            var ev = OrmLiteConfig.DialectProvider.ExpressionVisitor<User>();
            ev.Where(x => x.Id == 2);
            ev.Or(x => x.Id == 3);

            var rows = db.Select(ev);

関連項目

• NServiceKit OrmLite
• NServiceKit OrmLite/データベースに接続する