Paintinglite|Paintinglite -- Sqlite3 SDK Specially Designed For iOS
Paintinglite
Github: https://github.com/CreaterOS/...
文章图片
Pod installation
pod'Paintinglite', :git =>'https://github.com/CreaterOS/Paintinglite.git'#, :tag => '2.1.1'Introduction Paintinglite is an excellent and fast Sqlite3 database framework. Paintinglite has good encapsulation of data, fast data insertion characteristics, and can still show good resource utilization for huge amounts of data.
Paintinglite supports object mapping and has carried out a very lightweight object encapsulation on sqlite3. It establishes a mapping relationship between POJOs and database tables. Paintinglite can automatically generate SQL statements and manually write SQL statements to achieve convenient development and efficient querying. All-in-one lightweight framework.
Database operation (PaintingliteSessionManager) 1. Build a library Create PaintingliteSessionManager, create a database through the manager.
-(Boolean)openSqlite:(NSString *)fileName;
-(Boolean)openSqlite:(NSString *)fileName completeHandler:(void(^ __nullable)(NSString *filePath,PaintingliteSessionError *error,Boolean success))completeHandler;
Paintinglite has a good processing mechanism. It creates a database by passing in the database name. Even if the database suffix is ??not standardized, it can still create a database with a .db suffix.
[self.sessionM openSqlite:@"sqlite"];
[self.sessionM openSqlite:@"sqlite02.db"];
[self.sessionM openSqlite:@"sqlite03.image"];
[self.sessionM openSqlite:@"sqlite04.text"];
[self.sessionM openSqlite:@"sqlite05.."];
Get the absolute path of the created database.
[self.sessionM openSqlite:@"sqlite" completeHandler:^(NSString * _Nonnull filePath, PaintingliteSessionError * _Nonnull error, Boolean success) {
if (success) {
NSLog(@"%@",filePath);
}
}];
2. Close the library
-(Boolean)releaseSqlite;
-(Boolean)releaseSqliteCompleteHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
3. Create a table
-(Boolean)execTableOptForSQL:(NSString *)sql;
-(Boolean)execTableOptForSQL:(NSString *)sql completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)createTableForName:(NSString *)tableName content:(NSString *)content;
-(Boolean)createTableForName:(NSString *)tableName content:(NSString *)content completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)createTableForObj:(id)obj createStyle:(PaintingliteDataBaseOptionsCreateStyle)createStyle;
-(Boolean)createTableForObj:(id)obj createStyle:(PaintingliteDataBaseOptionsCreateStyle)createStyle completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
Three ways to create a table:
- SQL creation
[self.sessionM execTableOptForSQL:@"CREATE TABLE IF NOT EXISTS cart(UUID VARCHAR(20) NOT NULL PRIMARY KEY,shoppingName TEXT,shoppingID INT(11))" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success) {
if (success) {
NSLog(@"===CREATE TABLE SUCCESS===");
}
}];
- Table name creation
[self.sessionM createTableForName:@"student" content:@"name TEXT,age INTEGER"];
- Object creation
User *user = [[User alloc] init];
[self.sessionM createTableForObj:user createStyle:PaintingliteDataBaseOptionsUUID];
Object creation can automatically generate primary keys:
| Primary key | Type |
|---|---|
| UUID | String |
| ID | Value |
-(Boolean)execTableOptForSQL:(NSString *)sql;
-(Boolean)execTableOptForSQL:(NSString *)sql completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(BOOL)alterTableForName:(NSString *__nonnull)oldName newName:(NSString *__nonnull)newName;
-(BOOL)alterTableForName:(NSString *__nonnull)oldName newName:(NSString *__nonnull)newName completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(BOOL)alterTableAddColumnWithTableName:(NSString *)tableName columnName:(NSString *__nonnull)columnName columnType:(NSString *__nonnull)columnType;
-(BOOL)alterTableAddColumnWithTableName:(NSString *)tableName columnName:(NSString *__nonnull)columnName columnType:(NSString *__nonnull)columnType completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(BOOL)alterTableForObj:(id)obj;
-(BOOL)alterTableForObj:(id)obj completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
Three ways to update the table:
- SQL Update
- Table name update [table name | table field]
[self.sessionM alterTableForName:@"cart" newName:@"carts"];
[self.sessionM alterTableAddColumnWithTableName:@"carts" columnName:@"newColumn" columnType:@"TEXT"];
- Object update
Update User table operation
#import NS_ASSUME_NONNULL_BEGIN@interface User: NSObject@property (nonatomic,strong)NSString *name;
@property (nonatomic,strong)NSNumber *age;
@property (nonatomic,strong)NSMutableArray *mutableArray;
@endNS_ASSUME_NONNULL_END According to the mapping relationship between the table and the object, the table fields are automatically updated according to the object.
User *user = [[User alloc] init];
[self.sessionM alterTableForObj:user];
5. Delete operation
-(Boolean)execTableOptForSQL:(NSString *)sql;
-(Boolean)execTableOptForSQL:(NSString *)sql completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)dropTableForTableName:(NSString *)tableName;
-(Boolean)dropTableForTableName:(NSString *)tableName completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)dropTableForObj:(id)obj;
-(Boolean)dropTableForObj:(id)obj completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
Three ways to delete a table:
- SQL operations
- Table name deletion
[self.sessionM execTableOptForSQL:@"DROP TABLE carts" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success) {
if (success) {
NSLog(@"===DROP TABLE SUCCESS===");
}
}];
- Object deletion
User *user = [[User alloc] init];
[self.sessionM dropTableForObj:user];
Table operation 1. Query
Query can provide the feature of query results encapsulated in array or directly encapsulated by object.
- General inquiry
-General enquiries
-(NSMutableArray *)execQuerySQL:(NSString *__nonnull)sql;
-(Boolean)execQuerySQL:(NSString *__nonnull)sql completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray))completeHandler;
[self.sessionM execQuerySQL:@"SELECT * FROM student" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
for (NSDictionary *dict in resArray) {
NSLog(@"%@",dict);
}
}
}];
2020-06-27 15:35:45.967569+0800 Paintinglite[5805:295051] {-Package query
age = 21;
name = CreaterOS;
}
2020-06-27 15:35:45.967760+0800 Paintinglite[5805:295051] {
age = 19;
name = Painting;
}
2020-06-27 15:35:45.967879+0800 Paintinglite[5805:295051] {
age = 21;
name = CreaterOS;
}
Encapsulated query can encapsulate query results into objects corresponding to table fields.
-(id)execQuerySQL:(NSString *__nonnull)sql obj:(id)obj;
-(Boolean)execQuerySQL:(NSString *__nonnull)sql obj:(id)obj completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray *resObjList))completeHandler;
Student *stu = [[Student alloc] init];
[self.sessionM execQuerySQL:@"SELECT * FROM student" obj:stu completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
2020-06-27 15:39:27.306786+0800 Paintinglite[5892:302879] stu.name = CreaterOS and stu.age = 21
2020-06-27 15:39:27.306961+0800 Paintinglite[5892:302879] stu.name = Painting and stu.age = 19
2020-06-27 15:39:27.307110+0800 Paintinglite[5892:302879] stu.name = CreaterOS and stu.age = 21
- Conditional query
Conditional query syntax rules:
-Subscripts start from 0
-Use? As a placeholder for conditional parameters
SELECT * FROM user WHERE name =? And age =?-(NSMutableArray *)execPrepareStatementSql;
-(Boolean)execPrepareStatementSqlCompleteHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray))completeHandler;
[self.sessionM execQuerySQLPrepareStatementSql:@"SELECT * FROM student WHERE name = ?"];
[self.sessionM setPrepareStatementPQLParameter:0 paramter:@"CreaterOS"];
NSLog(@"%@",[self.sessionM execPrepareStatementSql]);
2020-06-27 15:44:06.664951+0800 Paintinglite[5984:310580] (
{
age = 21;
name = CreaterOS;
},
{
age = 21;
name = CreaterOS;
}
)
- Fuzzy query
-(NSMutableArray *)execLikeQuerySQLWithTableName:(NSString *__nonnull)tableName field:(NSString *__nonnull)field like:(NSString *__nonnull)like;
-(Boolean)execLikeQuerySQLWithTableName:(NSString *__nonnull)tableName field:(NSString *__nonnull)field like:(NSString *__nonnull)like completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray))completeHandler;
-(id)execLikeQuerySQLWithField:(NSString *__nonnull)field like:(NSString *__nonnull)like obj:(id)obj;
-(Boolean)execLikeQuerySQLWithField:(NSString *__nonnull)field like:(NSString *__nonnull)like obj:(id)obj completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray* resObjList))completeHandler;
[self.sessionM execLikeQuerySQLWithTableName:@"student" field:@"name" like:@"%t%" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
for (NSDictionary *dict in resArray) {
NSLog(@"%@",dict);
}
}
}];
Student *stu = [[Student alloc] init];
[self.sessionM execLikeQuerySQLWithField:@"name" like:@"%t%" obj:stu completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (NSDictionary *dict in resArray) {
NSLog(@"%@",dict);
}
}
}];
2020-06-27 15:46:31.310495+0800 Paintinglite[6030:314851] {
age = 21;
name = CreaterOS;
}
2020-06-27 15:46:31.310701+0800 Paintinglite[6030:314851] {
age = 19;
name = Painting;
}
2020-06-27 15:46:31.310868+0800 Paintinglite[6030:314851] {
age = 21;
name = CreaterOS;
}
- Paging query
-(NSMutableArray *)execLimitQuerySQLWithTableName:(NSString *__nonnull)tableName limitStart:(NSUInteger)start limitEnd:(NSUInteger)end;
-(Boolean)execLimitQuerySQLWithTableName:(NSString *__nonnull)tableName limitStart:(NSUInteger)start limitEnd:(NSUInteger)end completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray))completeHandler;
-(id)execLimitQuerySQLWithLimitStart:(NSUInteger)start limitEnd:(NSUInteger)end obj:(id)obj;
-(Boolean)execLimitQuerySQLWithLimitStart:(NSUInteger)start limitEnd:(NSUInteger)end obj:(id)obj completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray* resObjList))completeHandler ;
[self.sessionM execLimitQuerySQLWithTableName:@"student" limitStart:0 limitEnd:1 completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
for (NSDictionary *dict in resArray) {
NSLog(@"%@",dict);
}
}
}];
Student *stu = [[Student alloc] init];
[self.sessionM execLimitQuerySQLWithLimitStart:0 limitEnd:1 obj:stu completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
2020-06-27 15:51:13.026776+0800 Paintinglite[6117:323796] stu.name = CreaterOS and stu.age = 21
- Sort query
-(NSMutableArray *)execOrderByQuerySQLWithTableName:(NSString *__nonnull)tableName orderbyContext:(NSString *__nonnull)orderbyContext orderStyle:(PaintingliteOrderByStyle)orderStyle;
-(Boolean)execOrderByQuerySQLWithTableName:(NSString *__nonnull)tableName orderbyContext:(NSString *__nonnull)orderbyContext orderStyle:(PaintingliteOrderByStyle)orderStyle completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray))completeHandler;
-(id)execOrderByQuerySQLWithOrderbyContext:(NSString *__nonnull)orderbyContext orderStyle:(PaintingliteOrderByStyle)orderStyle obj:(id)obj;
-(Boolean)execOrderByQuerySQLWithOrderbyContext:(NSString *__nonnull)orderbyContext orderStyle:(PaintingliteOrderByStyle)orderStyle obj:(id)obj completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray* resObjList) )completeHandler;
Student *student = [[Student alloc] init];
[self.sessionM execOrderByQuerySQLWithOrderbyContext:@"name" orderStyle:PaintingliteOrderByDESC obj:student completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resOb
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
2020-06-27 15:55:06.714604+0800 Paintinglite[6196:331097] stu.name = Painting and stu.age = 192. Increase data
2020-06-27 15:55:06.714801+0800 Paintinglite[6196:331097] stu.name = CreaterOS and stu.age = 21
2020-06-27 15:55:06.714962+0800 Paintinglite[6196:331097] stu.name = CreaterOS and stu.age = 21
-(Boolean)insert:(NSString *__nonnull)sql;
-(Boolean)insert:(NSString *__nonnull)sql completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)insertWithObj:(id)obj completeHandler:(void(^ __nullable)(PaintingliteSessionError *error,Boolean success))completeHandler;
- SQL Insert
[self.sessionM insert:@"INSERT INTO student(name,age) VALUES('CreaterOS',21),('Painting',19)"];
- Object Insertion
#import NS_ASSUME_NONNULL_BEGIN@interface Student: NSObject
@property (nonatomic,strong)NSString *name;
@property (nonatomic,strong)NSNumber *age;
@endNS_ASSUME_NONNULL_END Student *stu = [[Student alloc] init];
stu.name = @"ReynBryant";
stu.age = [NSNumber numberWithInteger:21];
[self.sessionM insertWithObj:stu completeHandler:nil];
For the huge amount of data, Paintinglit can still show good efficiency. It only takes 6ms-7ms to read 16 million pieces of data at a time.3. Update data
-(Boolean)update:(NSString *__nonnull)sql;
-(Boolean)update:(NSString *__nonnull)sql completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
-(Boolean)updateWithObj:(id)obj condition:(NSString *__nonnull)condition completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
- SQL update data
[self.sessionM update:@"UPDATE student SET name ='Painting' WHERE name ='ReynBryant'"];
- Object update
Student *stu = [[Student alloc] init]; stu.name = @"CreaterOS"; [self.sessionM updateWithObj:stu condition:@"age = 21" completeHandler:nil];
Added update operation, which can be updated by object transfer method4. Delete data
For example:
User *user = [[User alloc] init];
user.name = @"CreaterOS";
user.age = 21;
-(Boolean)del:(NSString *__nonnull)sql;
-(Boolean)del:(NSString *__nonnull)sql completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success))completeHandler;
PQL Syntax (PaintingliteSessionManager) Through the PQL statement, Paintinglite can automatically help you complete the writing of the SQL statement.
PQL grammar rules (uppercase | the class name must be associated with the table)
FROM + class name + [condition]
-(id)execPrepareStatementPQL;
-(Boolean)execPrepareStatementPQLWithCompleteHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray* resObjList))completeHandler;
-(void)execQueryPQLPrepareStatementPQL:(NSString *__nonnull)prepareStatementPQL;
-(void)setPrepareStatementPQLParameter:(NSUInteger)index paramter:(NSString *__nonnull)paramter;
-(void)setPrepareStatementPQLParameter:(NSArray *__nonnull)paramter;
-(id)execPQL:(NSString *__nonnull)pql;
-(Boolean)execPQL:(NSString *__nonnull)pql completeHandler:(void(^)(PaintingliteSessionError *error,Boolean success,NSMutableArray *resArray,NSMutableArray* resObjList))completeHandler;
[self.sessionM execPQL:@"FROM Student WHERE name ='CreaterOS'" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
2020-06-27 16:16:47.145774+0800 Paintinglite[6753:369828] stu.name = CreaterOS and stu.age = 21
2020-06-27 16:16:47.145928+0800 Paintinglite[6753:369828] stu.name = CreaterOS and stu.age = 21
[self.sessionM execPQL:@"FROM Student LIMIT 0,1" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
[self.sessionM execPQL:@"FROM Student WHERE name LIKE'%t%'" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
[self.sessionM execPQL:@"FROM Student ORDER BY name ASC" completeHandler:^(PaintingliteSessionError * _Nonnull error, Boolean success, NSMutableArray * _Nonnull resArray, NSMutableArray * _Nonnull resObjList) {
if (success) {
for (Student *stu in resObjList) {
NSLog(@"stu.name = %@ and stu.age = %@",stu.name,stu.age);
}
}
}];
[self.sessionM execQueryPQLPrepareStatementPQL:@"FROM Student WHERE name = ?"];
[self.sessionM setPrepareStatementPQLParameter:@[@"CreaterOS"]];
NSLog(@"%@",[self.sessionM execPrepareStatementPQL]);
2020-06-27 16:26:11.404815+0800 Paintinglite[7025:389268] (Aggregate function (PaintingliteAggregateFunc) Paintinglite encapsulates Sqlite3 aggregation functions, and automatically writes SQL statements to get the aggregation results.
"",
""
)
- Count
[self.aggreageteF count:[self.sessionM getSqlite3] tableName:@"eletest" completeHandler:^(PaintingliteSessionError * _Nonnull sessionerror, Boolean success, NSUInteger count) { if (success) { NSLog(@"%zd",count); } }];
- Max
[self.aggreageteF max:[self.sessionM getSqlite3] field:@"age" tableName:@"eletest" completeHandler:^(PaintingliteSessionError * _Nonnull sessionerror, Boolean success, double max) {
if (success) {
NSLog(@"%.2f",max);
}
}];
- Min
[self.aggreageteF min:[self.sessionM getSqlite3] field:@"age" tableName:@"eletest" completeHandler:^(PaintingliteSessionError * _Nonnull sessionerror, Boolean success, double min) {
if (success) {
NSLog(@"%.2f",min);
}
}];
- Sum
[self.aggreageteF sum:[self.sessionM getSqlite3] field:@"age" tableName:@"eletest" completeHandler:^(PaintingliteSessionError * _Nonnull sessionerror, Boolean success, double sum) {
if (success) {
NSLog(@"%.2f",sum);
}
}];
- Avg
[self.aggreageteF avg:[self.sessionM getSqlite3] field:@"age" tableName:@"eletest" completeHandler:^(PaintingliteSessionError * _Nonnull sessionerror, Boolean success, double avg) {
if (success) {
NSLog(@"%.2f",avg);
}
}];
Transaction (PaintingliteTransaction) Sqlite3 development defaults that an insert statement is a transaction. If there are multiple insert statements, the transaction will be repeated. This consumes a lot of resources. Paintinglite provides an operation to start a transaction (display transaction).
+ (void)begainPaintingliteTransaction:(sqlite3 *)ppDb;
+ (void)commit:(sqlite3 *)ppDb;
+ (void)rollback:(sqlite3 *)ppDb;
Daily development integrationCascade operation (PaintingliteCascadeShowerIUD)
@try {
} @catch (NSException *exception) {
} @finally {
}
Use
-(Boolean)cascadeInsert:(sqlite3 *)ppDb obj:(id)obj completeHandler:(void (^ __nullable)(PaintingliteSessionError *sessionError,Boolean success,NSMutableArray *resArray))completeHandler;
-(Boolean)cascadeUpdate:(sqlite3 *)ppDb obj:(id)obj condatation:(NSArray * __nonnull)condatation completeHandler:(void (^__nullable)(PaintingliteSessionError *sessionError,Boolean success,NSMutableArray *resArray)) completeHandler;
-(Boolean)cascadeDelete:(sqlite3 *)ppDb obj:(id)obj condatation:(NSArray * __nonnull)condatation completeHandler:(void (^__nullable)(PaintingliteSessionError *sessionError,Boolean success,NSMutableArray *resArray)) completeHandler;
The cascade is divided into three parts:
- Insert
For cascading insert operations, we need to connect two related tables through a variable array, for example:
The user table and the student table are linked,
A user can contain multiple students
User *user = [[User alloc] init];
user.name = @"Jay";
user.age = [NSNumber numberWithInteger:40];
user.studentsArray = [NSMutableArray array];
Student *student = [[Student alloc] init];
student.name = @"Hony";
student.age = [NSNumber numberWithInteger:30];
Student *student1 = [[Student alloc] init];
student1.name = @"Jack";
student1.age = [NSNumber numberWithInteger:41];
[user.studentsArray addObject:student];
[user.studentsArray addObject:student1];
[self.cascade cascadeInsert:[self.sessionM getSqlite3] obj:user completeHandler:^(PaintingliteSessionError * _Nonnull sessionError, Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
NSLog(@"%@",resArray);
}
}];
- Update
The function is the same as cascading insertion. Pass in the user object, including the collection of student tables, and pass in the modification conditions as an array. Paintinglite can automatically update multiple tables. (Different conditions of multiple tables corresponding to the condition array)
name ='CreaterOS' corresponds to the user table
name ='OS...' corresponds to the student table
[self.cascade cascadeUpdate:[self.sessionM getSqlite3] obj:user condatation:@[@"WHERE name ='CreaterOS'",@"WHERE name ='OS...'"] completeHandler:^(PaintingliteSessionError * _Nonnull sessionError , Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
NSLog(@"%@",resArray);
}
}];
- Delete
[self.cascade cascadeDelete:[self.sessionM getSqlite3] obj:user condatation:@[@"name ='WHY'",@"name ='YHD...'"] completeHandler:^(PaintingliteSessionError * _Nonnull sessionError, Boolean success, NSMutableArray * _Nonnull resArray) {
if (success) {
NSLog(@"%@",resArray);
}
}];
Log Mode (PaintingliteLog) Paintinglite provides developers with a logging function, which can record key operations on sqlite3 data during development, and is marked with a timestamp. Developers can easily read the log through the database name, or according to the required time node or the status of success and failure Selectively read the log. It facilitates the debugging after the software is online.
-(void)readLogFile:(NSString *__nonnull)fileName;
-(void)readLogFile:(NSString *)fileName dateTime:(NSDate *__nonnull)dateTime;
-(void)readLogFile:(NSString *)fileName logStatus:(PaintingliteLogStatus)logStatus;
-(void)removeLogFile:(NSString *)fileName;
Log module update To write log files in batches through the first-level cache, it is recommended that the developer instantiate the PaintingliteCache in AppDelegate, and manually call the log write method in applicationDidEnterBackground:(UIApplication )application and applicationWillTerminate:(UIApplication )application, then the cache can not be reached The log of the base point is written to the log file in time.
[self.cache pushCacheToLogFile];
Database backup (PaintingliteBackUpManager) Database migration is a problem that developers often care about. It has always been a headache for sqlite3 to port the client SQL Server MySQL and Orcale. Paintinglite is very friendly to provide developers with four database backup files, including from building a database to inserting data. Paintinglite writes backup files for developers. Developers only need to upload these sql files and run them to get and move the device. Exactly the same data.
PaintingliteBackUpSqlite3,
PaintingliteBackUpMySql,
PaintingliteBackUpSqlServer,
PaintingliteBackUpORCALE-(Boolean)backupDataBaseWithName:(sqlite3 *)ppDb sqliteName:(NSString *)sqliteName type:(PaintingliteBackUpManagerDBType)type completeHandler:(void(^ __nullable)(NSString *saveFilePath))completeHandler;
Split table (PaintingliteSplitTable) The time-consuming operation of table query with too large amount of data is huge. The Paintinglite test phase provides the operation of splitting the table, splitting the large table into multiple small tables, and the amount of splitting is determined by the developer.
Paintinglite provides split table operation for the first time, and the module is still being tested. Later version iterations will focus on optimizing this part of resource consumption and CPU usage.
/**
* tableName: database name
* basePoint: the number of splits
*/
-(Boolean)splitTable:(sqlite3 *)ppDb tabelName:(NSString *__nonnull)tableName basePoint:(NSUInteger)basePoint;
- Query operation
-(NSMutableArray *)selectWithSpliteFile:(sqlite3 *)ppDb tableName:(NSString *__nonnull)tableName basePoint:(NSUInteger)basePoint;
- Insert operation
-(Boolean)insertWithSpliteFile:(sqlite3 *)ppDb tableName:(NSString *)tableName basePoint:(NSUInteger)basePoint insertSQL:(NSString *)insertSQL;
- Update operation
-(Boolean)updateWithSpliteFile:(sqlite3 *)ppDb tableName:(NSString *)tableName basePoint:(NSUInteger)basePoint updateSQL:(NSString *)updateSQL;
- Delete operation
-(Boolean)deleteWithSpliteFile:(sqlite3 *)ppDb tableName:(NSString *)tableName basePoint:(NSUInteger)basePoint deleteSQL:(NSString *)deleteSQL;
Stress test (PaintinglitePressureOS) The PaintinglitePressureOS system is a stress testing system. It evaluates the reasonableness of database read and write consumption time, resource consumption and memory usage, and supports the generation of stress test reports. (No report is generated by default)
Paintinglite can perform different measurement and calculation of memory consumption status according to different devices, allowing developers to more clearly design a more reasonable database table structure on different iPhones.
-(Boolean)paintingliteSqlitePressure;
#### XML file configuration rules:
- The XML mapping file strictly abides by the DTD rules, which provides
,, , ,, , , and other basic tags; - The XML mapping file needs to be configured corresponding to the class created by the table (POJO mapping);
- The XML mapping file format has strict requirements (the v2.0 version has strict requirements);
namespace: Indicates the name of the table targeted by the current SQL statement operation object (the namespace content is not mandatory here, and it is recommended to be the same as the operation table name)(2)
select: Query label
SELECT * FROM eletest WHERE name =?
id: select the bound IDselect: omit query
resultType: result return type, currently supports NSDictionary&&NSMutableDictionary | NSArray && NSMutableArray
parameterType: Incoming type (variable parameters do not need to be configured, parameterType must be configured for all obj methods)
The query SQL statement can be written inside the select tag
?: Need to replace part of the adoption?
?
When you need to use select * from tableName to query, you can omit the SQL statement and replace the SQL statement that needs to be written with a?insert: insert tag
#import NS_ASSUME_NONNULL_BEGIN@interface Eletest: NSObject
@property (nonatomic,strong)NSNumber *age;
@property (nonatomic,copy)NSString *desc;
@property (nonatomic,copy)NSString *name;
@property (nonatomic,strong)NSNumber *tage;
@property (nonatomic,copy)NSString *teacher;
@endNS_ASSUME_NONNULL_END
INSERT INTO eletest(name,age,desc,tage,teacher) VALUES (#name,#age,#desc,#tage,#teacher);
?
id: insert tag binding ID
parameterType: Incoming parameter, which must be configured here, is the class name of the POJO object (note the case)
name,#age,#desc,#tage,#teacher: replace the inserted value with a combination of "#+class attribute name" insert supports the omission of insert statements, and only needs to set the corresponding attribute values ??for the objects that need to be passed in
useGeneratedKeys="true" keyProperty="ID": Return the inserted primary key value
SELECT LAST_INSERT_ID();
?
can also be configured to insert the return value
keyProperty="ID": Primary key value (corresponding property value)update tag
order="AFTER": Call timing, AFTER&&BEFORE can be configured
UPDATE eletest SET name = #name and tage = #tage WHERE teacher = #teacher and age = #age;
id: update tag binding IDdelete tag
parameterType: Incoming parameter, which must be configured here, is the class name of the POJO object (note the case)
name,#age,#tage,#teacher: replace the inserted value with a combination of "#+class attribute name" update supports omitting the insert statement, just set the corresponding attribute value for the object that needs to be passed in
DELETE FROM eletest WHERE name = #name and teacher = #teacher and tage = #tage;
?
id: delete tag binding IDAdvanced use of XML mapping file &&
parameterType: Incoming parameter, which must be configured here, is the class name of the POJO object (note the case)
name,#teacher,#tage: replace the inserted value with a combination of "#+class attribute name" delete supports omitting the insert statement, just set the corresponding attribute value for the object that needs to be passed in
id,name,age,teacher,tage,descSELECT Normally operating SQL statements will write select id, name, age, teacher, tag, desc From eletest fields for query, and multiple field names will be used in an XML mapping file. You can useto change the field name Package, in combination with
Note: Use theDynamic SQL operation tagstag to configure the refid to pass in the value must be the same as theconfiguration id
SELECT AND name = ? AND desc = ? AND teacher = ?
test: Judgment condition, currently only supports! = operation
Configure thetag to put all the fields that need to be judged at the end of the unified judgment writing. In order to ensure the correctness of the SQL statement, add 1 = 1 after the WHERE
Everystructure needs to be added with a larger AND AND desc = ?
SELECT name = ? desc = ? teacher = ? PaintingliteXMLSessionManager common methods
/**
* Create SessionManager
* xmlFileName: Each class corresponds to an XML file, and the name of the XML file is passed in
*/
+ (instancetype)buildSesssionManger:(NSString *__nonnull)xmlFileName;
/**
* Query one
* methodID: Select ID of XML binding
* condition: query condition
*/
-(NSDictionary *)selectOne:(NSString *__nonnull)methodID condition:(id)condition,... NS_REQUIRES_NIL_TERMINATION;
/* Query multiple */
-(NSArray *)select:(NSString *__nonnull)methodID condition:(id)condition,... NS_REQUIRES_NIL_TERMINATION;
-(NSArray *)select:(NSString *)methodID obj:(id)obj;
/**
* Insert
* methodID: INSERT ID bound to XML
* obj: the inserted object
*/
-(Boolean)insert:(NSString *)methodID obj:(id)obj;
/**
* Insert return primary key ID
* methodID: INSERT ID bound to XML
* obj: the inserted object
*/
-(sqlite3_int64)insertReturnPrimaryKeyID:(NSString *)methodID obj:(id)obj;
/**
* Update
* methodID: INSERT ID bound to XML
* obj: the inserted object
*/
-(Boolean)update:(NSString *)methodID obj:(id)obj;
/**
* Delete
* methodID: INSERT ID bound to XML
* obj: the inserted object
*/
-(Boolean)del:(NSString *)methodID obj:(id)obj;
Instance call
PaintingliteXMLSessionManager *xmlSessionM = [PaintingliteXMLSessionManager buildSesssionManger:[[NSBundle mainBundle] pathForResource:@"user" ofType:@"xml"]];
[xmlSessionM openSqlite:@"sqlite"];
//Inquire
NSLog(@"%@",[xmlSessionM selectOne:@"eletest.getEleById" condition:[NSNumber numberWithInt:1],[NSNumber numberWithInt:21],nil]);
NSLog(@"%@",[xmlSessionM select:@"eletest.getEleById" condition:[NSNumber numberWithInt:1],[NSNumber numberWithInt:21], nil]);
Eletest *eletest = [[Eletest alloc] init];
eletest.name = @"CreaterOS";
eletest.age = [NSNumber numberWithInteger:21];
eletest.desc = @"CreaterOS";
eletest.teacher = @"CreaterOS";
eletest.tage = [NSNumber numberWithInteger:21];
NSLog(@"%zd",[[xmlSessionM select:@"eletest.getEleByObj" obj:eletest] count]);
NSLog(@"%zd",[[xmlSessionM select:@"eletest.getEleByObjWhere" obj:eletest] count]);
//insert
[xmlSessionM insert:@"eletest.getInsertEletest" obj:eletest];
NSLog(@"%lu",(unsigned long)[xmlSessionM insertReturnPrimaryKeyID:@"eletest.getInsertUserReturnPrimaryKey" obj:eletest]);
//delete
[xmlSessionM del:@"eletest.getDeleteUser" obj:eletest];
[xmlSessionM del:@"eletest.getDeleteEleAuto" obj:eletest];
//Update
[xmlSessionM update:@"eletest.getUpdateEle" obj:eletest];
Constraint In order to achieve better operation and comply with database specifications, table names are all lowercase.
Contribute to this project
If you have a feature request or bug report, please feel free to send 863713745@qq.com to upload the problem, and we will provide you with revisions and help as soon as possible. Thank you very much for your support.
Security Disclosure
【Paintinglite|Paintinglite -- Sqlite3 SDK Specially Designed For iOS】If you have found the Paintinglite security vulnerabilities and vulnerabilities that need to be modified, you should email them to 863713745@qq.com as soon as possible. thank you for your support.
推荐阅读
- Android|Android sqlite3数据库入门系列
- vue项目+wxjssdk，config配置解决iPhone端签名错误的问题
- 开放人脸SDK的相关资源
- sqlite|python中用SQLite3添加 主键约束 唯一约束 非空约束 外键约束（约束的介绍以及设置）
- python|python中使用SQLite3对数据库的基本操作（基于ubuntu操作系统）
- 如何优雅引入神策Web JS SDK
- 失去了SDK，云计算将会怎样?
- Android|解决AS中启动AVD报错Emulator: PANIC: Cannot find AVD system path. Please define ANDROID_SDK_ROOT
- flutter|从集成百度语音SDK说起---flutter与native数据通信初试
- Duplicate class com.alipay.a.a.a found in modules classes.jar (:alipaySdk-15.6.2-20190416165036:) an