添加 struct 类型支持
bang edited this page Mar 29, 2017
·
3 revisions
JSPatch 默认支持的 struct 类型只有 CGRect / CGPoint / CGSize / NSRange，若要让 JS 脚本支持其他 struct 类型，需要先手动注册。例如要支持 CGAffineTransform，需要在使用前在 JS 使用 defineStruct() 接口定义：
require('JPEngine').defineStruct({
"name": "CGAffineTransform",
"types": "FFFFFF",
"keys": ["a", "b", "c", "d", "tx", "ty"]
})JPEngine 的 +defineStruct: 接口，可以让 JS 支持新的 struct 类型：
@interface JPEngine : NSObject
/*
@param defineDict = @{
@"name": @"", //struct 名
@"types": @"", //struct 各字段类型
@"keys": @[@"", ...] //struct 各字段名
}
*/
+ (void)defineStruct:(NSDictionary *)defineDict;
...
@endtypes 字段表示 struct 各字段的类型，每种类型都由一个字母代替，字母含义如下：
'c': char
'C': unsigned char
's': short
'S': unsigned short
'i': int
'I': unsigned int
'l': long
'L': unsigned long
'q': long long
'Q': unsigned long long
'f': float
'F': CGFloat
'N': NSInteger
'U': NSUInteger
'd': double
'B': BOOL
这里 struct 有多少个字段，types 就有多少个字母，types 的字母顺序必须按 struct 定义的顺序写，举例：
struct JPDemoStruct {
CGFloat a;
long b;
double c;
BOOL d;
}JPDemoStruct 对应的 type 就是 @"FldB"。
keys 数组表示 struct 各个字段在 JS 中使用的名字，其顺序必须与 struct 字段顺序一致，拿上述 JPDemoStruct 举例，它对应的 keys 数组应该是：@[@"a", @"b", @"c", @"d"].
OC 里有 JPDemoStruct 这个 struct 类型：
struct JPDemoStruct {
CGFloat a;
long b;
double c;
BOOL d;
}想在 JS 上使用，需要事先调用定义：
[JPEngine defineStruct:@{
@"name": @"JPDemoStruct",
@"types": @"FldB",
@"keys": @[@"a", @"b", @"c", @"d"]
}]接着就可以在 JS 里使用了：
//OC
@implementation JPObject
+ (void)passStruct:(JPDemoStruct)s;
+ (JPDemoStruct)returnStruct;
@end//JS
require('JPObject').passStruct({a:1, b:2, c:4.2, d:1})
var s = require('JPObject').returnStruct();我们也可以在 JS 里动态定义 struct 类型：
require('JPEngine').defineStruct({
"name": "JPDemoStruct",
"types": "FldB",
"keys": ["a", "b", "c", "d"]
})