.NET Core 使用 LibreOffice 實現 Office 預覽（Docker 部署）

作者：不止dotNET 2022-08-29 07:05:30

開發架構

目前在做的零代碼產品中的表單附件控件，同樣面臨著 Office 文件預覽的問題，現在技術棧采用了 .NET Core ，并使用容器化部署，自然就拋棄了 OWA 的方案。

前些年做云盤產品的時候，一個很核心的功能就是 Office 文件預覽，當時還沒有使用 .NET Core ,程序部署在 Windows Server 服務器上，文件預覽的方案采用了微軟的 OWA 。

本文簡單介紹下 OWA 的替代方案。

思路

在表單的附件控件上傳 Office 文件后，存儲到 MongoDB 中，并發消息給文件轉換程序。
文件轉換程序從 MongoDB 獲取 Office 文件，通過 Libreoffice 轉換為 PDF 文件。
將 PDF 文件存儲到 MongoDB 中，并將 PDF 文件在 MongoDB 中的 FileID 存儲到平臺和原始文件進行關聯。
在表單中點擊文件預覽時使用關聯的 PDF 的文件 ID 從 MongoDB 中獲取 PDF 文件進行展示。

準備

1、創建一個 .NET Core 的控制臺程序用來做文件的轉換。

2、下載 Libreoffice 安裝包、Libreoffice 中文語言包、jdk1.8 安裝包、中文字體包。

3、搭建一臺 centos 虛擬機，并準備好 docker 環境。

版本

.NET Core：3.1
CentOS：7.6
Docker：
Liberoffice：7.3.5
RabbitMQ：3.8.2
MongoDB：5.0

開始

編寫控制臺程序進行文件轉換

1、創建一個名為 OfficeToPdf 的 .NET Core 控制臺程序，在 Main 方法中對消息隊列進行監聽。

static void Main(string[] args)  
{  
    try  
    {  
        var mqManager = new MQManager(new MQConfig  
        {  
            AutomaticRecoveryEnabled = true,  
            HeartBeat = 60,  
            NetworkRecoveryInterval = new TimeSpan(60),  
            Host = EnvironmentHelper.GetEnvValue("MQHostName"),  
            UserName = EnvironmentHelper.GetEnvValue("MQUserName"),  
            Password = EnvironmentHelper.GetEnvValue("MQPassword"),  
            Port = EnvironmentHelper.GetEnvValue("MQPort")  
        });        
        if (mqManager.Connected)  
        {            
         _logger.Log(LogLevel.Info, "RabbitMQ連接成功。");  
            _logger.Log(LogLevel.Info, "RabbitMQ消息接收中...");  
  
            mqManager.Subscribe<PowerPointConvertMessage>(Convert);  
            mqManager.Subscribe<WordConvertMessage>(Convert);  
            mqManager.Subscribe<ExcelConvertMessage>(Convert);  
        }        
        else  
        {  
            _logger.Warn("RabbitMQ連接初始化失敗,請檢查連接。");  
            Console.ReadLine();  
        }    
    }catch(Exception ex)  
    {        
     _logger.Error(ex.Message);  
    }
}

2、在 Convert 方法中對消息進行處理，首先根據消息的中的文件 ID 獲取文件：

Stream sourceStream = fileOperation.GetFile(officeMessage.FileInfo.FileId);  
if(sourceStream == null)  
{  
    logger.Log(LogLevel.Error, $"文件ID：{officeMessage.FileInfo.FileId}，不存在");  
}   
string filename = officeMessage.FileInfo.FileId;  
string extension = System.IO.Path.GetExtension(officeMessage.FileInfo.FileName);    
sourcePath = System.IO.Path.Combine(Directory.GetCurrentDirectory(), filename + extension);  
destPath = System.IO.Path.Combine(Directory.GetCurrentDirectory(), string.Format("{0}.pdf", filename));  
logger.Log(LogLevel.Info, $"文件原路徑：{sourcePath}");  
logger.Log(LogLevel.Info, $"文件目標路徑：{destPath}");  
if (extension != null && (extension.Equals(".xlsx",StringComparison.OrdinalIgnoreCase) ||   
                          extension.Equals(".xls", StringComparison.OrdinalIgnoreCase)))  
{  
    if (!SetExcelScale(sourceStream, sourcePath))  
        return false;  
}  
else  
{  
    byte[] sourceBuffer = new Byte[sourceStream.Length];  
    sourceStream.Read(sourceBuffer, 0, sourceBuffer.Length);  
    sourceStream.Seek(0, SeekOrigin.Begin);  
    if (!SaveToFile(sourceBuffer, sourcePath))  
        return false;  
}

3、啟用 LibreOffice 進行文件轉換：

var psi = new ProcessStartInfo(  
        "libreoffice7.3",  
        string.Format("--invisible --convert-to pdf  {0}", filename + extension))  
    {RedirectStandardOutput = true};    
