Http流式响应接口封装

1. 背景

需要对接某个大模型的流式http对话接口,因为该项目中还需要对接另外的大模型服务但是另一个请求方式为websocket,为了实现模型服务切换以及对客户端做统一的流式响应,需要对大模型服务的调用做统一的流式响应封装。

环境:JDK11

2. 代码

2.1 回调函数

@FunctionalInterface
public interface LLMChatCallback {
   
   

    void callback(String message);

}

2.2 统一对话接口

public interface LLMService {
   
   

    /**
     * 模型对话
     *
     * @param payload 用于请求大模型的参数
     * @param callback 响应回调 调用者通过实现callback函数接收消息
     **/
    void dialogue(String payload, LLMChatCallback callback);

}

2.3 StringSubscriber

import lombok.extern.slf4j.Slf4j;
import java.util.concurrent.Flow;

/**
 * http响应式流订阅
 **/
@Slf4j
public class StringSubscriber implements Flow.Subscriber<String> {
   
   

    Flow.Subscription subscription;

    /**
     * 消息回调接口
     */
    private 
### 将API响应数据封装为文件下载接口的最佳实践 在实际开发过程中,将API返回的数据转换为可供用户下载的文件是一种常见的需求。这种场景通常用于导出报表、日志或其他结构化数据到CSV、Excel或PDF等格式。以下是关于如何将API响应数据封装成文件下载接口的具体实现方法。 #### 1. 前端实现文件下载逻辑 前端可以通过创建`Blob`对象并触发浏览器的下载行为来实现文件下载功能。以下是一个基于Vue.js的示例: ```javascript // 定义一个通用的方法用于处理文件下载 function downloadFile(data, fileName, mimeType) { const blob = new Blob([data], { type: mimeType }); const url = window.URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = fileName; // 设置文件名 document.body.appendChild(a); // 需要将<a>标签添加至DOM中才能生效 a.click(); window.URL.revokeObjectURL(url); // 清理临时链接 } export function fetchAndDownload(apiUrl, params, fileName, mimeType = 'application/octet-stream') { return axios.post(apiUrl, params, { responseType: 'blob' // 确保后端返回的是二进制流 }).then(response => { downloadFile(response.data, fileName, mimeType); }).catch(error => { console.error('文件下载失败:', error); }); } ``` 此函数的核心在于使用`axios`发送请求,并设置`responseType`为`blob`以便接收二进制数据[^4]。随后通过`Blob`对象构建本地文件链接,并模拟点击事件完成下载动作。 #### 2. 后端支持文件流式传输 为了让前端能够顺利获取到可下载的内容,后端需要正确配置HTTP响应头以及返回适当的数据格式。例如,在Node.js环境中可以这样实现: ```javascript const express = require('express'); const app = express(); app.get('/download', (req, res) => { const filePath = './example.csv'; // 文件路径 res.setHeader('Content-Disposition', `attachment; filename=report.csv`); res.setHeader('Content-Type', 'text/csv'); const fileStream = fs.createReadStream(filePath); fileStream.on('error', () => { res.status(500).send('Error reading the file.'); }); fileStream.pipe(res); // 流式传输文件给客户端 }); app.listen(3000, () => console.log('Server started on port 3000')); ``` 这段代码展示了如何利用Express框架配合Node.js内置模块`fs`读取文件并通过管道机制将其作为附件传递给客户端[^3]。 #### 3. 跨域问题解决 如果前后端分离部署,则可能遇到跨域资源共享(CORS)的问题。此时需确保后端允许来自特定源的预检请求(Preflight Request),并在生产环境下启用HTTPS加密通信以保障安全性[^1]。 --- ### 注意事项 - **性能优化**: 对于大文件下载,应采用分片加载或者增量写入的方式减少内存占用。 - **用户体验**: 提供进度条显示当前下载状态;当网络异常中断时给予提示重试选项。 - **兼容性考量**: 不同浏览器对于某些MIME类型的解析可能存在差异,请提前做好充分测试验证工作。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值