JxBrowser是将基于Chromium的浏览器与Java应用程序集成,以处理和显示HTML5,CSS3,JavaScript,Flash等。
JxBrowser更新至最新版v7.1,引入了BytesReceived允许获取有关从网络接收的字节数的信息,允许使用部分回调将鼠标和键盘事件发送到网页之前拦截,改进多种功能,修复多项Bug,我们一起来看一看新功能详解吧!
新增功能
以下示例演示如何抑制鼠标滚轮,可以使用这些回调来获取有关鼠标和键盘事件的通知,以便在应用程序中实现热键。
browser.set(MoveMouseWheelCallback.class, params -> Response.suppress());
- 拦截鼠标和键盘事件:允许使用以下回调将鼠标和键盘事件发送到网页之前拦截它们。
- EnterMouseCallback
- ExitMouseCallback
- MoveMouseCallback
- MoveMouseWheelCallback
- PressKeyCallback
- PressMouseCallback
- ReleaseKeyCallback
- ReleaseMouseCallback
- TypeKeyCallback
- 访问网页的位图:允许获取包含当前加载的网页的像素的位图,其中包含当前Browser大小。
- 以下示例演示如何获取位图,将其转换为Java AWT和JavaFX图像,并将其保存为PNG文件:(Swing和JavaFX)
// Creating and running Chromium engine Engine engine = Engine.newInstance( EngineOptions.newBuilder(HARDWARE_ACCELERATED).build()); Browser browser = engine.newBrowser(); // Resize browser to the required dimension browser.resize(500, 500); // Load the required web page and wait until it is loaded completely browser.navigation().loadUrlAndWait("https://www.google.com"); // Take a bitmap of the currently loaded web page. Its size will be // equal to the current browser's size. Bitmap bitmap = browser.bitmap(); // Convert the bitmap to javafx.scene.image.Image Image image = BitmapUtil.toImage(bitmap); // Convert javafx.scene.image.Image to java.awt.image.BufferedImage BufferedImage bufferedImage = SwingFXUtils.fromFXImage(image, null); // Save the image to a PNG file ImageIO.write(bufferedImage, "PNG", new File("bitmap.png")); // Creating and running Chromium engine Engine engine = Engine.newInstance( EngineOptions.newBuilder(HARDWARE_ACCELERATED).build()); Browser browser = engine.newBrowser(); // Resize browser to the required dimension browser.resize(500, 500); // Load the required web page and wait until it is loaded completely browser.navigation().loadUrlAndWait("https://www.google.com"); // Take a bitmap of the currently loaded web page. Its size will be // equal to the current browser's size. Bitmap bitmap = browser.bitmap(); // Convert the bitmap to javafx.scene.image.Image Image image = BitmapUtil.toImage(bitmap); // Convert javafx.scene.image.Image to java.awt.image.BufferedImage BufferedImage bufferedImage = SwingFXUtils.fromFXImage(image, null); // Save the image to a PNG file ImageIO.write(bufferedImage, "PNG", new File("bitmap.png"));
- JavaScript-Java Bridge:@JsAccessible可以在类上使用注释。
- WebStorage API:允许访问本地和会话存储,并直接从Java代码中使用。
WebStorage localStorage = frame.localStorage(); localStorage.putItem("car", "BMW"); localStorage.clear();
- 远程调试URL:恢复了允许获取特定实例中加载的网页的远程调试URL的功能。
- 以下示例演示了如何执行此操作:
browser.devTools().remoteDebuggingUrl().ifPresent(url -> {});
- JFXPanel:JxBrowser为BrowserViewSwing和JavaFX应用程序提供了两个组件。
- 选择媒体设备:如果环境中有多个网络摄像头和麦克风,并且网页想要使用其中一个,可以使用SelectMediaDeviceCallback告诉网页应该使用哪个设备。
- 以下示例演示如何在可用设备列表中选择第一个设备:
engine.mediaDevices().set(SelectMediaDeviceCallback.class, params -> Response.select(params.mediaDevices().get(0)));
- 如果您想禁止网页访问您的麦克风或网络摄像头,您可以使用RequestPermissionCallback如下所示:
engine.permissions().set(RequestPermissionCallback.class, (params, tell) -> { PermissionType type = params.permissionType(); if (type == PermissionType.VIDEO_CAPTURE || type == PermissionType.AUDIO_CAPTURE) { tell.deny(); } else { tell.grant(); } });
- 访问HTTP响应正文:添加ResponseBytesReceived了允许访问HTTP响应主体的字节。
network.on(ResponseBytesReceived.class, event -> { byte[] data = event.data(); });
- 隐藏滚动条:使用以下方法隐藏滚动条。
browser.settings().hideScrollbars();
- DOM API:允许获取Document实例的Node实例
- I18N国际化:在浏览本地文件系统时,库现在支持国际化(I18N)。
- 禁用触摸菜单:扩展了EngineOptions附加选项,允许在Windows 10触摸设备上禁用触摸菜单。
Engine engine = Engine.newInstance( EngineOptions.newBuilder(renderingMode) .disableTouchMenu() .build());
- 请求焦点事件:要在JavaScript请求通过window.focus()您关注时收到通知,可以使用以下FocusRequested事件:
browser.on(FocusRequested.class, event -> {});
- 语言API:Language枚举已经扩展了Language.of(String language, String country)其获得相应的静态方法Language为给定的语言和国家枚举项目。
- Certificate.toX509Certificate():Certificate类已使用Optional <X509Certificate> toX509Certificate()方法进行了扩展,该方法允许使用存储在证书的DER编码字节数组中的数据初始化X.509证书。
改进
- 检测Java进程是否被kill -9macOS或Linux上的信号意外终止,并终止browsercore被杀死的Java进程创建的进程。
- browsercore.exe在Windows上更新该过程的详细信息。
- XPathResult.asSingleNode()Optional在找不到节点时返回空而不是抛出异常。
- StartDownloadCallbackSwing和JavaFX BrowserView组件的默认实现。现在,当您尝试下载文件时,将显示默认的“保存文件”对话框,您可以在其中选择下载和保存文件的位置。除非您注册自己的回调并覆盖默认行为。
- BrowserView首次显示Swing时,减少Windows上的黑色闪烁。
Bug修复
- 恢复macOS 10.10支持。
- 在macOS和Windows上工作时,引擎语言选项被忽略并且在Linux上始终为ENGLISH_US。
- 弹出窗口的主框架绑定到不同的Browser实例。
- java.awt.IllegalComponentStateException:组件必须在屏幕上显示,以确定移动JFrame时其中的位置,其中包含不可见的Swing BrowserView组件。
- 调用BrowserView.setSize(0,0)时出现java.lang.IllegalArgumentException。
- java.lang.OutOfMemoryError尝试记录包含~20MB字符串的RPC请求。
- StartNavigationCallback.Params.url()在应该出现的情况下返回没有协议的URL地址。
- 在console.log()或alert()中打印通过JsObject.putProperty()方法注册的属性时发生本机崩溃。
- IFRAME内的PDF文件在整个视图中打开,而不是在网页的框架中打开。
- java.lang.NullPointerExceptionBrowser在创建它之后立即关闭。
- 无法在使用与Service Workers一起使用的JavaScript的网页上注册ServiceWorker错误。
- java.lang.NoSuchMethodError:com.teamdev.jxbrowser.ui.internal.rpc.Bitmap.getPixels()Lcom / google / protobuf / ByteString; 将光标移动到JavaFX BrowserView中的网页上时。
- 由于QuotaExceededError导致无法使用IndexedDB,因此某些网站(例如https://evernote.com)未加载。
点击下方“了解更多”免费下载最新版JxBrowser