狠狠撸

Introduction to
CocoaSQLMapper
Kenji Nishishiro
@marvelph

13年1月26日土曜日

颁辞肠辞补厂蚕尝惭补辫辫别谤とは?

Objective-CからSQLiteを利用するためのフレー
ムワークです。

JavaのiBATISの影響を受けています。


対象となる开発者

SQLiteのC API、あるいは FMDBのようなラッパ
ーライブラリを利用している開発者。

なぜCoreDataを使わないのか、説明が必要無
い開発者。


サンプルテーブル

key name age

1 kenji 41
列に型は不要です 2 yoshiko 41

3 izumi 17

keyはautoincrementです 4 sumika 14


モデルクラス

@interface Person : NSObject

@property (nonatomic) long long key;
@property (nonatomic) NSString *name;
@property (nonatomic) NSNumber *age;

@end

テーブルの列名とプロパティ名をえます


一行読み込み

SMDatabase *database = [[SMDatabase alloc] initWithPath:path error:nil];

NSString *sql = @"SELECT * FROM Person WHERE name = 'kenji'";
Person *person = [database selectObjectBySQL:sql parameter:nil resultClass:[Person class]
error:nil];

SQLとモデルのクラスを与えると、
インスタンスが得られます


复数行読み込み
NSString *sql = @"SELECT * FROM Person";
NSArray *persons = [database selectArrayBySQL:sql parameter:nil
resultClass:[Person class] error:nil];

インスタンスの配列が、
NSArayで得られます


集计
@interface Count : NSObject

@property (nonatomic) int value;

@end

NSString *sql = @"SELECT COUNT(*) AS value FROM Person";
Count *count = [database selectObjectBySQL:sql parameter:nil resultClass:
[Count class] error:nil];

結果セットに、
AS句でプロパティ名を付けています


ここまでのまとめ
テーブルのデータをモデルに読み込む事が
できます。

テーブルのスキーマでは無く、SQLとマッピ
ングします。

データの型はモデルから決定されます。


オープンソース

https://github.com/marvelph/CocoaSQLMapper


パラメータ
@interface Parameter : NSObject

@property (nonatomic, strong) NSNumber *value1;
@property (nonatomic, strong) NSNumber *value2;

@end

Parameter *parameter = [[Parameter alloc] init];
parameter.value1 = @10;
parameter.value2 = @20;
NSString *sql = @"SELECT * FROM Person WHERE :value1 <= age AND age <= :value2";
NSArray *persons = [database selectArrayBySQL:sql parameter:parameter resultClass:
[Person class] error:nil];

バインド変数名をプロパティ名に合わせます

挿入
Person *person = [[Person alloc] init];
person.name = @"setuna";
person.age = @11;
long long int key = [database insertBySQL:@"INSERT INTO Person (name, age)
VALUES(:name, :age)" parameter:person error:nil];
person.key = key;

autoincrementされたkeyが手に入るので、
行の読み込みが不要です
後でupdateする時に必要ですよね?


更新
更新された行数が手に入るので、
悲観的ロックなどにどうぞ

Person *person = [[Person alloc] init];
person.key = 1;
person.age = @31;
int count = [database updateBySQL:@"UPDATE Person SET age = :age WHERE key
= :key" parameter:person error:nil];


削除

deleteBySQLというメソッドがありますが、
これは更新と一緒です


DDL

挿入?更新?削除以外のSQLには、
特別な値を返さないexecuteBySQLを用います


型のマッピング
int long long BOOL ?oat double NSNumber NSDate NSString NSData nil

int int64 int double double any double text bytes null

NSNumberは中身次第です
NSDateはエポックからの経過秒数です
NSStringはUTF8として扱います

ヒント
nullを検索する時は、SQLにIS NULLと記述しな
くても、パラメータにnilを指定する事で実
現できます。

NSNumberは、数値プロパティがnilを許したい
時に用います。


ヒント

モデルにはゲッターとセッターでは無く、
本物のプロパティが必要です。

エラーの取得はオプションです。


ここまでのまとめ

挿入?更新?削除と操作別のメソッドがあ
ります。

扱えるプロパティの型には制限がありま
す。


行単位の処理
NSString *sql = @"SELECT * FROM Person";
[database selectWithBlock:^BOOL(Person *person, NSError
*__autoreleasing *error) {
return YES;
} bySQL:sql parameter:nil resultClass:[Person class] error:nil];

行単位でブロックが呼び出されます
結果行数が多い場合に、
NSArrayの生成を避ける事ができます
ブロックがNOを返すと中断します

トランザクション

transactionWithBlockに渡したブロック内の処理を、
トランザクジョンとして纏める事ができます
ブロックがNOを返すとロールバックします
サンプルを読んでください


エラー処理

トランザクションブロック内側のエラーは、
パラメータに返してください
トランザクション自体のエラーと一括処理できま
す
サンプルを読んでください


マルチスレッド

SMDatabaseのインスタンスをスレッド毎に生
成してください。

デッドロック発生時のタイムアウトは未実
装です。


実绩

PoiCaのiOS版で1年以上実際に使用していま
す。http://poica.me/


设计

SQLを設定ファイルに分離する事は、可読性
を下げると考えています。

SQLのプリコンパイルは、メリットが少ない
と考えています。


构想
パラメータの為にクラスを定義する事が面
倒なので、NSDictionaryを使えるようにしたい
です。この場合、NSNullのサポートも必要か
もしれません。

マルチスレッド利用時に、タイムアウトを
サポートしたいです。

ありがとうございました


狠狠撸

Introduction to cocoa sql mapper

Recommended

More Related Content

Viewers also liked (20)

Similar to Introduction to cocoa sql mapper (17)

Recently uploaded (7)

Introduction to cocoa sql mapper