WebViewJavascriptBridge源代码分析

近期抽时间看了一遍WebViewJavascriptBridge这个开源框架，把看到的内容记录下来

源代码地址：https://github.com/marcuswestin/WebViewJavascriptBridge

1、对外接口

初始化OC	初始化JS
*[WebViewJavascriptBridge bridgeForWebView:(UIWebView/WebView)webview handler:(WVJBHandler)handler] [WebViewJavascriptBridge bridgeForWebView:(UIWebView/WebView)webview webViewDelegate:(UIWebViewDelegate)webViewDelegate handler:(WVJBHandler)handler]**	document.addEventListener('WebViewJavascriptBridgeReady', function onBridgeReady(event) { ... }, false) bridge.init(function messageHandler(data, response) { ... })
OC发送消息to JS	JS发送消息to OC
[bridge send:(id)data] [bridge send:(id)data responseCallback:(WVJBResponseCallback)responseCallback]	bridge.send("Hi there!") bridge.send({ Foo:"Bar" }) bridge.send(data, function responseCallback(responseData) { ... })
OC注冊事件（先）	JS调用事件（后）
*[bridge registerHandler:(NSString)handlerName handler:(WVJBHandler)handler]**	WebViewJavascriptBridge.callHandler("handlerName")
OC调用事件（后）	JS注冊事件（先）
*[bridge callHandler:(NSString)handlerName data:(id)data] [bridge callHandler:(NSString)handlerName data:(id)data responseCallback:(WVJBResponseCallback)callback]*	bridge.registerHandler("handlerName", function(responseData) { ... })

三类API接口用于OC与JS之间交互：初始化接口；发送消息接口，而且能够加入发送消息完毕的回调函数。事件注冊和调用接口，须要先在一端注冊事件，还有一端能够依据事件名称调用函数

除了上述提到的外部方法：还有两个方法十分重要，JS部分最重要的内部方法： _handleMessageFromObjC。OC部分重要的内部方法：flushMessageQueue

2、类结构图

WebViewJavascriptBridge眼下既支持原有的UIWebView，也支持iOS8+之后新的WKWebView。使用时能够二选其一；

WebViewjavascriptBridgeBase是通用类，用于处理从Native到JS的消息注入。消息队列处理和分发，JSON数据的序列化和反序列化，LOG输出；

3、源代码分析

3.1 消息发送JS－》Native

[bridge send:(id)data]

[bridge send:(id)data responseCallback:(WVJBResponseCallback)responseCallback]

这两个函数最后都是调用_doSend({ data:data }, responseCallback)

function _doSend(message, responseCallback) {
if (responseCallback) {
var callbackId = 'cb_'+(uniqueId++)+'_'+new Date().getTime()
responseCallbacks[callbackId] = responseCallback
message['callbackId'] = callbackId
}
sendMessageQueue.push(message)
messagingIframe.src = CUSTOM_PROTOCOL_SCHEME + '://' + QUEUE_HAS_MESSAGE
}

首先生成callbackId。由不断加1的唯一须要和时间戳构成，假设有responseCallback函数，使用callbackId作为索引。存入responseCallbacks对象，等到从OC側返回的信息中相应的callbackId与当前responseCallbacks中callbackId同样时。调用回调函数responseCallback；sendMessageQueue是个消息数组。每次的新消息放入当中。messagingIframe是iframe对象，当设置src产生一次请求，在OC端的

(BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType 会拦截请求内容

代码：

- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
    if (webView != _webView) { return YES; }
    NSURL *url = [request URL];
    __strong WVJB_WEBVIEW_DELEGATE_TYPE* strongDelegate = _webViewDelegate;
    if ([_baseisCorrectProcotocolScheme:url]) {
        if ([_baseisCorrectHost:url]) {
            NSString *messageQueueString = [self_evaluateJavascript:[_basewebViewJavascriptFetchQueyCommand]];
            [_base flushMessageQueue:messageQueueString];
        } else {
            [_base logUnkownMessage:url];
        }
        return NO;
    } else if (strongDelegate && [strongDelegate respondsToSelector:@selector(webView:shouldStartLoadWithRequest:navigationType:)]) {
        return [strongDelegate webView:webView shouldStartLoadWithRequest:requestnavigationType:navigationType];
    } else {
        return YES;
    }

}

