# CoreDataEnvirSample

**Repository Path**: cmduan/CoreDataEnvirSample

## Basic Information

- **Project Name**: CoreDataEnvirSample
- **Description**: 一个 CoreData 的轻便封装。提供简单的CRUD数据操作，不再纠缠于 CoreData 的环境配置上；同时提供了多种运行模式，可以指定不同的图形化模型映射文件 xcdatamodeld，保存数据到任何指定的文件；通过遵循线程私有化上下文原则，提供了有效的多线程数据操作支持。
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2019-04-22
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

CoreDataEnvir (2011-05-25)
=============

A CoreData Envirement wrapper, use CoreData in convient way. You can use it in concurrency，run seperate CoreDataEnvir instance on one thread.

##First step:
	//Register your data base file name
	[CoreDataEnvir registDatabaseFileName:@"db.sqlite"];
	//Register your model file name(no extension)
	[CoreDataEnvir registModelFileName:@"SampleModel"];


##On main thread:

#Insert item:
	Team *team = [Team insertItem];
	or
	[Team insertItemWith:^(Team *item) {
		item.name = [NSString stringWithFormat:@"Nicholas"];
	}];
	
	[team save];//Save to data base on main thread.
	or
	[team remove];//Remove from data on main thread.

#Fetch one item:
	Team *team = (Team *)[Team lastItemWith:[NSPredicate predicateWithFormat:@"name==nicholas"]];

#Fetch all items:
	NSArray *allItems = [Team items];

##If you want to run on other threads, follow this:

This method ([CoreDataEnvir instance]) will automatically creating a new instance for non-main thread every callback and uniq instance for main thread. So your should keep CoreDataEnvir instance on non-main thread yourself.
But in latest version , I supply a backgroundInstance and backgroundQueue for your concurrencyly usage in Dispatch queue. You can also run CoreDataEnvir on any other queue:
	
	dispatch_queue_t q2 = dispatch_queue_create("com.cyblion.coredateenvir", NULL);
	dispatch_async(q2, ^{
		CoreDataEnvir *db = [CoreDataEnvir instance];
		for (int i = 0; i < 500; i++) {
			Team *team = (Team *)[Team lastItemWith:db predicate:[NSPredicate predicateWithFormat:@"name==9"]];
			if (team) {
				[team removeFrom:db];//Remove from db.
			}else {
				[Team insertItemWith:db fillData:^(Team *item) {
					item.name = [NSString stringWithFormat:@"9"];
				}];
				
			}
			[team saveTo:db];//Save db.
		}
	});

##If your are newcomer to CoreData, please obey the rules below:
If you wanna keep you NSManagedObject objects, you shouldn't release you CoreDataEnvir object or it will be fault. So if you operate data base in multiple threads, make sure your NSManagedObject object reference fetched from [CoreDataEnvir mainInstance] or [CoreDataEnvir backgroundInstance] which never be released until application exist.