Nepenthes | 繁體 | 简体

Prerequisites

1. Connected iOS device to your Mac.
2. Create an iOS project with Single View Application:NepenthesClient,Language:Objective-C Devices:Universal.
   
   
3. Download and unzip it.
   • Nepenthes.framework.zip (Generic iOS Device)
   • Nepenthes.framework.zip (iPad Air Simulator)
   • Nepenthes.framework.zip (iPad Air 2 Simulator)
   • Nepenthes.framework.zip (iPad Pro 9.7 inch Simulator)
   • Nepenthes.framework.zip (iPad Pro 12.9 inch Simulator)
   • Nepenthes.framework.zip (iPad Retina Simulator)
   • Nepenthes.framework.zip (iPhone 5 Simulator)
   • Nepenthes.framework.zip (iPhone 5S Simulator)
   • Nepenthes.framework.zip (iPhone 6 Simulator)
   • Nepenthes.framework.zip (iPhone 6 Plus Simulator)
   • Nepenthes.framework.zip (iPhone 6S Simulator)
   • Nepenthes.framework.zip (iPhone 6S Plus Simulator)
   • Nepenthes.framework.zip (iPhone 7 Simulator)
   • Nepenthes.framework.zip (iPhone 7 Plus Simulator)
   • Nepenthes.framework.zip (iPhone SE Simulator)
4. Drag Nepenthes.framework to the project.
   
5. Create Config.plist with the following contents.(Make sure Host and Port are your own specified values. Server is running on your Mac,iPhone will connect to your Mac,so please make sure the Host is the Mac address.)
   
6. Xcode iOSClient Project Download

JSON Object

1. Objective-C JSON Object mapping to backend Schema Object. All the mapping properties should all be NSString type. Create iOS class subclass of AbstractJson
   
2. UserJson.h #import <Nepenthes/Nepenthes.h> @interface UserJson : AbstractJson { NSString *ID; NSString *Name; NSString *Gender; NSString *Age; NSString *Height; NSString *Birthdate; NSString *Memo; NSString *RegisterTime; } @property(nonatomic,retain) NSString *ID; @property(nonatomic,retain) NSString *Name; @property(nonatomic,retain) NSString *Gender; @property(nonatomic,retain) NSString *Age; @property(nonatomic,retain) NSString *Height; @property(nonatomic,retain) NSString *Birthdate; @property(nonatomic,retain) NSString *Memo; @property(nonatomic,retain) NSString *RegisterTime; @end
3. UserJson.m #import "UserJson.h" @implementation UserJson @synthesize ID; @synthesize Name; @synthesize Gender; @synthesize Age; @synthesize Height; @synthesize Birthdate; @synthesize Memo; @synthesize RegisterTime; @end

BLSync Object

1. All the Objective-C BL Objects start with BLSync prefix. BL object manipulate json object with backend service. Create BLSyncUser extended from BLSyncAbstract
   
2. BLSyncUser.h #import <Nepenthes/Nepenthes.h> #import "UserJson.h" @interface BLSyncUser : BLSyncAbstract -(BOOL)insert:(UserJson *)json; -(BOOL)delete:(NSString *)whereClause; -(BOOL)deleteByID:(NSString *)ID; -(BOOL)update:(UserJson *)json; -(NSInteger)getCount:(NSString *)whereClause; -(NSArray *)select:(NSString *)whereClause; -(NSArray *)select:(NSString *)whereClause index:(NSString *)index step:(NSString *)step; -(UserJson *)getJson:(NSString *)ID; @end
3. BLSyncUser.m #import "BLSyncUser.h" @implementation BLSyncUser -(BOOL)insert:(UserJson *)json { return [super insert:json]; } -(BOOL)delete:(NSString *)whereClause { return [super delete:whereClause]; } -(BOOL)deleteByID:(NSString *)ID { return [self delete:[@"ID=" stringByAppendingString:ID]]; } -(BOOL)update:(UserJson *)json { return [super update:json]; } -(NSInteger)getCount:(NSString *)whereClause { return [super getCount:whereClause]; } -(NSArray *)select:(NSString *)whereClause { return [super select:whereClause]; } -(NSArray *)select:(NSString *)whereClause index:(NSString *)index step:(NSString *)step { return [super select:whereClause index:index step:step]; } -(UserJson *)getJson:(NSString *)ID { UserJson *json = nil; NSArray *result = [self select:[@"ID=" stringByAppendingString:ID]]; if(result) { json = [UserJson getJson:[result objectAtIndex:0]]; } return json; } @end
4. So far your project should looks like
   

Invoke backend service

1. In order to make App call server,you need add the following codes to info.plist <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
2. We will invoke backend service in ViewController.h and ViewController.m
3. ViewController.h #import <UIKit/UIKit.h> #import "UserJson.h" #import "BLSyncUser.h" @interface ViewController : UIViewController @end
4. ViewController.m (you can uncomment different blocks to test that function) #import "ViewController.h" @interface ViewController () @end @implementation ViewController - (void)viewDidLoad { [super viewDidLoad]; //Create BLSyncUser Object BLSyncUser *blSyncUser = [BLSyncUser new]; //Create UserJson Object UserJson *userJson = [UserJson new]; userJson.Name = @"Nepenthes"; userJson.Gender = @"M"; userJson.Age = @"6"; userJson.Height = @"1.71"; userJson.Birthdate = @"1981-11-18"; userJson.Memo = @"Memo"; userJson.RegisterTime = @"2016-04-22 18:00:00"; //insert //BOOL flag = [blSyncUser insert:userJson]; //NSLog(@"insert:%d",flag); //getCount //NSString *whereClause = @"1=1"; //NSInteger count = [blSyncUser getCount:whereClause]; //NSLog(@"getCount:%ld",(long)count); //getJson //NSString *ID = @"1"; //userJson = [blSyncUser getJson:ID]; //NSLog(@"getJson:%@",[userJson toJsonStr]); //update //userJson.Memo = @"test"; //BOOL flag = [blSyncUser update:userJson]; //NSLog(@"update:%d",flag); //deleteByID //NSString *ID = @"1"; //BOOL flag = [blSyncUser deleteByID:ID]; //NSLog(@"deleteByID:%d",flag); //delete //NSString *whereClause = @"1=1"; //BOOL flag = [blSyncUser delete:whereClause]; //NSLog(@"delete:%d",flag); //select /*NSString *whereClause = @"1=1"; NSArray *result = [blSyncUser select:whereClause]; for(NSDictionary *record in result) { UserJson *json = [UserJson getJson:record]; NSLog(@"%@",[json toJsonStr]); }*/ } - (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; // Dispose of any resources that can be recreated. } @end

Summary

Json Object is mapped to backend Schema Object. BLSync Object provides the necessary function to manipulate database via backend service. With the following functions,you can manipulate almost all the operations to the remote database precisely. This chapter show you how to build a block for a sophiscated App.

//insert object to database
-(BOOL)insert:(UserJson *)json;

//delete records by where condition,whereClause is the strings after SQL key word WHERE
-(BOOL)delete:(NSString *)whereClause;

//delete record by ID
-(BOOL)deleteByID:(NSString *)ID;

//update record
-(BOOL)update:(UserJson *)json;

//getCount by where condition
-(NSInteger)getCount:(NSString *)whereClause;

//select all records by where condition
-(NSArray *)select:(NSString *)whereClause;

//select specified records by where condition
-(NSArray *)select:(NSString *)whereClause index:(NSString *)index step:(NSString *)step;

//getJson by ID
-(UserJson *)getJson:(NSString *)ID;