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
實例,使用系統(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
實例都將與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ù)的實現(xiàn)。
每一個JSValue
實例都是來自于JSContext
,JSValue
則包含了對context
對象的強(qiáng)應(yīng)用,這點(diǎn)需要特別注意,如果不注意可能會造成內(nèi)存泄露。當(dāng)我們通過JSValue
調(diào)用方法時,返回的新JSValue
跟之前的JSValue
是屬于同一個context
的。
-
JSManagedValue
Objective-C 或者 Swift 的對象都是使用引用計數(shù)
,而 Javascript 則是使用垃圾回收機(jī)制
。為了避免兩種語言交互時產(chǎn)生的循環(huán)引用,需要使用 JSManagedValue
進(jìn)行內(nèi)存輔助管理。
-
JSExport
這是一個協(xié)議而不是對象。正如名字含義一樣,我們可以使用這個協(xié)議暴露原生對象,實例方法,類方法,和屬性給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
里面,其實就是轉(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
//建一個對象去實現(xiàn)這個協(xié)議:
@interface JSProtocolObj : NSObject<JSExportTest>
@end
@implementation JSProtocolObj
@synthesize sum = _sum;
//實現(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);
};