【SpringBoot高级篇】springboot实现上传doc&docx文件格式转pdf在线预览

李熠漾

已于 2023-01-07 21:35:30 修改

阅读量3.1k

点赞数 3

分类专栏： # SpringBoot 文章标签： springboot 文件上传

于 2021-08-20 16:22:33 首次发布

本文链接：https://blog.csdn.net/qq_45297578/article/details/119825464

版权

SpringBoot 专栏收录该内容

84 篇文章 40 订阅

订阅专栏

springboot 实现上传doc&docx文件格式转pdf在线预览

实现效果
pom
controller
service
domain
SpringMvc虚拟路径映射
html
Bug
- 部署到Linux访问失败
- 部署到Linux服务器中doc转pdf失败

实现效果

1、点击上传接口文档
在这里插入图片描述
2、显示上传提示

3、查看项目对应的所有接口文档，点击文档查看接口详情

pom

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--省略其他依赖...........-->

<!--doc,docx转pdf依赖-->
<dependency>
    <groupId>com.documents4j</groupId>
    <artifactId>documents4j-local</artifactId>
    <version>1.1.5</version>
</dependency>
<dependency>
    <groupId>com.documents4j</groupId>
    <artifactId>documents4j-transformer-msoffice-word</artifactId>
    <version>1.1.5</version>
</dependency>

controller

@PostMapping("/project/upload/{id}")
  public ResultVO<?> fileupload(MultipartFile file, HttpServletRequest req,@PathVariable Integer id) throws FileNotFoundException {

      Boolean bool = projectService.uploadInterfaceWord(file, req, id);

      return bool ?  ResultVO.ok("上传成功") : ResultVO.fail("上传失败");
  }

service

主要核心代码和逻辑 : 前端限制只能上传doc,docx,pdf文档格式，后端生成32位uuid为新的文件名，得到文件的扩展名，拼接生成新的文件。保存在当前项目下的upload目录中。然后判断本地生成文件的后缀，如果为pdf后缀，直接把虚拟路径和后缀保存到数据库中，如果为doc后缀或docx，就转换成pdf。在把新的文件虚拟路径和后缀保存到数据库。

/**
 * 上传接口文档
 * @param file
 * @param req
 * @param id
 * @return
 */
@Override
public Boolean uploadInterfaceWord(MultipartFile file, HttpServletRequest req, Integer id) {

    //使用UUID生成唯一标识文件名
    String randomNumber = UUID.randomUUID().toString().replace("-", "");
    //获取文件的原始名
    String oldFilename = file.getOriginalFilename();
    //获取文件后缀 .pdf
    String extension = oldFilename.substring(oldFilename.lastIndexOf("."));
    //生成新的文件名
    String newFileName = randomNumber + extension;
    String property = System.getProperty("user.dir")+"\\upload";

    File dateDir = new File(property);
    if (!dateDir.exists()) {
        //判断目录是否存在，不存在则直接创建
        dateDir.mkdirs();
    }
    try {
        file.transferTo(new File(dateDir, newFileName));
    } catch (IOException e) {
        e.printStackTrace();
        return false;
    }


    // 虚拟路径
    String invented_address = null;

    // 文件后缀,方便前端判断
    String fileSuffix = null;

    if (extension.equals(".pdf")){
        // 上传文件为.pdf后缀的虚拟访问路径
        invented_address  = req.getScheme()+"://"+req.getServerName()+":"+req.getServerPort() + "/api/file/" + newFileName;
        // 添加后缀
        fileSuffix = extension.substring(extension.indexOf(".") + 1);
    }
    // doc docx转pdf在保存地址到数据库中
    else if (extension.equals(".doc") || extension.equals(".docx")) {
        // 转换之后的pdf文件
        String newPdfName = randomNumber+".pdf";
        PdfUtil.doc2Pdf(new File(dateDir, newFileName), new File(dateDir, newPdfName), extension);
        // 转换之后的pdf文件虚拟路径
        invented_address  = req.getScheme()+"://"+req.getServerName()+":"+req.getServerPort() + "/api/file/" + newPdfName;
        // 添加后缀
        fileSuffix = extension.substring(extension.indexOf(".") + 1);
    }

    InterfaceDoc interfaceDoc = new InterfaceDoc();
    interfaceDoc.setProjectId(id);
    interfaceDoc.setUrlAddress(invented_address);
    interfaceDoc.setSuffix(fileSuffix);
    interfaceDoc.setDocName(oldFilename);
    interfaceDocMapper.insert(interfaceDoc);

    return true;
}

domain