重点部分：运行注入_evaluateJavascript，

-(NSString *)webViewJavascriptFetchQueyCommand {
return @"WebViewJavascriptBridge._fetchQueue();";

}

function _fetchQueue() {

var messageQueueString = JSON.stringify(sendMessageQueue)

sendMessageQueue = []

return messageQueueString

}

这个函数从JS的sendMessageQueue消息队列获取内容返回，这个sendMessageQueue是在之前的_doSend函数中传入的消息内容，也就是NSString *messageQueueString = [self_evaluateJavascript:[_basewebViewJavascriptFetchQueyCommand]];这句代码获得从JS側拿到的数据内容，然后调用[_baseflushMessageQueue:messageQueueString];对消息分发处理

- (void)flushMessageQueue:(NSString *)messageQueueString{
    id messages = [self_deserializeMessageJSON:messageQueueString];
    if (![messages isKindOfClass:[NSArray class]]) {
        NSLog(@"WebViewJavascriptBridge: WARNING: Invalid %@ received: %@", [messagesclass], messages);
        return;
    }
    for (WVJBMessage* messagein messages) {
        if (![message isKindOfClass:[WVJBMessage class]]) {
            NSLog(@"WebViewJavascriptBridge: WARNING: Invalid %@ received: %@", [messageclass], message);
            continue;
        }
        [self _log:@"RCVD" json:message];

        NSString* responseId = message[@"responseId"];
        if (responseId) {
            WVJBResponseCallback responseCallback =_responseCallbacks[responseId];
            responseCallback(message[@"responseData"]);
            [self.responseCallbacksremoveObjectForKey:responseId];
        } else {
            WVJBResponseCallback responseCallback =NULL;
            NSString* callbackId = message[@"callbackId"];
            if (callbackId) {
                responseCallback = ^(id responseData) {
                    if (responseData == nil) {
                        responseData = [NSNullnull];
                    }

                    WVJBMessage* msg = @{@"responseId":callbackId, @"responseData":responseData };
                    [self _queueMessage:msg];
                };
            } else {
                responseCallback = ^(id ignoreResponseData) {
                    // Do nothing
                };
            }

            WVJBHandler handler;
            if (message[@"handlerName"]) {
                handler = self.messageHandlers[message[@"handlerName"]];
            } else {
                handler = self.messageHandler;
            }

            if (!handler) {
                [NSException raise:@"WVJBNoHandlerException" format:@"No handler for message from JS: %@", message];
            }

            handler(message[@"data"], responseCallback);
        }
    }

}

这个是整个框架中OC側重要的函数。可是眼下首先分析消息发送JS－》Native涉及到的部分内容。返回的消息包括callbackId。数据拼接后调用[self_queueMessage:msg];发送回JS側的数据改为responseId为keywordkey，详细例如以下：

- (void)_queueMessage:(WVJBMessage*)message {
    if (self.startupMessageQueue) {
        [self.startupMessageQueueaddObject:message];
    } else {
        [self _dispatchMessage:message];
    }

}

self.startupMessageQueue仅仅有首次启动时有效，之后为nil，所以都是走[self_dispatchMessage:message];

