iOS 7中加入了JavaScriptCore框架,該框架讓Objective-C和JavaScript代碼直接交互變得更加簡單方便。
JavaScriptCore 總覽
在學(xué)習(xí) JavaScriptCore 的使用之前,需要先了解JavaScriptCore 當(dāng)中的重要類型以及協(xié)議,包括JSValue 、 JSContext 、 JSVirtualMachine 、 JSManagedValue 以及 JSExport 。
先對這5個類簡單介紹
-
JSVirtualMachine
Javascript 代碼是在虛擬機(jī)當(dāng)中運(yùn)行的,每一個虛擬機(jī)由一個JSVirtualMachine來表示。一般情況下我們不用去手動創(chuàng)建 JSVirtualMachine 實(shí)例,使用系統(tǒng)提供的就足夠了。需要手動創(chuàng)建 JSVirtualMachine的一個主要場景就是當(dāng)我們需要并發(fā)地運(yùn)行Javascript 代碼時,在單一的JSVirtualMachine里面是沒辦法 同時 運(yùn)行多個線程的。
-
JSContext
代表JavaScript的運(yùn)行環(huán)境,是一個全局對象,可以理解為Web開發(fā)中的 window 對象。所有的 JSValue都與 JSContext 相關(guān)聯(lián)。
JSContext也用于管理JavaScript虛擬機(jī)中對象的生命周期,每一個JSValue實(shí)例都將與JSContext通過強(qiáng)引用相關(guān)聯(lián)。只要JSValue存在,JSContext就會保持引用,當(dāng)JSContext中所有的JSValue被釋放掉,那么JSContext也將會被釋放,除非之前有被retained。
-
JSValue
JSValue可以說是JavaScript和Object-C或Swift之間數(shù)據(jù)互換的橋梁。為了在原生代碼(native code)和JavaScript代碼之間傳遞數(shù)據(jù),JSContext里的不同的Javascript值都可以封裝在JSValue的對象里,包括字符串、數(shù)值、數(shù)組、函數(shù)等,甚至還有Error以及null和undefined;同時這個類型的對象可以方便快速地轉(zhuǎn)化為OC里常用的數(shù)據(jù)類型,如toBool()、toInt32()、toArray()、toDictionary()等。我們也可以使用JSValue創(chuàng)建JavaScript對象來包裝原生自定義類中的對象,或者通過原生的方法或block來提供JavaScript函數(shù)的實(shí)現(xiàn)。
每一個JSValue實(shí)例都是來自于JSContext,JSValue則包含了對context對象的強(qiáng)應(yīng)用,這點(diǎn)需要特別注意,如果不注意可能會造成內(nèi)存泄露。當(dāng)我們通過JSValue調(diào)用方法時,返回的新JSValue跟之前的JSValue是屬于同一個context的。
-
JSManagedValue
Objective-C 或者 Swift 的對象都是使用引用計(jì)數(shù),而 Javascript 則是使用垃圾回收機(jī)制。為了避免兩種語言交互時產(chǎn)生的循環(huán)引用,需要使用 JSManagedValue進(jìn)行內(nèi)存輔助管理。
-
JSExport
這是一個協(xié)議而不是對象。正如名字含義一樣,我們可以使用這個協(xié)議暴露原生對象,實(shí)例方法,類方法,和屬性給JavaScript,這樣JavaScript就可以調(diào)用相關(guān)暴露的方法和屬性。遵守JSExport協(xié)議,就可以定義我們自己的協(xié)議,在協(xié)議中聲明的API都會在JS中暴露出來。
OC調(diào)用 Javascript
使用需要導(dǎo)入框架#import <JavaScriptCore/JavaScriptCore.h>
示例1:
JSContext *context = [[JSContext alloc]init];
NSString *jsStr = @"function add(a,b) {return a+b}";
[context evaluateScript:jsStr];
JSValue *function = context[@"add"];
JSValue *value = [function callWithArguments:@[@(2), @(3)]];
NSLog(@"%@", [value toNumber]);
創(chuàng)建一個JSContext對象,然后將JS代碼加載到context里面,最后取到這個函數(shù)對象,調(diào)用callWithArguments這個方法進(jìn)行參數(shù)傳值.
示例2:
NSString*JSStr=[[NSString alloc] initWithContentsOfFile: [[NSBundle mainBundle] pathForResource:@"TestJS.js" ofType:nil] encoding:NSUTF8StringEncoding error:nil];
[context evaluateScript:JSStr];
JSValue *jsFunction = context[@"factorial"];
JSValue *resultValue = [jsFunction callWithArguments:@[@10]];
NSLog(@"-- %@", [resultValue toNumber]);
// JacaScript環(huán)境中異常檢測,一旦出現(xiàn)錯誤,閉包將會被執(zhí)行
[context setExceptionHandler:^(JSContext *context, JSValue *exception) {
[JSContext currentContext].exception = exception;
NSLog(@"exception:%@",exception);
}];
其中TestJS.js:
function factorial(n){
if(n < 0)
return
if(n === 0)
return 1
return n * factorial(n - 1)
}
運(yùn)行結(jié)果:3628800
Javascript調(diào)用OC
JS調(diào)用OC有兩個方法:block和JSExport protocol。
block
//創(chuàng)建block
NSInteger(^AddBlock)(NSInteger, NSInteger) addBlock = ^(NSInteger a, NSInteger b){
return a+b;
};
JSContext *context = [[JSContext alloc]init];
context[@"add"] = addBlock;
JSValue *value = [context evaluateScript:@"add(11, 21)"];
NSLog(@"%@", [value toNumber]);
我們定義一個block,然后保存到context里面,其實(shí)就是轉(zhuǎn)換成了JS的function。然后我們直接執(zhí)行這個function,調(diào)用的就是我們的block里面的內(nèi)容了。
JSExport protocol:
//定義一個JSExport protocol,哪些屬性或方法需要給JS使用,就要在這個協(xié)議中暴露哪些
@protocol JSExportTest <JSExport>
- (NSInteger)add:(NSInteger)num1 num2:(NSInteger)num2 num3:(NSInteger)num3;
@property (nonatomic, assign) NSInteger sum;
@end
//建一個對象去實(shí)現(xiàn)這個協(xié)議:
@interface JSProtocolObj : NSObject<JSExportTest>
@end
@implementation JSProtocolObj
@synthesize sum = _sum;
//實(shí)現(xiàn)協(xié)議方法
- (NSInteger)add:(NSInteger)num1 num2:(NSInteger)num2 num3:(NSInteger)num3{
return num1 + num2 + num3;
}
//重寫setter方法方便打印信息,
- (void)setSum:(NSInteger)sum{
NSLog(@"--%@", @(sum));
_sum = sum;
}
@end
然后在控制器:
JSProtocolObj *obj = [[JSProtocolObj alloc] init];
JSContext *context = [[JSContext alloc] init];
//設(shè)置異常處理
context.exceptionHandler = ^(JSContext *context, JSValue *exception) {
[JSContext currentContext].exception = exception;
NSLog(@"exception:%@",exception);
};
context[@"OCObj"] = obj;
[context evaluateScript:@"OCObj.sum = OCObj.addNum2Num3(2,3, 4)"];
注意:
當(dāng)公開一個selector并擁有一個或者多個參數(shù),JavaScriptCore將采用下列轉(zhuǎn)換生成對應(yīng)的函數(shù)名:
- All colons are removed from the selector. selector中所有的冒號都將被去除
- Any lowercase letter that had followed a colon is capitalized.所有冒號之后的小寫字母都將變?yōu)榇髮懽帜?/li>
為了重命名selector暴露給JavaScript,,我們可以使用JSExportAs宏,如下:
@protocol JSExportTest <JSExport>
//用宏轉(zhuǎn)換下,將JS函數(shù)名字指定為add;
JSExportAs(add,
- (NSInteger)add:(NSInteger)num1 num2:(NSInteger)num2 num3:(NSInteger)num3
);
@property (nonatomic, assign) NSInteger sum;
@end
使用時:
[context evaluateScript:@"OCObj.sum = OCObj.add(2,3, 4)"];
最后:
現(xiàn)在來說說內(nèi)存管理的注意點(diǎn),OC使用的ARC,JS使用的是垃圾回收機(jī)制,并且所有的引用是都強(qiáng)引用,不過JS的循環(huán)引用,垃圾回收會幫它們打破。JavaScriptCore里面提供的API,正常情況下,OC和JS對象之間內(nèi)存管理都無需我們?nèi)リP(guān)心。不過還是有幾個注意點(diǎn)需要我們?nèi)チ粢庀?br>
不要在block里面直接使用context,或者使用外部的JSValue對象。
//錯誤代碼:
self.context[@"block"] = ^(){
JSValue *value = [JSValue valueWithObject:@"aaa" inContext:self.context];
};
這個代碼,不用自己看了,編譯器都會提示你的。這個block里面使用self,很容易就看出來了。
//一個比較隱蔽的
JSValue *value = [JSValue valueWithObject:@"ssss" inContext:self.context];
self.context[@"log"] = ^(){
NSLog(@"%@",value);
};
這個是block里面使用了外部的value``,value對context和它管理的JS對象都是強(qiáng)引用。這個value被block所捕獲,這邊同樣也會內(nèi)存泄露,context是銷毀不掉的。
//正確的做法,str對象是JS那邊傳遞過來。
self.context[@"log"] = ^(NSString *str){
NSLog(@"%@",str);
};