解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException

在 Vaadin 8 应用中处理大型音频文件（超过 7 MB）时，用户在尝试进行音频定位（seek）操作时可能会遭遇 `java.io.IOException: A connection established by software on your host computer has been dropped` 错误。此问题通常源于 Vaadin 8 内置 `Audio` 组件在处理大文件时尝试一次性加载整个文件，或超出服务器容器的文件服务限制。推荐的解决方案是采用 Vaadin Directory 中的 `AudioVideo` 组件，该组件支持范围请求（Range Requests），允许浏览器按需加载音频片段，从而显著提升大文件处理的性能和用户体验。

理解 IOException 的成因

当 Vaadin 8 应用在播放或定位大型音频文件时抛出 java.io.IOException: Se ha anulado una conexión establecida por el software en su equipo host. (或其英文对应 A connection established by software on your host computer has been dropped) 错误，通常意味着在服务器尝试将音频数据发送到客户端的过程中，网络连接被意外终止。结合错误堆栈信息，如 sun.nio.ch.SocketDispatcher.writev0(Native Method) 和 io.undertow.server.protocol.http.HttpResponseConduit.write，以及 Vaadin 自身的 DownloadStream.writeResponse，我们可以推断问题发生在数据传输层面。

导致此问题的主要原因有：

1. Vaadin 8 Audio 组件的局限性： Vaadin 8 提供的默认 Audio 组件相对简单，它倾向于一次性将整个音频文件加载到内存并尝试传输给客户端。对于小型文件这不成问题，但当文件大小超过一定阈值（例如 7 MB），这种全文件加载和传输策略会导致：
   • 内存压力： 服务器需要为整个文件分配内存。
   • 传输时间过长： 客户端可能因等待时间过长而超时断开连接，尤其是在网络条件不佳的情况下。
   • 服务器/容器限制： 服务器或其底层容器（如 Undertow、Tomcat）可能对单个请求的最大响应大小或连接超时时间有默认限制，大文件传输容易触及这些限制。
2. HTTP 范围请求缺失： 现代浏览器在处理媒体文件时，尤其是进行定位（seeking）操作时，会发送 HTTP 范围请求（Range Requests）。这意味着浏览器只请求文件中的特定字节范围，而不是整个文件。如果服务器端（或 Vaadin 组件）不支持这些请求，浏览器在尝试定位时可能无法获取所需的数据片段，从而导致连接中断。

解决方案

针对此问题，存在两种主要的解决方案，其中一种是强烈推荐的。

方案一：使用 Vaadin Directory 的 AudioVideo 组件（推荐）

这是解决大文件音频播放和定位问题的最佳实践。AudioVideo 组件是 Vaadin 社区开发的一个增强型媒体组件，它专门为解决 Vaadin 8 Audio 和 Video 组件的局限性而设计。

核心优势：支持 HTTP 范围请求

AudioVideo 组件最显著的特点是它内置了对 HTTP 范围请求的支持。当浏览器需要播放或定位音频文件时，它不会一次性请求整个文件，而是发送一个带有 Range 头部的 HTTP 请求，指定需要获取的字节范围。AudioVideo 组件能够正确解析这些请求，并仅返回文件中的相应片段。

工作原理：

1. 用户在浏览器中对音频进行定位（seek）操作。
2. 浏览器发送一个 HTTP GET 请求，并在请求头中包含 Range: bytes=start-end，表示它需要音频文件从 start 字节到 end 字节的数据。
3. 服务器端的 AudioVideo 组件接收到此请求后，会根据 Range 头信息，从实际的音频文件中读取指定范围的数据。
4. 服务器以 206 Partial Content 状态码响应，并在响应体中包含请求的字节范围数据。
5. 浏览器接收到数据后，即可立即从指定位置开始播放。

这种机制避免了传输整个大文件，显著提高了大文件处理的效率和用户体验，尤其是在网络带宽有限或文件特别大的情况下。

使用示例：

首先，您需要将 AudioVideo 组件添加到您的 Vaadin 项目依赖中。如果您使用 Maven，可以在 pom.xml 中添加：

<dependency>
    <groupId>org.vaadin.addons</groupId>
    <artifactId>audiovideo</artifactId>
    <version>VERSION</version> <!-- 替换为最新版本，例如 1.0.0 -->
</dependency>

然后，在您的 Vaadin UI 代码中，用 AudioVideo 替换原有的 Audio 组件：

Type

生成草稿，转换文本，获得写作帮助-等等。

83

查看详情

import org.vaadin.addons.audiovideo.client.AudioVideo;
import com.vaadin.server.StreamResource;
import com.vaadin.ui.VerticalLayout;
import java.io.InputStream;
import java.io.FileInputStream;
import java.io.File;

public class AudioPlaybackView extends VerticalLayout {

