NSFetchRequestクラス

2011. 05. 03
●概要

NSFetchRequestのインスタンスは、永続ストアからデータを取得ために使用する検索基準を記述します。

インスタンスは、永続ストア内に保持されているレコードに関するデータ、または管理オブジェクトのグループの選択(とオプションで順序)に必要な基準を収集します。

フェッチ要求には、検索するエンティティを指定するエンティティ記述(NSEntityDescriptionのインスタンス)が含まれている必要があります。

それらは頻繁に含まれます。
  • 述語(NSPredicateのインスタンス)は、例えば『姓が『J』で始まる』といった、選択するプロパティや選択上の制約を指定します。
    述語を指定しなかった場合、指定したエンティティの全てのインスタンスが選択されます。
    (他にも制約の条件はありますので、完全な詳細はexecuteFetchRequest:error:を参照してください)

  • ソート記述語(NSSortDescriptorのインスタンス)の配列は、例えば『姓の後に名を』といった、オブジェクトをどのような順序で返すかを指定します。
またフェッチ要求は、要求が返すオブジェクトの最大数や、要求がアクセスするデータの格納など、他の面も指定することができます。

Mac OS X v10.5以降では、フェッチが返すものが管理オブジェクトか単なるオブジェクトIDか、オブジェクトが完全にそれらのプロパティを実装しているかに関わらず、指定することができます。
resultTypeincludesSubentitiesincludesPropertyValuesreturnsObjectsAsFaults参照)

Mac OS X v10.6以降とiOSでは更に、フェッチへのプロパティ、フェッチのオフセット、フェッチが実行されている時の管理オブジェクトコンテキスト内にある現在未保存の変更に対する照合などを指定することができます。
resultTypepropertiesToFetchfetchOffsetincludesPendingChanges参照)

またCore Data Snippetsで説明されているように、与えられた関数を満たす異なったプロパティ値や属性値をフェッチすることもできます。

NSFetchRequestオブジェクトは、NSManagedObjectContextで定義されているメソッドexecuteFetchRequest:error:で使用します。

頻繁に管理オブジェクトモデル内のフェッチ要求を事前定義するには、名前によって格納されたフェッチ要求を取得するAPIが、NSManagedObjectModelから提供されています。

格納されたフェッチ要求は、変数を置換するためのプレースホルダが含まれていて、以降の完成品のためのテンプレートとして利用できます。

フェッチ要求のテンプレートはしたがって、実行時に置換される変数で、事前定義することができます。



●タスク

エンティティ

– entity
– setEntity:
– includesSubentities
– setIncludesSubentities:

フェッチ制約

– predicate
– setPredicate:
– fetchLimit
– setFetchLimit:
– fetchOffset
– setFetchOffset:
– fetchBatchSize
– setFetchBatchSize:
– affectedStores
– setAffectedStores:

並べ替え

– sortDescriptors
– setSortDescriptors:

プリフェッチ

– relationshipKeyPathsForPrefetching
– setRelationshipKeyPathsForPrefetching:

返される結果の管理

– resultType
– setResultType:
– includesPendingChanges
– setIncludesPendingChanges:
– propertiesToFetch
– setPropertiesToFetch:
– returnsDistinctResults
– setReturnsDistinctResults:
– includesPropertyValues
– setIncludesPropertyValues:
– returnsObjectsAsFaults
– setReturnsObjectsAsFaults:



●インスタンスメソッド

setEntity:

- (void)setEntity:(NSEntityDescription *)entity

レシーバのエンティティを設定します。

entity:レシーバのエンティティを指定します。


setPredicate:

- (void)setPredicate:(NSPredicate *)predicate

レシーバの述語を設定します。

predicate:レシーバの述語を指定します。



●定数



参考文献

NSFetchRequest Class Reference






bose_soundlink_revolve
0 Comments
Leave a comment
管理者にだけ表示を許可する
Top
0 Trackbacks
Top
Calendar
03 | 2017/04 | 05
Sun Mon Tue Wed Thu Fri Sat
- - - - - - 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 - - - - - -
Recent Articles
iTunes


Swift
Categories
Tips
Profile

水月杏香

Author:水月杏香
永遠の初心者プログラマ。

