JSPatch常见问题解答

##一、block使用规则 1、在 JSPatch 若要向 Objective-C 传递 block，需要使用 block(paramTypes, function) 函数封装：Block的详细使用方法，封装后的值已经不是 JS 函数，不能直接在 JS 上调用：

var blk = block("BOOL", function(b){
})
blk(1) //crash

若想在 JS 上调用，请调用封装前的函数：

var func = function(b){
};
var blk = block("BOOL", func)
func(1) //it's OK

2、不允许在 JS 的 block 中传入含有 undefined 的数组或对象。比如传入 ["JSPatch", undefined] 的数组或 {obj: undefined} 的对象，这种语法在 JavaScript 中没有错误，但是在 Objective-C 中是不允许的。

3、如果 block 的参数里含有 block，paramTypes 需要写成 NSBlock *。

var blk = block("BOOL, NSBlock *", function(b, blk){
  if (b) {
    blk(true)
  }
})

4、在 Objective-C 中传入到 JSPatch 中的 Block 会转换为 function，如果需要再将该 Block 传回到 OC，依旧需要用 block(paramTypes, function) 封装。

//Objective-C代码
- (void)excuteBlock:(JSBlock)block {
    if (block) {
        block(@"Hello, JSPatch");
    }
}
- (JSBlock)returnBlock {
    JSBlock block = ^(NSString *str) {
        NSLog(@"%@", str);
    };
    return block;
}

//JSPatch脚本
var blk = self.returnBlock()
self.excuteBlock(block("NSString *", blk))

5、暂时不支持向OC端传递含有浮点型参数的block，比如如下的情况:

//Objective-C代码
typedef void (^JSBlock)(CGFloat fl);

- (void)doBlock:(JSBlock)blk {
    if (blk) {
        blk(123.456f);
    }
}

//JSPatch脚本
self.doBlock(block("CGFloat",function(fl){
        console.log(fl)  //得到的结果不会是你想要的结果
     }
))

6、在block中使用到self时，需要在使用block之前先将self赋值给另外一个变量，然后在block中使用这个变量。如：

//JSPatch脚本
var slf = self
self.requestWithCompletion(block("BOOL, NSError*", function(success, error){
    slf.label().setText("complete")
})
)

##二、在 JSPatch 中表示 nil 和 [NSNull null] 及使用其他特殊类型 1、在 JSPatch 中使用 null 或 undefined 来表示 Objective-C 的 nil， 使用 nsnull 表示 [NSNull null]。

2、在 JSPatch 中判断 Objective-C对象是否为空时，使用 if(!obj){} 的形式而不能使用 if(obj == null){} 或 if(obj == undefined){}

3、在 JSPatch 中使用 struct、selector 的用法可参考这里

##三、调用包含id *类型参数的方法 详见 基础用法 - 传递 id* 参数

##四、在 JSPatch 使用父类方法 使用 self.super() 调用父类方法

defineClass("JPTableViewController", {
  viewDidLoad: function() {
     self.super().viewDidLoad();
  }
})

##五、调用多参数的方法 JSPatch 中使用 _ 来替代Objective-C中的 :, 多以调用多参数的 Objective-C 方法需要像下面这样。

var error = require('NSError').errorWithDomain_code_userInfo("UnKnown_Error", -1, null)

如果调用的方法含有一个下划线，就需要使用双下划线来表示。例如:

- (void)p_privateMethod;

JSPatch中可以这样调用

self.p__privateMethod()

不支持方法中含有双（或更多）下划线的方法，如 - (void)p__privateMethod;。 但是如果是要获取含有双（或更多）下划线的property(这种情况比带有双下划线的方法更为常见一些)，可以使用 KVC 的 valueForKey 方法。例如:

@property (nonatomic, string) id __privateObject;

JSPatch中可以这样获取

var obj = self.valueForKey("__privateObject")

##六、JSPatch 中的 NSArray，NSString，NSDictionary 在 JSPatch 中不能将 Objective-C 中的 NSArray, NSString, NSDictionary 与 JavaScript 的 Array, String, Object 进行混用。

//Objective-C
- (NSArray *)returnNSArray {
    return @[@"Objective-C", @"Swift"];
}

var nsarray = self.returnNSArray()
var array = ["Objective-C", "Swift"]
//这两者不能混用，因为他们是不同的类型。

var wrongStr = nsarray[0] //得到的是一个不正确的对象，请不要使用取下标的方式获取NSArray/NSDictionar对象。

var rightStr = nsarray.toJS()[0] //先unbox返回的对象，然后取出其中的数据
或
var rightStr = nsarray.objectAtIndex(0) //使用Objective-C方法获取NSArray/NSDictionary中的对象

具体可参考基础用法文档

##七、常量与宏 Objective-C 里的常量不能直接在 JS 上使用，可以直接在 JS 上用具体值代替，或者在 JS 上重新定义同名的全局变量：

//js
var UIRectEdgeNone   = 0,
    UIRectEdgeTop    = 1 << 0,
    UIRectEdgeLeft   = 1 << 1,
    UIRectEdgeBottom = 1 << 2,
    UIRectEdgeRight  = 1 << 3

Objective-C 里的宏同样不能直接在 JS 上使用，若定义的宏是一个值，可以在 JS 定义同样的全局变量代替，若定义的宏是程序，或者在底层才能获取到的值，例如 CGFLOAT_MIN，可以通过添加扩展的方式提供支持：

@implementation JPMacroSupport
+ (void)main:(JSContext *)context
{
  context[@"CGFLOAT_MIN"] = ^CGFloat() {
    return CGFLOAT_MIN;
  }
}
@end

require('JPEngine').addExtensions(['JPMacroSupport'])
var floatMin = CGFLOAT_MIN();

##八、Property / 私有变量的获取和赋值

详见 defineClass使用文档

##九、类全局变量

目前在类里定义的 static 全局变量无法在 JS 上获取到，若要在 JS 拿到这个变量，需要在 OC 有类方法或实例方法它返回：

static NSString *name;
@implementation JPTestObject
+ (NSString *)name {
  return name;
}
@end

var name = JPTestObject.name() //拿到全局变量值

##十、Swift 使用 defineClass() 覆盖 Swift 类时，类名应为 项目名.原类名，例如项目 demo 里用 Swift 定义了 ViewController 类，在 JS 覆盖这个类方法时要这样写：

defineClass('demo.ViewController', {})

##十一、可变参数

JSPatch 不支持带可变参数方法的调用，例如：

//OC: [NSString stringWithFormat:@"%d %@", i, obj];
NSString.stringWithFormat("%d %@", i, obj);  //not working

因为 JSPatch 原理是通过 NSInvocation 动态调用方法，而 NSInvocation 不支持可变参数，参见官方文档。

##十二、其他问题

不可以使用 require('NSNumber').alloc()，原因见这里