nodejs:express + js-mdict 网页查询英汉词典,能播放.spx 声音
向 DeepSeek R1 提问:
我想写一个Web 前端网页,后台用 nodejs + js-mdict , 实现在线查询英语单词,并能播放.spx 声音文件
1. 项目结构
首先,创建一个项目目录,结构如下:
mydict-app/
├── public/
│ ├── index.html
│ ├── styles.css
│ └── script.js
├── server/
│ └── server.js
├── package.json
└── README.md
英汉词典文件(*.mdx , *.mdd) 已经放在 /js/testdict/
2. 安装依赖
在项目根目录下运行以下命令,初始化项目并安装所需的依赖:
cd mydict-app
npm init -y
npm install express
added 69 packages in 6s
npm install js-mdict
added 3 packages in 2s
3. 创建前端页面
在 public/index1.htm
中创建一个简单的HTML页面,包含一个输入框和三个按钮用于查询单词:
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="ie=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>查询英汉词典 spx</title><script src="jquery.js"></script> <style>
/* portrait 判断为竖屏 */
@media only screen and (orientation: portrait){#lab1 {display:none;}
}
/* landscape 判断为横屏 */
@media only screen and (orientation: landscape){#lab1 {display: ;}
} </style>
</head>
<body><form name="form" id="form" action="search" method="GET" target="iframe"><label id="lab1">请输入:</label><input type="text" name="word" id="word" size="30" placeholder="请输入英文单词"><input type="submit" name="eng_han" value="英译汉"><input type="button" name="btn1" id="btn1" value="前缀查询"><input type="button" name="btn2" id="btn2" value="模糊查询"></form><p></p>
<div style="float:left; width:100%;"><div id="result" style="float:left; width:75%; height:400; border:2px;"><iframe name="iframe" id="iframe" width="100%" height="400"> </iframe></div><div id="alist" style="float:right; width:25%; height:400; border:2px;"></div>
</div><script src="bitstring.min.js"></script>
<script src="pcmdata.min.js"></script>
<script src="speex.js"></script>
<script src="script1.js"></script>
</body>
</html>
在 public
中添加一些英汉字典的样式:uk_pron.png, us_pron.png,
copy jquery-3.2.1.min.js pulibc\jquery.js
speex.js 下载网址:speex.js 是Web前端网页播放.spx声音文件所需的解码器
在 public/script1.js
中编写前端逻辑:
// decode Speex from mdict-js
/** * @param bufSpx ArrayBuffer (Uint8Array) holding content of speex file (*.spx or *.ogg) */ function decodeSpx(bufSpx) { var stream, samples, st; var ogg, header, err; ogg = new Ogg(bufSpx, {file: true}); ogg.demux(); stream = ogg.bitstream(); header = Speex.parseHeader(ogg.frames[0]); console.log(header); comment = new SpeexComment(ogg.frames[1]); console.log(comment.data); st = new Speex({ quality: 8, mode: header.mode, rate: header.rate }); samples = st.decode(stream, ogg.segments); var waveData = PCMData.encode({ sampleRate: header.rate, channelCount: header.nb_channels, bytesPerSample: 2, data: samples }); // array buffer holding audio data in wav codec var bufWav = Speex.util.str2ab(waveData); // convert to a blob object var blob = new Blob([bufWav], {type: "audio/wav"}); // return a "blob://" url which can be used as a href anywhere return URL.createObjectURL(blob); }const iframe = $('#iframe')[0]; // 获取 iframe DOM 元素const iframeDoc = iframe.contentDocument || iframe.contentWindow.document;
// 页面加载添加:监听iframe网页点击事件 $(document).ready(function(){var listener = window.addEventListener('blur', function(){if (document.activeElement === document.getElementById('iframe')){$('iframe').contents().find('a').click(function(event){event.preventDefault();var a = $(this);if (a){var addr = a.attr('href');if (addr.indexOf('entry://')==0 && addr.indexOf('entry://#')!=0){ var word = encodeURIComponent(addr.substring(8));$.ajax({url: `/search?word=${word}`,method: 'GET',success: function (html) {// 将 HTML 内容加载到 iframe 中//$('#iframe').attr('srcdoc', html);if (html){// 写入 HTML 内容iframeDoc.open();iframeDoc.write(html);iframeDoc.close();}},error: function (error) {console.error('entry:请求失败:', error);}});} else if (addr.indexOf('sound://')==0){var url = "/data/" + addr.substring(8);fetch(url).then(response => response.arrayBuffer()).then(arrayBuffer => {// 将 ArrayBuffer 转换为 Uint8Arrayconst uint8Array = new Uint8Array(arrayBuffer); try {// 解码.spx 数据后变为.wavvar blobUrl = decodeSpx(String.fromCharCode.apply(null, uint8Array));// 创建 Audio 并播放音频var audio = new Audio(blobUrl);audio.addEventListener("canplaythrough", (event)=> {audio.play();});audio.addEventListener('error', (e) => {console.error('play error:', e);});} catch (error) {console.error('Error decoding spx data', error);}}).catch(error => {console.error('Error loading spx file', error);});}}})};});
});// 前缀查询
$(function(){$("#btn1").click(function(){$.getJSON("/prefix?word="+$("#word").val(), function(data){var items = [];$.each(data, function(i, item){if (i<=20){items[i] = '<a href="/search?word=' +item+ '" target="iframe">' +item+ "</a><br>";}});var a = items.join('\n');if (a) $('#alist').html(a);})})
});// 模糊查询
$(function(){$("#btn2").click(function(){$.getJSON("/fuzzy?word="+$("#word").val(), function(data){var items = [];$.each(data, function(i, item){if (i<=20){items[i] = '<a href="/search?word=' +item+ '" target="iframe">' +item+ "</a><br>";}});var a = items.join('\n');if (a) $('#alist').html(a);})})
});
4. 创建后端服务器
在 server/server.js
中编写Node.js服务器代码,使用 express
和 js-mdict
来处理查询请求:
如何直接读取.MDD文件中的.spx 音频数据,编写了升级版 server_spx
.js 如下
const express = require('express');
const fs = require('fs');
const path = require('path');
const Mdict = require('js-mdict');
//console.log(Mdict);
const app = express();
const port = 8003;// 加载MDict词典文件
//const mdict = new Mdict('path/to/your/dictionary.mdx');
const mdx = new Mdict.MDX('/js/testdict/your.mdx');
const mdd = new Mdict.MDD('/js/testdict/your.mdd');
//console.log(mdd.locate('\\goods'));
app.use(express.json());
app.use(express.urlencoded({ extended: false }));
// 提供静态文件
app.use(express.static(path.join(__dirname, '../public')));const isWord = (txt) => {// 只允许字母、/、空格、-return /^[a-zA-Z \/\-]+$/.test(txt);
};// 处理查询请求
app.get('/search', (req, res) => {let word = req.query.word;// 检查word是否合法if (word.length>50 || !isWord(word)) {return res.status(400).send('Invalid input.');}if (word) {let data = mdx.lookup(word);console.log("cha: "+ word);if(data.definition){res.send(data.definition);} else {res.status(400).send('this word not found');}} else {res.status(400).send('error: No word input');}
});// 处理前缀查询请求
app.get('/prefix', (req, res) => {let word = req.query.word;// 检查word是否合法if (word.length>50 || !isWord(word)) {return res.status(400).send('Invalid input.');}if (word) {let alist = mdx.prefix(word);console.log("pre: "+ word);if(alist){let wordls = [];alist.forEach(function(value){wordls.push(value.keyText);}); res.json(wordls);} else {res.status(400).send('info: this word not found');}} else {res.status(400).send('error: No word input');}
});// 处理模糊查询请求
app.get('/fuzzy', (req, res) => {let word = req.query.word;// 检查word是否合法if (word.length>50 || !isWord(word)) {return res.status(400).send('Invalid input.');}if (word) {let alist = mdx.fuzzy_search(word,3,1);console.log("fuzzy: "+ word);if(alist){let wordls = [];alist.forEach(function(value){wordls.push(value.keyText);}); res.json(wordls);} else {res.status(400).send('info: this word not found');}} else {res.status(400).send('error: No word input');}
});// 指定目录
const dir1 = "\\";// 实现文件下载,*/是路径
app.get('/data/*/:fileName', (req, res, next) => {let path1 = req.params[0]; // 捕获 * 匹配的部分let fileName = req.params.fileName; // 捕获文件名// 检查路径中是否包含非法字符(如 ..)if (path1.includes('..') || fileName.includes('..')) {return res.status(400).send('Invalid path: Path traversal is not allowed.');}if (path.extname(fileName) === '.spx'){let filePath = path.join(dir1,path1, fileName);//console.log(filePath);let data = mdd.locate(filePath);if (data){console.log('key: '+ data.keyText);//console.log(Buffer.isBuffer(data.definition));if (data.definition){let binaryData = Buffer.from(data.definition, 'base64');//res.setHeader('Content-Type', 'application/octet-stream');res.set({'Content-Type': 'audio/ogg','Content-Disposition': 'attachment;','Content-Length': Buffer.byteLength(binaryData)});//console.log('bytes: '+ Buffer.byteLength(binaryData));res.end(binaryData);} else {res.status(400).send('error: data.definition is null');}} else {res.status(400).send('error: data is null');}} else {res.status(400).send('filename.ext is not .spx');}
});app.listen(port, () => {console.log(`Server is running on http://localhost:${port}`);
});
5. 运行项目
在项目根目录下运行以下命令启动服务器:node server/server_spx
.js
然后打开浏览器,访问 http://localhost:8003/index1.htm
,你应该可以看到一个简单的词典查询页面。输入单词并点击查询按钮,页面会显示该单词的释义。
6. 部署
你可以将这个应用部署到任何支持 Node.js 的服务器上。
7. 进一步优化
-
错误处理:在前端和后端添加更多的错误处理逻辑。
-
UI 改进:可以进一步美化前端页面,添加加载动画等。
-
安全性:在生产环境中,确保对用户输入进行验证和清理,防止 XSS 等攻击。
8. 总结
通过以上步骤,你可以实现一个简单的在线英语词典查询系统,并且能够播放 .spx
格式的音频文件。你可以根据需求进一步扩展功能,比如添加更多的词典、支持更多格式的音频文件等。