javascript
JSPatch 基础用法
1. require
在使用Objective-C類之前需要調(diào)用?require('className’)?:
require('UIView') var view = UIView.alloc().init()可以用逗號?,?分隔,一次性導(dǎo)入多個類:
require('UIView, UIColor') var view = UIView.alloc().init() var red = UIColor.redColor()或者直接在使用時才調(diào)用?require()?:
require('UIView').alloc().init()2. 調(diào)用OC方法
調(diào)用類方法
var redColor = UIColor.redColor();調(diào)用實例方法
var view = UIView.alloc().init(); view.setNeedsLayout();參數(shù)傳遞
跟在OC一樣傳遞參數(shù):
var view = UIView.alloc().init(); var superView = UIView.alloc().init() superView.addSubview(view)Property
獲取/修改 Property 等于調(diào)用這個 Property 的 getter / setter 方法,獲取時記得加?():
view.setBackgroundColor(redColor); var bgColor = view.backgroundColor();方法名轉(zhuǎn)換
多參數(shù)方法名使用?_?分隔:
var indexPath = require('NSIndexPath').indexPathForRow_inSection(0, 1);若原 OC 方法名里包含下劃線?_,在 JS 使用雙下劃線?__?代替:
// Obj-C: [JPObject _privateMethod]; JPObject.__privateMethod()3. defineClass
API
defineClass(classDeclaration, [properties,] instanceMethods, classMethods)
@param?classDeclaration: 字符串,類名/父類名和Protocol
@param?properties: 新增property,字符串?dāng)?shù)組,可省略
@param?instanceMethods: 要添加或覆蓋的實例方法
@param?classMethods: 要添加或覆蓋的類方法?
覆蓋方法
1.在 defineClass 里定義 OC 已存在的方法即可覆蓋,方法名規(guī)則與調(diào)用規(guī)則一樣,使用?_?分隔:
// OC @implementation JPTestObject - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath { } @end // JS defineClass("JPTableViewController", {tableView_didSelectRowAtIndexPath: function(tableView, indexPath) {...}, })2.使用雙下劃線?__?代表原OC方法名里的下劃線?_?:
// OC @implementation JPTableViewController - (NSArray *) _dataSource { } @end // JS defineClass("JPTableViewController", {__dataSource: function() {}, })3.在方法名前加?ORIG?即可調(diào)用未覆蓋前的 OC 原方法:
// OC @implementation JPTableViewController - (void)viewDidLoad { } @end // JS defineClass("JPTableViewController", {viewDidLoad: function() {self.ORIGviewDidLoad();}, })覆蓋類方法
defineClass()?第三個參數(shù)就是要添加或覆蓋的類方法,規(guī)則與上述覆蓋實例方法一致:
// OC @implementation JPTestObject + (void)shareInstance { } @end // JS defineClass("JPTableViewController", {//實例方法 }, {//類方法shareInstance: function() {...}, })覆蓋 Category 方法
覆蓋 Category 方法與覆蓋普通方法一樣:
@implementation UIView (custom) - (void)methodA { } + (void)clsMethodB { } @end defineClass('UIView', {methodA: function() {} }, {clsMethodB: function() {} });Super
使用?self.super()?接口代表 super 關(guān)鍵字,調(diào)用 super 方法:
// JS defineClass("JPTableViewController", {viewDidLoad: function() {self.super().viewDidLoad();} })Property
獲取/修改 OC 定義的 Property
用調(diào)用 getter / setter 的方式獲取/修改已在 OC 定義的 Property:
// OC @interface JPTableViewController @property (nonatomic) NSArray *data; @property (nonatomic) NSString *shareURL; @property (nonatomic) NSString *shareTitle; @end @implementation JPTableViewController @end // JS defineClass("JPTableViewController", {viewDidLoad: function() {var data = self.data(); //get property valueself.setData(data.toJS().push("JSPatch")); //set property valuevar sel = self;self.bridge().registerHandler_handler('h5ToNativeShareDialog', block('NSDictionary *',function(data,responseCallback) { sel.setShareURL(data.objectForKey('url'));sel.setShareTitle(data.objectForKey('title'));})); })動態(tài)新增 Property
可以在?defineClass()?第二個參數(shù)為類新增 property,格式為字符串?dāng)?shù)組,使用時與 OC property 接口一致:
defineClass("JPTableViewController", ['data', 'totalCount'], {init: function() {self = self.super().init()self.setData(["a", "b"]) //添加新的 Property (id data)self.setTotalCount(2)return self},viewDidLoad: function() {var data = self.data() //獲取 Property 值var totalCount = self.totalCount()}, })私有成員變量
使用?valueForKey()?和?setValue_forKey()?獲取/修改私有成員變量:
// OC @implementation JPTableViewController {NSArray *_data; } @end // JS defineClass("JPTableViewController", {viewDidLoad: function() {var data = self.valueForKey("_data") //get member variablesself.setValue_forKey(["JSPatch"], "_data") //set member variables}, })添加新方法
可以給一個類隨意添加 OC 未定義的方法,但所有的參數(shù)類型都是?id:
// OC @implementation JPTableViewController - (void)viewDidLoad {NSString* data = [self dataAtIndex:@(1)];NSLog(@"%@", data); //output: Patch } @end // JS var data = ["JS", "Patch"] defineClass("JPTableViewController", {dataAtIndex: function(idx) {return idx < data.length ? data[idx]: ""} })若新增的方法屬于 Protocol 里的接口,需要在 defineClass 的類聲明參數(shù)里指明實現(xiàn)的 Protocol,詳見下文。
Protocol
可以在定義時讓一個類實現(xiàn)某些 Protocol 接口,寫法跟 OC 一樣:
defineClass("JPViewController: UIViewController<UIScrollViewDelegate, UITextViewDelegate>", {})這樣做的作用是,當(dāng)添加 Protocol 里定義的方法,而類里沒有實現(xiàn)的方法時,參數(shù)類型不再全是?id,而是自動轉(zhuǎn)為 Protocol 里定義的類型:
@protocol UIAlertViewDelegate <NSObject> ... - (void)alertView:(UIAlertView *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex; ... @end defineClass("JPViewController: UIViewController <UIAlertViewDelegate>", {viewDidAppear: function(animated) {var alertView = require('UIAlertView').alloc().initWithTitle_message_delegate_cancelButtonTitle_otherButtonTitles("Alert",self.dataSource().objectAtIndex(indexPath.row()), self, "OK", null)alertView.show()}alertView_clickedButtonAtIndex: function(alertView, buttonIndex) {console.log('clicked index ' + buttonIndex)} })4. 特殊類型
Struct
JSPatch原生支持 CGRect / CGPoint / CGSize / NSRange 這四個 struct 類型,用 JS 對象表示:
// Obj-C UIView *view = [[UIView alloc] initWithFrame:CGRectMake(20, 20, 100, 100)]; [view setCenter:CGPointMake(10,10)]; [view sizeThatFits:CGSizeMake(100, 100)]; CGFloat x = view.frame.origin.x;NSRange range = NSMakeRange(0, 1); // JS var view = UIView.alloc().initWithFrame({x:20, y:20, width:100, height:100}) view.setCenter({x: 10, y: 10}) view.sizeThatFits({width: 100, height:100})var x = view.frame().x var range = {location: 0, length: 1}其他 Struct 類型的支持請參照?添加 struct 類型支持
Selector
在JS使用字符串代表 Selector:
//Obj-C [self performSelector:@selector(viewWillAppear:) withObject:@(YES)]; //JS self.performSelector_withObject("viewWillAppear:", 1)nil
JS 上的?null?和?undefined?都代表 OC 的?nil,如果要表示?NSNull, 用?nsnull?代替,如果要表示?NULL, 也用?null?代替:
//Obj-C @implemention JPTestObject + (BOOL)testNull(NSNull *null) {return [null isKindOfClass:[NSNull class]] } @end //JS require('JPTestObject').testNull(nsnull) //return 1 require('JPTestObject').testNull(null) //return 0在JS里面判斷是否為空要判斷false:
var url = ""; var rawData = NSData.dataWithContentsOfURL(NSURL.URLWithString(url)); if (rawData != null) {} //這樣判斷是錯誤的 應(yīng)該如下判斷: if (!rawData){} 在JSPatch.js源碼里_formatOCToJS方法對undefined,null,isNil轉(zhuǎn)換成了false。5. NSArray / NSString / NSDictionary
NSArray / NSString / NSDictionary 不會自動轉(zhuǎn)成對應(yīng)的JS類型,像普通 NSObject 一樣使用它們:
//Obj-C @implementation JPObject + (NSArray *)data {return @[[NSMutableString stringWithString:@"JS"]] } + (NSMutableDictionary *)dict {return [[NSMutableDictionary alloc] init]; } @end // JS require('JPObject') var ocStr = JPObject.data().objectAtIndex(0) ocStr.appendString("Patch")var dict = JPObject.dict() dict.setObject_forKey(ocStr, 'name') console.log(dict.objectForKey('name')) //output: JSPatch如果要把 NSArray / NSString / NSDictionary 轉(zhuǎn)為對應(yīng)的 JS 類型,使用?.toJS()?接口:
// JS var data = require('JPObject').data().toJS() //data instanceof Array === true data.push("Patch")var dict = JPObject.dict() dict.setObject_forKey(data.join(''), 'name') dict = dict.toJS() console.log(dict['name']) //output: JSPatch6. Block
block 傳遞
當(dāng)要把 JS 函數(shù)作為 block 參數(shù)給 OC時,需要先使用?block(paramTypes, function)?接口包裝:
// Obj-C @implementation JPObject + (void)request:(void(^)(NSString *content, BOOL success))callback {callback(@"I'm content", YES); } @end // JS require('JPObject').request(block("NSString *, BOOL", function(ctn, succ) {if (succ) log(ctn) //output: I'm content }))這里 block 里的參數(shù)類型用字符串表示,寫上這個 block 各個參數(shù)的類型,用逗號分隔。NSObject 對象如?NSString *,?NSArray *等可以用?id?表示,但 block 對象要用?NSBlock*表示。
從 OC 返回給 JS 的 block 會自動轉(zhuǎn)為 JS function,直接調(diào)用即可:?
// Obj-C @implementation JPObject typedef void (^JSBlock)(NSDictionary *dict); + (JSBlock)genBlock {NSString *ctn = @"JSPatch";JSBlock block = ^(NSDictionary *dict) {NSLog(@"I'm %@, version: %@", ctn, dict[@"v"])};return block; } + (void)execBlock:(JSBlock)blk { } @end // JS var blk = require('JPObject').genBlock(); blk({v: "0.0.1"}); //output: I'm JSPatch, version: 0.0.1若要把這個從 OC 傳過來的 block 再傳回給 OC,同樣需要再用?block()?包裝,因為這里?blk已經(jīng)是一個普通的 JS function,跟我們上面定義的 JS function 沒有區(qū)別:
// JS var blk = require('JPObject').genBlock(); blk({v: "0.0.1"}); //output: I'm JSPatch, version: 0.0.1 require('JPObject').execBlock(block("id", blk));總結(jié):JS 沒有 block 類型的變量,OC 的 block 對象傳到 JS 會變成 JS function,所有要從 JS 傳 block 給 OC 都需要用?block()?接口包裝。
block 里使用 self 變量
在 block 里無法使用?self?變量,需要在進入 block 之前使用臨時變量保存它:
defineClass("JPViewController", {viewDidLoad: function() {var slf = self;require("JPTestObject").callBlock(block(function(){//`self` is not available here, use `slf` instead.slf.doSomething();});} }限制
從 JS 傳 block 到 OC,有兩個限制:
A. block 參數(shù)個數(shù)最多支持6個。(若需要支持更多,可以修改源碼)
B. block 參數(shù)類型不能是?double?/?NSBlock?/?struct?類型。
另外不支持 JS 封裝的 block 傳到 OC 再傳回 JS 去調(diào)用(原因見?issue #155):
- (void)callBlock:(void(^)(NSString *str))block { } defineClass('JPTestObject', {run: function() {self.callBlock(block('NSString*', function(str) {console.log(str);}));},callBlock: function(blk) {//blk 這個 block 是上面的 run 函數(shù)里 JS 傳到 OC 再傳過來的,無法調(diào)用。blk("test block"); } });7. __weak / __strong
可以在 JS 通過?__weak()?聲明一個 weak 變量,主要用于避免循環(huán)引用。
例如我們在 OC 里為了避免 block 導(dǎo)致的循環(huán)引用,經(jīng)常這樣寫:
- (void)test {__weak id weakSelf = self;[self setCompleteBlock:^(){[weakSelf blabla];}] }在 JS 對應(yīng)的可以這樣寫:
var weakSelf = __weak(self) self.setCompleteBlock(block(function(){weakSelf.blabla(); }))若要在使用 weakSelf 時把它變成 strong 變量,可以用?__strong()?接口:
var weakSelf = __weak(self) self.setCompleteBlock(block(function(){var strongSelf = __strong(weakSelf)strongSelf.blabla(); }))8. GCD
使用?dispatch_after()?dispatch_async_main()?dispatch_sync_main()dispatch_async_global_queue()?接口調(diào)用GCD方法:
// Obj-C dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{// do something });dispatch_async(dispatch_get_main_queue(), ^{// do something }); // JS dispatch_after(1.0, function(){// do something }) dispatch_async_main(function(){// do something }) dispatch_sync_main(function(){// do something }) dispatch_async_global_queue(function(){// do something })9. 傳遞?id*?參數(shù)
如果你需要傳遞?id*?參數(shù),像?NSURLConnection?里的這個接口里的?NSError **:
+ (NSData *)sendSynchronousRequest:(NSURLRequest *)request returningResponse:(NSURLResponse **)response error:(NSError **)error;這里傳入的是一個指向 NSObject 對象的指針,在方法里可以修改這個指針指向的對象,調(diào)用后外部可以拿到新指向的對象,對于這樣的參數(shù),首先需要引入?JPMemory 擴展,然后按以下步驟進行傳遞和獲取:
舉個例子:
//OC - (void)testPointer:(NSError **)error {NSError *err = [[NSError alloc]initWithDomain:@"com.jspatch" code:42 userInfo:nil];*error = err; } //JS //malloc() pval() free() is provided by JPMemory extension require('JPEngine').addExtensions(['JPMemory'])var pError = malloc(sizeof("id")) self.testPointer(pError) var error = pval(pError) if (!error) {console.log("success") } else {console.log(error) } releaseTmpObj(pError) free(pError)若反過來你想在 JS 替換上述?-testPointer:?方法,構(gòu)建?NSError?對象賦給傳進來的指針,可以這樣寫:
defineClass('JPClassName', {testPointer: function(error){var tmp = require('NSError').errorWithDomain_code_userInfo("test", 1, null);var newErrorPointer = getPointer(tmp)memcpy(error, newErrorPointer, sizeof('id'))} );10. 常量、枚舉、宏、全局變量
常量/枚舉
Objective-C 里的常量/枚舉不能直接在 JS 上使用,可以直接在 JS 上用具體值代替:
//OC [btn addTarget:self action:@selector(handleBtn) forControlEvents:UIControlEventTouchUpInside]; //UIControlEventTouchUpInside的值是1<<6 btn.addTarget_action_forControlEvents(self, "handleBtn", 1<<6);或者在 JS 上重新定義同名的全局變量:
//js var UIControlEventTouchUpInside = 1 << 6; btn.addTarget_action_forControlEvents(self, "handleBtn", UIControlEventTouchUpInside);有些常量字符串,需要在 OC 用 NSLog 打出看看它的值是什么:
//OC [[NSAttributedString alloc].initWithString:@"str" attributes:@{NSForegroundColorAttributeName: [UIColor redColor]];上面代碼中?NSForegroundColorAttributeName?是一個靜態(tài)字符串常量,源碼里看不出它的值,可以先用 NSLog 打出它的值再直接寫在 JS 上:
//OC NSLog(@"%@", NSForegroundColorAttributeName) //output 'NSColor' NSAttributedString.alloc().initWithString_attributes("無效啊", {'NSColor': UIColor.redColor()});宏
獲取宏值
Objective-C 里的宏同樣不能直接在 JS 上使用。若定義的宏是一個值,可以在 JS 定義同樣的全局變量代替,若定義的宏是程序,可以在JS展開宏:
#define TABBAR_HEIGHT 40 #define SCREEN_WIDTH [[UIScreen mainScreen] bounds].size.height [view setWidth:SCREEN_WIDTH height:TABBAR_HEIGHT]; //JS view.setWidth_height(UIScreen.mainScreen().bounds().height, 40);若宏的值是某些在底層才能獲取到的值,例如?CGFLOAT_MIN,可以通過在某個類或?qū)嵗椒ɡ飳⑺祷?#xff0c;或者用添加擴展的方式提供支持:
@implementation JPMacroSupport + (void)main:(JSContext *)context {context[@"CGFLOAT_MIN"] = ^CGFloat() {return CGFLOAT_MIN;} } @end require('JPEngine').addExtensions(['JPMacroSupport']) var floatMin = CGFLOAT_MIN();修改宏值
JSPatch 不支持修改宏的值,若要修改,需要替換所有使用到這個宏的方法。例如:
#define VIEW_HEIGHT 40 @implementation JPMethodDemo + (void)func {UIView *view = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 100, VIEW_HEIGHT)];... } @end //JS var VIEW_HEIGHT_NEW = 20; defineClass('JPMethodDemo', {func: function() {var view = UIView.alloc().initWithFrame({x:0, y:0, width:100, height:VIEW_HEIGHT_NEW});...} });全局變量
在類里定義的?static?全局變量無法在 JS 上獲取到,若要在 JS 拿到這個變量,需要在 OC 有類方法或?qū)嵗椒ò阉祷?#xff1a;
static NSString *name; @implementation JPTestObject + (NSString *)name {return name; } @end var name = JPTestObject.name() //拿到全局變量值11. Swift
使用?defineClass()?覆蓋 Swift 類時,類名應(yīng)為?項目名.原類名,例如項目 demo 里用 Swift 定義了 ViewController 類,在 JS 覆蓋這個類方法時要這樣寫:
defineClass('demo.ViewController', {})對于調(diào)用已在 swift 定義好的類,也是一樣:
require('demo.ViewController')需要注意幾點:
詳見這篇文章
12. 加載動態(tài)庫
對于 iOS 內(nèi)置的動態(tài)庫,若原 APP 里沒有加載,可以通過以下方式動態(tài)加載,以加載?SafariServices.framework?為例:
var bundle = NSBundle.bundleWithPath("/System/Library/Frameworks/SafariServices.framework"); bundle.load();加載后就可以使用?SafariServices.framework?了。
13. 調(diào)試
可以使用?console.log()?打印一個對象,作用相當(dāng)于?NSLog(),會直接在 XCode 控制臺打出。
console.log()?支持任意參數(shù),但不支持像 NSLog 這樣?NSLog(@"num:%f", 1.0)?的拼接:
var view = UIView.alloc().init(); var str = "test"; var num = 1; console.log(view, str, num) console.log(str + num); //直接在JS拼接字符串總結(jié)
以上是生活随笔為你收集整理的JSPatch 基础用法的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: windows系统点击我的电脑显示找不到
- 下一篇: H5基本开发1——(H5简单概述)