文档格式转换--JodConverter

偏执的太偏执、 2022-07-03 21:28 392阅读 0赞

# 功能介绍 #

JodConverter通过OpenOffice实现对各种类型文件的转换，支持的文档类型如下表：

<table> 
 <thead> 
  <tr> 
   <th>源文件格式</th> 
   <th>目标文件格式</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>Text Formats</strong></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>OpenDocument Text (*.odt)</td> 
   <td>Portable Document Format (*.pdf)</td> 
  </tr> 
  <tr> 
   <td>OpenOffice.org 1.0 Text (*.sxw)</td> 
   <td>OpenDocument Text (*.odt)</td> 
  </tr> 
  <tr> 
   <td>Rich Text Format (*.rtf)</td> 
   <td>OpenOffice.org 1.0 Text (*.sxw)</td> 
  </tr> 
  <tr> 
   <td>Microsoft Word (<em>.doc、</em>.docx)</td> 
   <td>Rich Text Format (*.rtf)</td> 
  </tr> 
  <tr> 
   <td>WordPerfect (*.wpd)</td> 
   <td>Microsoft Word (*.doc)</td> 
  </tr> 
  <tr> 
   <td>Plain Text (*.txt)</td> 
   <td>Plain Text (*.txt)</td> 
  </tr> 
  <tr> 
   <td>HTML(*.html)</td> 
   <td>HTML2 (*.html)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>MediaWiki wikitext (*.wiki)</td> 
  </tr> 
  <tr> 
   <td><strong>Spreadsheet Formats</strong></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>OpenDocument Spreadsheet (*.ods)</td> 
   <td>Portable Document Format (*.pdf)</td> 
  </tr> 
  <tr> 
   <td>OpenOffice.org 1.0 Spreadsheet (*.sxc)</td> 
   <td>OpenDocument Spreadsheet (*.ods)</td> 
  </tr> 
  <tr> 
   <td>Microsoft Excel (*.xls)</td> 
   <td>OpenOffice.org 1.0 Spreadsheet (*.sxc)</td> 
  </tr> 
  <tr> 
   <td>Comma-Separated Values (*.csv)</td> 
   <td>Microsoft Excel (*.xls)</td> 
  </tr> 
  <tr> 
   <td>Tab-Separated Values (*.tsv)</td> 
   <td>Comma-Separated Values (*.csv)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>Tab-Separated Values (*.tsv)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>HTML(*.html)</td> 
  </tr> 
  <tr> 
   <td><strong>Presentation Formats</strong></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>OpenDocument Presentation (*.odp)</td> 
   <td>Portable Document Format (*.pdf)</td> 
  </tr> 
  <tr> 
   <td>OpenOffice.org 1.0 Presentation (*.sxi)</td> 
   <td>Macromedia Flash (*.swf)</td> 
  </tr> 
  <tr> 
   <td>Microsoft PowerPoint (*.ppt)</td> 
   <td>OpenDocument Presentation (*.odp)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>OpenOffice.org 1.0 Presentation (*.sxi)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>Microsoft PowerPoint (*.ppt)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>HTML (*.html)</td> 
  </tr> 
  <tr> 
   <td><strong>Drawing Formats</strong></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>OpenDocument Drawing (*.odg)</td> 
   <td>Scalable Vector Graphics (*.svg)</td> 
  </tr> 
  <tr> 
   <td>-</td> 
   <td>Macromedia Flash (*.swf)</td> 
  </tr> 
 </tbody> 
</table>

> 1 源文件格式中的HTML进行转换时可能不像浏览器展示那么准确，只能转换打印友好的网页
> 
> 2 目标文件格式中的HTML可能包含多个文件，其他格式只会产生一个文件