Wish List
WACOM


ARC
Technical Q&A
情報プロパティリストキー
Start Developing iOS Apps Today
BOSE

bose_soundlink_revolve
Reference
NSApplicationDelegateプロトコル
NSArrayクラス
NSAutoreleasePoolクラス
NSBundleクラス
NSBundle UIKit追加分
NSCalendarクラス
NSCoderクラス
NSCodingプロトコル
NSCopyingプロトコル
NSDataクラス
NSDateクラス
NSDateFormatterクラス
NSDictionaryクラス
NSEntityDescriptionクラス
NSEnumeratorクラス
NSErrorクラス
NSExceptionクラス
NSFetchRequestクラス
NSFileHandleクラス
NSFileManagerクラス
NSIndexPathクラス
NSIndexPath UIKit追加分
NSKeyedArchiverクラス
NSKeyedUnarchiverクラス
NSKeyValueCodingプロトコル
NSLocaleクラス
NSManagedObjectクラス
NSManagedObjectContextクラス
NSManagedObjectModelクラス
NSMutableArrayクラス
NSMutableCopyingプロトコル
NSMutableDictionaryクラス
NSMutableSetクラス
NSNotificationクラス
NSNotificationCenterクラス
NSNullクラス
NSNumberクラス
NSObjectクラス
NSObject UIKit追加分
NSObjectプロトコル
NSPersistentStoreクラス
NSPersistentStoreCoordinatorクラス
NSPredicateクラス
NSPropertyListSerializationクラス
NSRunLoopクラス
NSSetクラス
NSStringクラス
NSString UIKit追加分
NSTimerクラス
NSTimeZoneクラス
NSURLクラス
NSURLProtectionSpaceクラス
NSURLRequestクラス
NSUserDefaultsクラス
NSValueクラス

UIActionSheetクラス
UIActionSheetDelegateプロトコル
UIActivityIndicatorViewクラス
UIAlertViewクラス
UIAlertViewDelegateプロトコル
UIApplicationクラス
UIApplicationDelegateプロトコル
UIBarButtonItemクラス
UIBarItemクラス
UIButtonクラス
UIColorクラス
UIControlクラス
UIDatePickerクラス
UIDeviceクラス
UIEventクラス
UIFontクラス
UIGestureRecognizerクラス
UIImageクラス
UIImageViewクラス
UIKit Function
UILabelクラス
UINavigationControllerクラス
UINavigationItemクラス
UIPickerViewクラス
UIPickerViewDataSourceプロトコル
UIPickerViewDelegateプロトコル
UIPinchGestureRecognizerクラス
UIResponderクラス
UIScreenクラス
UIScrollViewクラス
UISearchBarクラス
UISearchBarDelegateプロトコル
UISegmentedControlクラス
UISliderクラス
UISwipeGestureRecognizerクラス
UISwitchクラス
UITableViewクラス
UITableViewCellクラス
UITableViewControllerクラス
UITableViewDataSourceプロトコル
UITableViewDelegateプロトコル
UITapGestureRecognizerクラス
UITextFieldクラス
UITextFieldDelegateプロトコル
UITextInputTraitsプロトコル
UITextViewクラス
UITextViewDelegateプロトコル
UIToolbarクラス
UITouchクラス
UIViewクラス
UIViewControllerクラス
UIWebViewクラス
UIWebViewDelegateプロトコル
UIWindowクラス

AVAudioPlayerクラス
AVAudioPlayerDelegateプロトコル

CADisplayLinkクラス
CAEAGLLayerクラス
CALayerクラス

CGAffineTransform
CGBitmapContext
CGColor
CGColorSpace
CGContext
CGGeometry
CGImage
CGPath

EAGLContextクラス
EAGLDrawableプロトコル

Foundation Constants
Foundation Data Types
Foundation Functions

MPMediaItemクラス
MPMediaItemArtworkクラス
MPMediaPlaylistクラス
MPMediaPropertyPredicateクラス
MPMediaQueryクラス
MPMusicPlayerControllerクラス

Randomization Services

System Sound Services
Amazon


OpenGL ES
SQLite
Monthly Archives
Recent Comments
Recent TrackBacks
RSS Link
Visitors
QR Code
QR