- (void)_dispatchMessage:(WVJBMessage*)message {
    NSString *messageJSON = [self_serializeMessage:message];
    [self _log:@"SEND" json:messageJSON];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\\"withString:@"\\\\"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\""withString:@"\\\""];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\'"withString:@"\\\'"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\n"withString:@"\\n"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\r"withString:@"\\r"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\f"withString:@"\\f"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\u2028"withString:@"\\u2028"];
    messageJSON = [messageJSON stringByReplacingOccurrencesOfString:@"\u2029"withString:@"\\u2029"];

    NSString* javascriptCommand = [NSStringstringWithFormat:@"WebViewJavascriptBridge._handleMessageFromObjC('%@');", messageJSON];
    if ([[NSThreadcurrentThread] isMainThread]) {
        [self _evaluateJavascript:javascriptCommand];

    } else {
        dispatch_sync(dispatch_get_main_queue(), ^{
            [self _evaluateJavascript:javascriptCommand];
        });
    }

}

此函数对message特殊字符进行转义处理。然后运行JS注入语句，WebViewJavascriptBridge._handleMessageFromObjC运行到JS側

这个是整个框架中JS側重要的函数，用于处理从OC側返回的消息

function _dispatchMessageFromObjC(messageJSON) {
setTimeout(function _timeoutDispatchMessageFromObjC() {
var message = JSON.parse(messageJSON)
var messageHandler
var responseCallback

if (message.responseId) {
responseCallback = responseCallbacks[message.responseId]
if (!responseCallback) { return; }
responseCallback(message.responseData)
delete responseCallbacks[message.responseId]
} else {
if (message.callbackId) {
var callbackResponseId = message.callbackId
responseCallback = function(responseData) {
_doSend({ responseId:callbackResponseId, responseData:responseData })
}
}

var handler = WebViewJavascriptBridge._messageHandler
if (message.handlerName) {
handler = messageHandlers[message.handlerName]
}

try {
handler(message.data, responseCallback)
} catch(exception) {
if (typeof console != 'undefined') {
console.log("WebViewJavascriptBridge: WARNING: javascript handler threw.", message, exception)
}
}
}
})
}

运行JS側本地回调函数

3.2 消息发送 OC--》JS

bridge.send("Hi there!")

bridge.send({ Foo:"Bar" })

bridge.send(data, function responseCallback(responseData) { ... })

调用

[_base sendData:dataresponseCallback:responseCallback handlerName:nil];

运行 _queueMessage

3.3 OC注冊事件和JS调用

OC側注冊

- (void)registerHandler:(NSString *)handlerName handler:(WVJBHandler)handler {

_base.messageHandlers[handlerName] = [handlercopy];

}

JS调用

function callHandler(handlerName, data, responseCallback) {

_doSend({ handlerName:handlerName, data:data }, responseCallback)

}

加入handlerName和data数据传给OC側，JS側记录responseCallback。最后也会走到- (void)flushMessageQueue:(NSString *)messageQueueString函数中，因为既没有callbackId也没有responseId，所以仅仅处理handlerName及相关数据，最后走到 - (void)flushMessageQueue:(NSString *)messageQueueString解析，OC側运行之前注冊的handler并传入data数据

3.4 JS注冊事件和OC调用

JS注冊

function registerHandler(handlerName, handler) {

messageHandlers[handlerName] = handler

}

本地记录

OC调用

- (void)callHandler:(NSString *)handlerName data:(id)data {
[self callHandler:handlerName data:dataresponseCallback:nil];

}

- (void)callHandler:(NSString *)handlerName data:(id)data responseCallback:(WVJBResponseCallback)responseCallback {
[_base sendData:data responseCallback:responseCallbackhandlerName:handlerName];

}

handlerName和data 在 - (void)sendData:(id)data responseCallback:(WVJBResponseCallback)responseCallback handlerName:(NSString*)handlerName中处理

4 、总结

1、与其他框架相比。此框架没有採用url拦截解析參数方式，而是多次JS注入參数获取，API接口暴露的操作在底层须要多次OC与JS之间交互完毕

2、WKwebview部分没有使用新的delgate方法，而是沿用iframe方式，个人认为採用新接口可能效率更高

posted on 2018-02-02 15:23 yjbjingcha 阅读(537) 评论(0) 编辑收藏举报

刷新页面返回顶部

yjbjingcha

WebViewJavascriptBridge源代码分析

导航