@Data
@TableName("tb_interface_doc")
public class InterfaceDoc extends SuperEntity{

    @TableField("url_address")
    private String urlAddress;

    @TableField("doc_name")
    private String docName;

    @TableField("suffix")
    private String suffix;

    @TableField("project_id")
    private Integer projectId;
}

SpringMvc虚拟路径映射

在这里插入图片描述

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Value("${file.staticAccessPath}")
    private String staticAccessPath;

    @Value("${file.uploadFolder}")
    private String uploadFolder;

    /**
     * 虚拟路径映射
     * @param registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        String property = System.getProperty("user.dir")+"\\upload\\";
        //registry.addResourceHandler(staticAccessPath).addResourceLocations("file:"+uploadFolder);
        registry.addResourceHandler(staticAccessPath).addResourceLocations("file:"+property);
    }
}

在这里插入图片描述

html

<!DOCTYPE html>
<html lang="en"  xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>查看接口文档</title>
    <link rel="stylesheet" th:href="@{/component/pear/css/pear.css}" />
</head>
<body class="pear-container">

    <div>
        <div class="layui-row layui-col-space10">
            <div class="layui-col-xs6 layui-col-md3" th:each="item:${InterfaceDocList}">
                <div class="layui-card top-panel">
                    <div class="layui-card-header">[[${item.docName}]]</div>
                    <div class="layui-card-body">
                        <div class="layui-row layui-col-space5">
                            <div class="layui-col-xs8 layui-col-md8 top-panel-number" style="color: #28333E;">
                                <a th:href="@{${item.urlAddress}}" target="_blank">
                                    <img th:src="@{'/admin/images/'+${item.suffix}+'.png'}" alt="查看详情"  style="width: 100px;height: 100px;border-radius: 5px;" />
                                </a>
                            </div>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</body>
<script th:src="@{/component/layui/layui.js}"></script>
<script th:src="@{/component/pear/pear.js}"></script>
</html>

Bug

部署到Linux访问失败

如果部署到linux服务器中，会出现问题，文件上传到了cms\upload/目录下,访问是读取不到的,因为我们的目录为windos的\。
在这里插入图片描述
Linux的目录层级方式/usr/local/cms而windos的目录层级方式F:\springboot\cms,他们的目录斜杠方式相反。

解决: 创建UploadPathUtil 工具类根据不同系统生成不同的目录

@Slf4j
public class UploadPathUtil {
    public static String getSystemRoot() {

        String osName = System.getProperty("os.name");

        // windows目录
        String windowsPath = System.getProperty("user.dir")+"\\upload\\";

        // linux目录
        String linuxPath = System.getProperty("user.dir")+"/upload/";
        log.info("当前系统为: "+osName);

        if (osName.toLowerCase().startsWith("linux")) {
            return linuxPath;
        } else if (osName.toLowerCase().startsWith("windows")) {
            return windowsPath;
        } else {
            throw new RuntimeException("错误目录");
        }
    }

    public static void main(String[] args) {
        String systemRoot = UploadPathUtil.getSystemRoot();
        System.out.println(systemRoot);

    }
}

修改虚拟路径配置类
在这里插入图片描述

修改上传文件目录不存在新建目录逻辑
在这里插入图片描述

部署到Linux服务器中doc转pdf失败

在本机windows转换成功
在这里插入图片描述

打包部署到linux服务器中转换失败
在这里插入图片描述
这里我以为是转换去原因，修改转换器重新打包部署还是报错

IConverter converter = LocalConverter.builder().baseFolder(new File(systemRoot))
                  .workerPool(20,25,1, TimeUnit.SECONDS)
                  .processTimeout(5,TimeUnit.SECONDS)
                  .build();

在这里插入图片描述

无法运行脚本：/usr/local/cms/upload/word_start1775189097.vbs

查找原因https://github.com/documents4j/documents4j/issues/41
在这里插入图片描述
貌似再说使用documents4j获得正确的转换。需要windows服务器（远程API）和一个office安装。

具体解决方案查看我的另一篇文章springboot实现上传doc&docx文件格式转html在线预览v2.0

李熠漾

关注

3
点赞
踩
26

收藏

觉得还不错? 一键收藏
打赏
1
评论
【SpringBoot高级篇】springboot实现上传doc&docx文件格式转pdf在线预览

springboot 实现上传doc&docx文件格式转pdf在线预览实现效果pomcontrollerservicedomainSpringMvc虚拟路径映射html实现效果1、点击上传接口文档2、显示上传提示3、查看项目对应的所有接口文档，点击文档查看接口详情pom<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-
复制链接

扫一扫