在Swift中使用JavaScript的方法和技巧
在RedMonk发布的2015年1月编程语言排行榜中,Swift采纳率排名迅速飙升,从刚刚面世时的68位跃至22位,Objective-C仍然稳居TOP 10,而JavaScript则凭借着其在iOS平台上原生体验优势成为了年度最火热的编程语言。
而早在2013年苹果发布的OS X Mavericks和iOS 7两大系统中便均已加入了JavaScriptCore框架,能够让开发者轻松、快捷、安全地使用JavaScript语言编写应用。不论叫好叫骂,JavaScript霸主地位已成事实。开发者们趋之若鹜,JS工具资源层出不穷,用于OS
X和iOS系统等高速虚拟机也蓬勃发展起来。
jscontext/JSValue
jscontext即JavaScript代码的运行环境。一个Context就是一个JavaScript代码执行的环境,也叫作用域。当在浏览器中运行JavaScript代码时,jscontext就相当于一个窗口,能轻松执行创建变量、运算乃至定义函数等的JavaScript代码:
- //Objective-C
- jscontext *context = [[jscontext alloc] init];
- [context evaluateScript:@"var num = 5 + 5"];
- [context evaluateScript:@"var names = ['Grace','Ada','Margaret']"];
- [context evaluateScript:@"var triple = function(value) { return value * 3 }"];
- JSValue *tripleNum = [context evaluateScript:@"triple(num)"];
复制代码
- //Swift
- let context = jscontext()
- context.evaluateScript("var num = 5 + 5")
- context.evaluateScript("var names = ['Grace','Margaret']")
- context.evaluateScript("var triple = function(value) { return value * 3 }")
- let tripleNum: JSValue = context.evaluateScript("triple(num)")
像JavaScript这类动态语言需要一个动态类型(Dynamic Type), 所以正如代码最后一行所示,jscontext里不同的值均封装在JSValue对象中,包括字符串、数值、数组、函数等,甚至还有Error以及null和undefined。
JSValue包含了一系列用于获取Underlying Value的方法,如下表所示:
JavaScript Type
|
JSValue method
|
Objective-C Type
|
Swift Type
|
string
|
toString
|
|
String!
|
boolean
|
toBool
|
BOOL
|
Bool
|
number
|
toUInt32
|
NSNumberdoubleint32_t
uint32_t
|
NSNumber!DoubleInt32
UInt32
|
Date
|
toDate
|
NSDate
|
NSDate!
|
Array
|
toArray
|
NSArray
|
[AnyObject]!
|
Object
|
toDictionary
|
NSDictionary
|
[NSObject : AnyObject]!
|
toObjecttoObjectOfClass:
|
custom type
|
custom type
|
想要检索上述示例中的tripleNum值,只需使用相应的方法即可:
- NSLog(@"Tripled: %d",[tripleNum toInt32]);
- // Tripled: 30
复制代码
- println("Tripled: \(tripleNum.toInt32())")
- 下标值(Subscripting Values)
通过在jscontext和JSValue实例中使用下标符号可以轻松获取上下文环境中已存在的值。其中,jscontext放入对象和数组的只能是字符串下标,而JSValue则可以是字符串或整数下标。
- JSValue *names = context[@"names"];
- JSValue *initialName = names[0];
- NSLog(@"The first name: %@",[initialName toString]);
- // The first name: Grace
- let names = context.objectForKeyedSubscript("names")
- let initialName = names.objectAtIndexedSubscript(0)
- println("The first name: \(initialName.toString())")
- 而Swift语言毕竟才诞生不久,所以并不能像Objective-C那样自如地运用下标符号,目前,Swift的方法仅能实现objectAtKeyedSubscript()和objectAtIndexedSubscript()等下标。
函数调用(Calling Functions)
我们可以将Foundation类作为参数,从Objective-C/Swift代码上直接调用封装在JSValue的JavaScript函数。这里,JavaScriptCore再次发挥了衔接作用。
- JSValue *tripleFunction = context[@"triple"];
- JSValue *result = [tripleFunction callWithArguments:@[@5] ];
- NSLog(@"Five tripled: %d",[result toInt32]);
- let tripleFunction = context.objectForKeyedSubscript("triple")
- let result = tripleFunction.callWithArguments([5])
- println("Five tripled: \(result.toInt32())")
异常处理(Exception Handling)
jscontext还有一个独门绝技,就是通过设定上下文环境中exceptionHandler的属性,可以检查和记录语法、类型以及出现的运行时错误。exceptionHandler是一个回调处理程序,主要接收jscontext的reference,进行异常情况处理。
- context.exceptionHandler = ^(jscontext *context,JSValue *exception) {
- NSLog(@"JS Error: %@",exception);
- };
- [context evaluateScript:@"function multiply(value1,value2) { return value1 * value2 "];
- // JS Error: SyntaxError: Unexpected end of script
- context.exceptionHandler = { context,exception in
- println("JS Error: \(exception)")
- }
- context.evaluateScript("function multiply(value1,value2) { return value1 * value2 ")
- JavaScript函数调用
了解了从JavaScript环境中获取不同值以及调用函数的方法,那么反过来,如何在JavaScript环境中获取Objective-C或者Swift定义的自定义对象和方法呢?要从jscontext中获取本地客户端代码,主要有两种途径,分别为Blocks和J**port协议。
Blocks (块)
在jscontext中,如果Objective-C代码块赋值为一个标识符,JavaScriptCore就会自动将其封装在JavaScript函数中,因而在JavaScript上使用Foundation和Cocoa类就更方便些——这再次验证了JavaScriptCore强大的衔接作用。现在CFStringTransform也能在JavaScript上使用了,如下所示:
- context[@"simplifyString"] = ^(Nsstring *input) {
- NSMutableString *mutableString = [input mutablecopy];
- CFStringTransform((__bridge CFMutableStringRef)mutableString,NULL,kcfStringTransformToLatin,NO);
- return mutableString;
- NSLog(@"%@",[context evaluateScript:@"simplifyString('안녕하새요!')"]);
- let simplifyString: @objc_block String -> String = { input in
- var mutableString = NSMutableString(string: input) as CFMutableStringRef
- CFStringTransform(mutableString,nil,Boolean(0))
- return mutableString
- println(context.evaluateScript("simplifyString('안녕하새요!')"))
- // annyeonghaSAEyo!
需要注意的是,Swift的speedbump只适用于Objective-C block,对Swift闭包无用。要在一个jscontext里使用闭包,有两个步骤:一是用@objc_block来声明,二是将Swift的knuckle-whitening unsafeBitCast()函数转换为 AnyObject。
内存管理(Memory Management)
代码块可以捕获变量引用,而jscontext所有变量的强引用都保留在jscontext中,所以要注意避免循环强引用问题。另外,也不要在代码块中捕获jscontext或任何JSValues,建议使用[jscontext currentContext]来获取当前的Context对象,根据具体需求将值当做参数传入block中。
J**port协议
借助J**port协议也可以在JavaScript上使用自定义对象。在J**port协议中声明的实例方法、类方法,不论属性,都能自动与JavaScrip交互。文章稍后将介绍具体的实践过程。
JavaScriptCore实践
我们可以通过一些例子更好地了解上述技巧的使用方法。先定义一个遵循J**port子协议PersonJ**port的Person model,再用JavaScript在JSON中创建和填入实例。有整个JVM,还要NSJSONSerialization干什么?
PersonJ**ports和Person
Person类执行的PersonJ**ports协议具体规定了可用的JavaScript属性。,在创建时,类方法必不可少,因为JavaScriptCore并不适用于初始化转换,我们不能像对待原生的JavaScript类型那样使用var person = new Person()。
- // in Person.h -----------------
- @class Person;
- @protocol PersonJ**ports <J**port>
- @property (nonatomic,copy) Nsstring *firstName;
- copy) Nsstring *lastName;
- @property NSInteger agetoday;
- - (Nsstring *)getFullName;
- // create and return a new Person instance with `firstName` and `lastName`
- + (instancetype)createWithFirstName:(Nsstring *)firstName lastName:(Nsstring *)lastName;
- @end
- @interface Person : NSObject <PersonJ**ports>
- // in Person.m -----------------
- @implementation Person
- - (Nsstring *)getFullName {
- + (instancetype) createWithFirstName:(Nsstring *)firstName lastName:(Nsstring *)lastName {
- Person *person = [[Person alloc] init];
- person.firstName = firstName;
- return person;
- @end
- // Custom protocol must be declared with `@objc`
- @objc protocol PersonJ**ports : J**port {
- var firstName: String { get set }
- var lastName: String { get set }
- var birthYear: NSNumber? { get set }
- func getFullName() -> String
- /// create and return a new Person instance with `firstName` and `lastName`
- class func createWithFirstName(firstName: String,lastName: String) -> Person
- // Custom class must inherit from `NSObject`
- @objc class Person : NSObject,PersonJ**ports {
- // properties must be declared as `dynamic`
- dynamic var firstName: String
- dynamic var lastName: String
- dynamic var birthYear: NSNumber?
- init(firstName: String,lastName: String) {
- self.firstName = firstName
- }
-
- return Person(firstName: firstName,lastName: lastName)
- func getFullName() -> String {
- return "\(firstName) \(lastName)"
- }
配置jscontext
- // export Person class
- context[@"Person"] = [Person class];
- // load Mustache.js
- Nsstring *mustacheJsstring = [Nsstring stringWithContentsOfFile:... encoding:NSUTF8StringEncoding error:nil];
- [context evaluateScript:mustacheJsstring];
- if let mustacheJsstring = String(contentsOfFile:...,encoding:NSUTF8StringEncoding,error:nil) {
- context.evaluateScript(mustacheJsstring)
- JavaScript数据&处理
以下简单列出一个JSON范例,以及用JSON来创建新Person实例。
注意:JavaScriptCore实现了Objective-C/Swift的方法名和JavaScript代码交互。因为JavaScript没有命名好的参数,任何额外的参数名称都采取驼峰命名法(Camel-Case),并附加到函数名称上。在此示例中,Objective-C的方法createWithFirstName:lastName:在JavaScript中则变成了createWithFirstNameLastName()。
- //JSON
- [
- { "first": "Grace","last": "Hopper","year": 1906 },
- { "first": "Ada","last": "lovelace","year": 1815 },serif; font-size:12px; line-height:1.8em"> { "first": "Margaret","last": "Hamilton","year": 1936 }
- ]
- //JavaScript
- var loadPeopleFromJSON = function(jsonString) {
- var data = JSON.parse(jsonString);
- var people = [];
- for (i = 0; i < data.length; i++) {
- person.birthYear = data[i].year;
- people.push(person);
- return people;
- 动手一试
现在你只需加载JSON数据,并在jscontext中调用,将其解析到Person对象数组中,再用Mustache模板渲染即可:
- // get JSON string
- Nsstring *peopleJSON = [Nsstring stringWithContentsOfFile:... encoding:NSUTF8StringEncoding error:nil];
- // get load function
- JSValue *load = context[@"loadPeopleFromJSON"];
- // call with JSON and convert to an NSArray
- JSValue *loadResult = [load callWithArguments:@[peopleJSON]];
- NSArray *people = [loadResult toArray];
- // get rendering function and create template
- JSValue *mustacheRender = context[@"Mustache"][@"render"];
- Nsstring *template = @"{{getFullName}},born {{birthYear}}";
- // loop through people and render Person object as string
- for (Person *person in people) {
- NSLog(@"%@",[mustacheRender callWithArguments:@[template,person]]);
- // Output:
- // Grace Hopper,born 1906
- // Ada lovelace,born 1815
- // Margaret Hamilton,born 1936
- if let peopleJSON = Nsstring(contentsOfFile:...,encoding: NSUTF8StringEncoding,error: nil) {
- // get load function
- let load = context.objectForKeyedSubscript("loadPeopleFromJSON")
- // call with JSON and convert to an array of `Person`
- if let people = load.callWithArguments([peopleJSON]).toArray() as? [Person] {
- // get rendering function and create template
- let mustacheRender = context.objectForKeyedSubscript("Mustache").objectForKeyedSubscript("render")
- let template = "{{getFullName}},born {{birthYear}}"
- // loop through people and render Person object as string
- for person in people {
- println(mustacheRender.callWithArguments([template,person]))
相关文章
软件简介:蓝湖辅助工具,减少移动端开发中控件属性的复制和粘...
现实生活中,我们听到的声音都是时间连续的,我们称为这种信...
前言最近在B站上看到一个漂亮的仙女姐姐跳舞视频,循环看了亿...
【Android App】实战项目之仿抖音的短视频分享App(附源码和...
前言这一篇博客应该是我花时间最多的一次了,从2022年1月底至...
因为我既对接过session、cookie,也对接过JWT,今年因为工作...