前言
最近开发项目时有个需求是在线预览 PDF 文件,然后百度了好久选出来一个功能比较强大并且好用的插件 PDF.JS,GitHub 下载地址(不知道最近咋了每次都想唠一会水一会)差点忘了说了,本文主要是讲使用过程中的常见错误,嗯,次要是讲咋使用
安装
下载版本的话我们下在稳定版本的就可以了,没必要非追求最新版,当然也可以下载最新版本的,用法都一样,下载好了之后就找一个位置解压就可以了,或者直接放入程序里边,我们主要用到里边的 viewer.js 和 viewer.html 文件
打开文件夹,把这两个文件放进程序,一个是 build,一个是 web 文件夹,不过我建议整个文件夹都放进去!到这差不多安装过程就 ok 了,viewer.html 文件里边有默认的 PDF 文件
测试方法 window.open(' ../pdf/web/viewer.html')
使用
打开我们刚刚放入程序的文件,打开 web 文件目录,打开 viewer.js 文件找到他默认展示的 PDF 文件的路径改为 value:’’ ( 也可以不修改 ) 大概在 4250 行左右,不同的版本可能行数不一样,以实际名称为准 defaultUrl !!!
我们想要调用这个 JS 来预览 PDF 应该咋办呢???方法跟上方测试方法差不多,只不过多加了一个条件
调用方法:windows.open("/pdf/web/viewer.html?file=file.pdf");
这样些其实有一个问题,就是它只能读取你 web 目录下的文件,如果想要读取你本地文件或者服务器文件咋办呢? 当然是通过流的方式输出咯!
获取本地文件 / 服务器文件(移动端预览)
前端写法:通过点击事件触发预览
previewURL: 项目地址路径
filePath: 要打开的项目
encodeURIComponent:用于 url 特殊字符的转译(比如 : ; / ? : @ & = + $ , # 这些用于分隔 URI 组件的标点符号)
// 点击调用预览方法
function xx(filePath){
var previewURL= "127.0.0.1:8080/";
window.open('../pdf/web/viewer.html?file='+encodeURIComponent(previewURL+"/test?url="+filePath));
}
后端写法:拿到文件地址,通过流的方式输出到移动端页面显示
// 通过文件流的方式预览 PDF 文件
@RequestMapping(value = "test")
public void pdfStreamHandeler(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
// 获取路径
String filePath = request.getParameter("url");
File file = new File(filePath);
byte[] data = null;
try {
// 编辑请求头部信息
// 解决请求头跨域问题(IE兼容性 也可使用该方法)
response.setHeader("Access-Control-Allow-Origin", "*");
response.setContentType("application/pdf");
FileInputStream input = new FileInputStream(file);
data = new byte[input.available()];
input.read(data);
response.getOutputStream().write(data);
input.close();
} catch (Exception e) {
}
}
测试界面
常见问题
1.跨域错误:file origin does not match viewer’s
解决方式:找到 viewer.js 中下方的这段代码注释掉,大概在 1793 行附近,
PS:因为每个人的版本不一样,建议使用搜索
2.找不到文件错误:这个问题原因是因为没有获取到你本地或者服务器文件,也就是 pdf > web 目录里没有这个 pdf ,因为它默认是获取这个目录下的 pdf 文件
解决方式:获取本地文件或者服务器文件路径,通过流的方式输出到页面上
3.文件损坏无法显示问题:出现这个问题一般都是你的 url 没有进行转码就直接请求到浏览器了,然后 url 存在的特殊字符会会让浏览器误认为你这个不是一个完整的链接
解决方式:查看前端访问的路径是否使用 encodeURIComponent 转码
番外话题
如何隐藏插件自带的下载和打印功能???打开你的 viewer.html 文件,搜索 <button id="download"
在这个 button 按钮加上一个属性 style="visibility:hidden"
就 ok 了,如下图
我浅薄的记忆中好像还有遇到的别的错误,但我想不起来了,就先记录这些内容,到时候想起来再补充!!!欢迎留言指教