官方网址：[http://www.artofsolving.com/opensource/jodconverter/guide.html][http_www.artofsolving.com_opensource_jodconverter_guide.html]

# 应用案例 #

## 部署OpenOffice ##

使用OpenOffice3版本，安装OpenOffice完成后。在OpenOffice目录下使用以下命令启动OpenOffice，其中port指定了OpenOffice服务的端口，需与开发连接端口一致；nofirststartwizard指定不打开OpenOffice启动窗口，防止OpenOffice无法正常提供服务。

soffice -headless -accept="socket,host=127.0.0.1,port=8100;urp;" -nofirststartwizard

## 代码开发 ##

> 采用JodConverter2.2.2版本开发

OpenOfficeService类用于和OpenOffice建立连接，考虑到JodConverter与OpenOffice建立连接较慢，OpenOfficeService类采用单例模式，提供了start和stop方法用于开启和关闭OpenOffice连接。

import java.io.IOException;
    
    import org.apache.log4j.Logger;
    
    import com.artofsolving.jodconverter.openoffice.connection.OpenOfficeConnection;
    import com.artofsolving.jodconverter.openoffice.connection.SocketOpenOfficeConnection;
    
    /** * ClassName: OpenOfficeService <br> * Description: OpenOffice服务，支持OpenOffice3.*版本,不支持OpenOffice4.*<br> * Create Date: 2017年1月11日 上午9:20:25 <br> * Modified By: <br> * Modified Date: <br> * Modified Content: <br> * Version: 1.0 <br> */
    public class OpenOfficeService { 
    
        Logger log = Logger.getLogger(OpenOfficeService.class);
    
        /** * OpenOffice服务单例 */
        private volatile static OpenOfficeService instance = new OpenOfficeService();
    
        /** * 获取 OpenOffice服务单例<br> * @return OpenOffice服务单例 */
        public static OpenOfficeService getInstance() {
            return instance;
        }
    
        /** * 私有构造函数，通过静态方法getInstance获取实例对象 */
        private OpenOfficeService() {
    
        }
    
        /** * OpenOffice端口 */
        private int OPEN_OFFICE_PORT = 8100;
    
        /** * OpenOffice安装目录 */
        private String Open_Office_HOME = "C:/Program Files (x86)/OpenOffice.org 3/";
    
        /** * OpenOffice连接 */
        private OpenOfficeConnection connection;
    
        /** * 获取 OpenOffice连接<br> * @return connection OpenOffice连接 * @throws IOException */
        public OpenOfficeConnection getConnection() throws IOException {
            if(!isRunning()) {
                start();
            }
            return connection;
        }
    
        /** * OpenOffice进程 */
        private Process openOfficeProcess;
    
        /** * 是否处于运行状态<br> * @return 运行状态 */
        public boolean isRunning() {
            if(connection == null) {
                return false;
            }
            return connection.isConnected();
        }
    
        /** * Description: 启动服务<br> * Create By: XX <br> * Create Date: 2017年1月11日 上午9:27:47 * @return 是否成功 * @throws IOException */
        public void start() throws IOException {
            log.info("开始启动OpenOffice服务");
            /*String command = Open_Office_HOME + "program/soffice.exe -headless -accept=\"socket,host=127.0.0.1,port=" + OPEN_OFFICE_PORT + ";urp;\""; openOfficeProcess = Runtime.getRuntime().exec(command);*/
            log.info("开始连接到OpenOffice服务");
            connection = new SocketOpenOfficeConnection(OPEN_OFFICE_PORT);
            connection.connect();
        }
    
        /** * Description: 停止服务<br> * Create By: XX <br> * Create Date: 2017年1月11日 上午9:29:42 */
        public void stop() {
            log.info("关闭OpenOffice服务");
            if(connection != null && connection.isConnected()) {
                connection.disconnect();
            }
            if(openOfficeProcess != null) {
                openOfficeProcess.destroy();
            }
        }
    
    }

转换文件格式

OpenOfficeConnection connection;
        try {
            connection = OpenOfficeService.getInstance().getConnection();
        } catch (ConnectException e) {
            throw new Exception("无法连接到OpenOffice", e);
        }
        DocumentConverter converter = new OpenOfficeDocumentConverter(connection);
        // sourceFile源文件
        // destFile目标文件
        converter.convert(sourceFile, destFile);

[http_www.artofsolving.com_opensource_jodconverter_guide.html]: http://www.artofsolving.com/opensource/jodconverter/guide.html