forked from bang590/JSPatch
-
Notifications
You must be signed in to change notification settings - Fork 0
添加 struct 类型支持
bang edited this page Sep 18, 2015
·
2 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"]
})
##API
JPEngine
的 +defineStruct:
接口,可以让 JS 支持新的 struct 类型:
@interface JPEngine : NSObject
/*
@param defineDict = @{
@"name": @"", //struct 名
@"types": @"", //struct 各字段类型
@"keys": @[@"", ...] //struct 各字段名
}
*/
+ (void)defineStruct:(NSDictionary *)defineDict;
...
@end
###types
types 字段表示 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
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"]
})