    public AudioPlaybackView() {
        // 假设您的音频文件路径
        File audioFile = new File("/path/to/your/large_audio.mp3");

        // 创建一个 StreamResource 来提供音频文件
        StreamResource audioResource = new StreamResource((StreamResource.StreamSource) () -> {
            try {
                return new FileInputStream(audioFile);
            } catch (Exception e) {
                e.printStackTrace();
                return null;
            }
        }, audioFile.getName());

        // 使用 AudioVideo 组件
        AudioVideo audioPlayer = new AudioVideo(audioResource);
        audioPlayer.setWidth("100%");
        audioPlayer.setHeight("50px");
        audioPlayer.setControls(true); // 显示播放控制条
        audioPlayer.setAutoplay(false); // 不自动播放

        // 如果需要，可以设置其他属性，例如预加载模式
        // audioPlayer.setPreload(AudioVideo.Preload.AUTO);

        addComponent(audioPlayer);

        // 您原有的 seekAudio 逻辑可能需要调整，直接操作 AudioVideo 实例
        // 例如：
        // audioPlayer.setPlayheadPosition(secs); // 设置播放头位置
    }

    // 您原有的 seekAudio 方法，如果直接操作 HTML DOM，可能仍然有效，
    // 但更推荐使用 AudioVideo 组件提供的高级API来控制播放。
    // private synchronized void seekAudio(double secs, String id) {
    //     Page.getCurrent().getJavaScript().execute("{" + "document.getElementById('" + id + "').load();}");
    //     Page.getCurrent().getJavaScript().execute("{" + "document.getElementById('" + id + "').currentTime = "+secs+";}");
    //     Page.getCurrent().getJavaScript().execute("{" + "document.getElementById('" + id + "').playbackRate = "+ speed +";}");
    // }
}

请注意，如果您的 seekAudio 方法是直接通过 JavaScript 操作 HTML DOM 元素，那么它仍然可能与 AudioVideo 组件兼容，因为 AudioVideo 最终也会渲染成标准的 HTML <audio> 标签。但为了更好地利用 AudioVideo 的功能，建议优先使用其提供的 Java API 来控制播放和定位。

方案二：调整服务器/容器配置（不推荐作为主要解决方案）

此方案是治标不治本的方法，它并不能根本上改善大文件媒体流的传输效率和用户体验，但可以在特定情况下作为临时或辅助措施。

您可以尝试调整您的应用服务器（如 WildFly/Undertow、Tomcat 等）的相关配置，以允许更大的文件传输或延长连接超时时间。

以 WildFly/Undertow 为例：

如果您使用的是 WildFly，其默认的 HTTP 服务器是 Undertow。您可能需要调整 Undertow 的一些配置参数，例如：

• max-post-size： 尽管这里是 GET 请求，但某些中间件或代理可能会受此影响。
• buffer-pool 大小： 增加用于 I/O 操作的缓冲区大小。
• 连接超时： 延长 HTTP 连接的超时时间。

这些配置通常在 WildFly 的 standalone.xml 或 domain.xml 中进行。例如，找到 undertow 子系统配置：

<subsystem xmlns="urn:jboss:domain:undertow:12.0">
    <buffer-cache name="default"/>
    <server name="default-server">
        <http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/> <!-- 示例：增加 max-post-size 到 100MB -->
        <!-- 其他配置 -->
    </server>
    <!-- 其他配置 -->
</subsystem>

注意事项：

• 增加这些限制可能会对服务器资源消耗产生影响。
• 这并不能解决浏览器在定位时对部分内容请求的需求，用户体验仍然不佳。
• 对于非常大的文件，即使增加了限制，仍然可能因为网络延迟或客户端超时而失败。

总结与最佳实践

当在 Vaadin 8 中处理大型音频文件并遇到 IOException 时，根本原因通常在于默认组件缺乏对 HTTP 范围请求的支持以及服务器/客户端连接的限制。

最佳实践是：

1. 优先使用 AudioVideo 组件： 它是解决此问题的最优雅和高效的方法，通过支持范围请求，可以显著提升大文件媒体的播放性能和用户体验。
2. 避免直接操作 DOM 进行定位（如果 AudioVideo 提供对应 API）： 尽可能利用 AudioVideo 组件提供的 Java API 来控制媒体播放，这样可以更好地与 Vaadin 的生命周期和服务器端逻辑集成。
3. 审慎调整服务器配置： 只有在理解其潜在影响的情况下，才考虑调整服务器的最大文件大小或连接超时等配置，且这应作为辅助手段，而非主要解决方案。

通过采用 AudioVideo 组件，您可以构建一个更加健壮和用户友好的 Vaadin 应用，即使在处理大型媒体文件时也能提供流畅的播放和定位体验。

以上就是解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException的详细内容，更多请关注php中文网其它相关文章！