JxBrowser是將基于Chromium的瀏覽器與Java應(yīng)用程序集成，以處理和顯示HTML5、CSS3、JavaScript、Flash等。

近日，JxBrowser v7.12發(fā)布啦！在JxBrowser 7.12中，Chromium引擎已升級(jí)到版本84。此Chromium版本在源代碼中有一些重大更改，這些更改會(huì)影響JxBrowser的公共API。在本升級(jí)指南中，描述了7.12中刪除了哪些API，以及應(yīng)該使用哪些替代方法。

點(diǎn)擊下載最新版JxBrowser

覆蓋HTTP請(qǐng)求頭部

v7.11

在Chromium 84中，BeforeSendHeadersCallback和BeforeSendProxyHeadersCallback回調(diào)已被刪除。

network.set(BeforeSendHeadersCallback.class, params -> 
        BeforeSendHeadersCallback.Response.override(modifiedHeaders));
network.set(BeforeSendProxyHeadersCallback.class, params ->
        BeforeSendProxyHeadersCallback.Response.override(modifiedHeaders));

v7.12

要在HTTP頭信息被發(fā)送到Web服務(wù)器之前覆蓋它們，請(qǐng)使用以下API。

network.set(BeforeStartTransactionCallback.class, params -> 
    BeforeStartTransactionCallback.Response.override(modifiedHeaders));

資源篩選

在Chromium 84中刪除了LoadResourceCallback回調(diào)。

v7.11

network.set(LoadResourceCallback.class, params -> {
    if (params.resourceType() == ResourceType.IMAGE) {
        return LoadResourceCallback.Response.cancel();
    }
    return LoadResourceCallback.Response.load();
});

v7.12

使用BeforeUrlRequestCallback回調(diào)來(lái)過(guò)濾資源，如下所示。

network.set(BeforeUrlRequestCallback.class, params -> {
    if (params.urlRequest().resourceType() == ResourceType.IMAGE) {
        return BeforeUrlRequestCallback.Response.cancel();
    }
    return BeforeUrlRequestCallback.Response.proceed();
});

緩存

v7.11

刪除了被廢棄的HttpCache.clearDiskCache(Runnable)方法。

httpCache.clearDiskCache(() -> {
    // HTTP cache has been cleared.
});

v7.12

使用以下API代替。

CompletableFuturefuture = httpCache.clear();

鼠標(biāo)輪

v7.11

以下com.teamdev.jxbrowser.ui.event.MouseWheel方法已被刪除。

• isHorizontalScroll()
  
• scrollbarPixelsPerLine()
  
• unitsToScroll()

v7.12

使用 deltaX() 和 deltaY() 方法替代。

鍵盤(pán)活動(dòng)

訪問(wèn)com.teamdev.jxbrowser.dom.event.KeyEvent中的密鑰代碼的方式已經(jīng)改變。因此，刪除了無(wú)用的com.teamdev.jxbrowser.dom.event.KeyEvent.keyCode()方法。

v7.11

要訪問(wèn)DOM KeyEvent的密鑰代碼，你可以使用以下API。

document.addEventListener(EventType.KEY_PRESS, event -> {
    if (event instanceof KeyEvent) {
        KeyEvent keyEvent = (KeyEvent) event;
        System.out.println("DOM KeyEvent: keyCode=" + keyEvent.keyCode());
    }
}, false);

v7.12

在這個(gè)版本中，改進(jìn)了這個(gè)功能，所以現(xiàn)在它的工作方式接近于DOM API的工作方式。

document.addEventListener(EventType.KEY_PRESS, event -> {
    if (event instanceof KeyEvent) {
        KeyEvent keyEvent = (KeyEvent) event;
        DomKeyCode keyCode = keyEvent.domKeyCode();
        String character = keyEvent.character();
        System.out.println("DOM KeyEvent: keyCode=" + keyCode  + ", character=" + character);
    }
}, false);

現(xiàn)在，你可以得到預(yù)期的按鍵代碼和當(dāng)前所選語(yǔ)言中的按鍵字符的字符串表示。

加載URL

v7.11

以下的導(dǎo)航方法已被刪除。

• loadUrlAndWait(String, Timestamp)
  
• loadUrlAndWait(LoadUrlParams, Timestamp)
  

v7.12

使用以下方法代替：

• loadUrlAndWait(String url, Duration timeout)
  
• loadUrlAndWait(LoadUrlParams params, Duration timeout)