// 啟動  
var proc = Process.Start(psi);  
if (proc == null)  
{  
    logger.Error("請檢查 LibreOffice 是否成功安裝.");  
    return false;  
}   
logger.Log(LogLevel.Info, "文件轉換開始......");  
using (var sr = proc.StandardOutput)  
{  
    while (!sr.EndOfStream)  
    {        Console.WriteLine(sr.ReadLine());  
    }    if (!proc.HasExited)  
    {        proc.Kill();  
    }}  
  
logger.Log(LogLevel.Info, "文件轉成完成");

4、文件轉換成功后，存儲轉換后的 PDF 文件到 MongoDB，然后和原始文件進行關聯，下面代碼是調用了零代碼平臺中的接口進行處理，這里可以根據自己的業務需求自行修改 :

string host = EnvironmentHelper.GetEnvValue("ApiHost");  
string api = EnvironmentHelper.GetEnvValue("AssociationApi");  
if (string.IsNullOrEmpty(api))  
{  
    logger.Warn("請檢查 AssociationApi 環境變量的配置");  
    return false;  
}  
if (string.IsNullOrEmpty(host))  
{  
    logger.Warn("請檢查 ApiHost 環境變量的配置");  
    return false;  
}  
string result = APIHelper.RunApiGet(host, $"{api}/{fileId}/{destFileId}");

構建 Libreoffice 基礎鏡像

1、在 centos 服務器上 /data 目錄中創建目錄 liberoffice-docker-build ,將上面提到的 Libreoffice 安裝包、Libreoffice 中文語言包、jdk1.8 安裝包、中文字體包拷貝到該目錄中。

2、在該目錄中創建 Dockerfile 文件，內容如下：

RUN yum update -y && \
        yum reinstall -y glibc-common && \
        yum install -y telnet net-tools && \
        yum clean all && \
        rm -rf /tmp/* rm -rf /var/cache/yum/* && \
        localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8 && \
        ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
#加入windows字體包
ADD chinese.tar.gz /usr/share/fonts/
ADD LibreOffice_7.3.5_Linux_x86-64_rpm.tar.gz /home/
ADD LibreOffice_7.3.5_Linux_x86-64_rpm_langpack_zh-CN.tar.gz /usr/
#執行安裝
RUN cd /home/LibreOffice_7.3.5.2_Linux_x86-64_rpm/RPMS/ \
        && yum localinstall *.rpm -y \
        && cd /usr/LibreOffice_7.3.5.2_Linux_x86-64_rpm_langpack_zh-CN/RPMS/   \
        && yum localinstall *.rpm -y \
        #安裝依賴
        && yum install ibus -y \
        #加入中文字體支持并賦權限
        && cd /usr/share/fonts/ \
        && chmod -R 755 /usr/share/fonts \
        && yum install mkfontscale -y \
        && mkfontscale \
        && yum install fontconfig -y \
        && mkfontdir \
        && fc-cache -fv \
        && mkdir /usr/local/java/ \
        #清理緩存,減少鏡像大小
        && yum clean all
#安裝java環境
ADD jdk-8u341-linux-x64.tar.gz /usr/local/java/
RUN ln -s /usr/local/java/jdk1.8.0_314 /usr/local/java/jdk
#配置環境變量
ENV JAVA_HOME /usr/local/java/jdk
ENV JRE_HOME ${JAVA_HOME}/jre
ENV CLASSPATH .:${JAVA_HOME}/lib:${JRE_HOME}/lib
ENV PATH ${JAVA_HOME}/bin:$PATH
#安裝 dotnet core 3.1 運行環境
RUN rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm \
    && yum install -y  aspnetcore-runtime-3.1 \
    && yum clean all
WORKDIR /usr
EXPOSE 80
CMD /bin/bash

3、執行命令 docker build -t libreofficebase:v1.0 . 進行基礎鏡像的構建，構建好的基礎鏡像供文件預覽鏡像構建時使用。

構建文件預覽鏡像

1、在 centos 服務器的 /data 目錄中創建目錄 doc-preview-docker-build 。

2、將轉換程序 OfficeToPdf 進行編譯發布，將發布后的文件拷貝到目錄 doc-preview-docker-build 中。

3、在該目錄中創建 Dockerfile 文件，內容如下：

FROM libreofficebase:v1 #此處的鏡像就是上面構建的 Libreoffice 基礎鏡像
COPY . /app
WORKDIR /app
EXPOSE 80/tcp
ENTRYPOINT ["dotnet", "OfficeToPdf.dll"]

4、執行命令 docker build -t office-preview:v1.0 . 進行預覽鏡像的構建。

運行預覽容器

執行下面命令進行容器的創建：

docker run -d --name office-preview office-preview

最后

Office 預覽肯定有很多種方案，上面只是目前找到的一種可行的方法。

責任編輯：姜華來源：今日頭條

零代碼產品 .NET Core