• LEADTOOLS 入门教程: 使用 AWS Lambda 转换文档 - C# .NET Core

    LEADTOOLS 是一个综合工具包的集合，用于将识别、文档、医疗、成像和多媒体技术整合到桌面、服务器、平板电脑、网络和移动解决方案中，是一项企业级文档自动化解决方案，有捕捉，OCR，OMR，表单识别和处理，PDF，打印捕获，归档，注释和显示功能。利用业界领先的图像处理技术，能够智能识别文件，可以用来识别任何类型的扫描或传真形式的图像。

    LEADTOOLS 最新下载https://www.evget.com/product/782/download

    本教程展示了如何配置和运行 .NET Core 文档服务。

    概括本教程介绍如何设置 AWS Lambda 以与 LEADTOOLS SDK 一起使用以及如何使用 .NET Core 转换文档。
    完成时间60分钟
    平台下载教程项目 (774 KB)
    IDEVisual Studio 2019、2022、AWS Lambda Visual Studio 扩展
    开发许可证下载 LEADTOOLS

    在学习从 LEADDocument中添加和删除页面 - C# .NET Core 教程之前，通过查看添加引用和设置许可教程来熟悉创建项目的基本步骤。

    完成 Visual Studio 的 AWS 设置；

    要设置开发环境以在 Visual Studio 中使用 AWS，请完成来自 Amazon 的以下 2 个教程：

    完成这些教程后，应安装适用于 Visual Studio 的 AWS 工具包，并基本了解如何为 .NET Core 创建新的 AWS Lambda 项目并发布到 AWS。

    创建一个空函数

    在 Visual Studio 中，创建一个新的AWS Lambda 项目（.NET Core - C#）项目。为项目命名和位置，然后单击创建。

    选择一个空函数并单击确定。

    添加 LEADTOOLS 参考

    所需的参考取决于项目的目的。对于这个项目，需要以下 NuGet 包：

    • Leadtools.Document.Sdk

    在解决方案资源管理器中右键单击 C# 项目，然后选择管理 NuGet 包...。

    浏览LEADTOOLS，然后选择Leadtools.Document.SdkNuGet 包并安装它。接受 LEAD 的最终用户许可协议。

    有关特定格式所需的编解码器 DLL 的完整列表，请参阅文件格式支持。

    添加 LEADRequest.cs 类

    右键单击 C# 项目并选择Add，然后选择Class。为其命名LEADRequest.cs并单击添加。

    将以下内容添加到using块中：

    【C#】

    using Leadtools.Document.Writer;

    【C#】

    public class LEADRequest
{
public string InputUrl { get; set; }
public DocumentFormat DocumentFormat { get; set; }
public LEADRequest()
{
}
}

    添加 LEADLambdaHandler 类

    右键单击 C# 项目并选择Add，然后选择Class。为其命名LEADLambdaHandler.cs并单击添加。

    在新类中，将以下内容添加到using块中：

    【C#】

    using System;
using System.Diagnostics;
using System.IO;
using System.Net.Http;
using Amazon.Lambda.Core;
using Leadtools;
using Leadtools.Document;
using Leadtools.Document.Converter;
using Leadtools.Document.Writer;
using Leadtools.Ocr;

    复制下面的代码以将所需的功能添加到类中：

    【C#】

    public class LEADLambdaHandler
{
// Global Variables
IOcrEngine ocrEngine;
DocumentConverter documentConverter;
static HttpClient httpClient = new HttpClient();

// Constructor which handles all initialization to make sure the function is as fast as possible once it is warmed up
public LEADLambdaHandler()
{
InitEnvironment();

Platform.LibraryPath = "/opt/native-runtimes/";

InitLEADTOOLS();
}

// Method which initializes the Lambda environment for use by the LEADTOOLS SDK
void InitEnvironment()
{
// Set the LD_LIBRARY_PATH in function console to include:
// /var/lang/lib:/lib64:/usr/lib64:/var/runtime:/var/runtime/lib:/var/task:/var/task/lib:/opt/lib:/tmp

ExecuteBashCommand("ln -s /lib64/libdl.so.2 /tmp/libdl.so");
}

// Initialize the LEADTOOLS SDK Classes
void InitLEADTOOLS()
{
SetLicense();

RasterDefaults.TemporaryDirectory = "/tmp";

RasterDefaults.SetResourceDirectory(LEADResourceDirectory.Fonts, "/opt/ShadowFonts");

ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD);
ocrEngine.Startup(null, null, "/tmp", "/opt/OcrLEADRuntime");

documentConverter = new DocumentConverter();
documentConverter.SetOcrEngineInstance(ocrEngine, true);
}

// Helper method for executing shell scripts in the Lambda environment
string ExecuteBashCommand(string command)
{
command = command.Replace("\"", "\"\"");

var proc = new Process
{
StartInfo = new ProcessStartInfo
{
FileName = "/bin/bash",
Arguments = "-c \"" + command + "\"",
UseShellExecute = false,
RedirectStandardOutput = true,
CreateNoWindow = true
}
};

proc.Start();
proc.WaitForExit();

return proc.StandardOutput.ReadToEnd();
}

// Set license code TODO: Replace the licString and developerKey with a valid license and key
void SetLicense()
{
string licString = "[License]\n" + "License = 2.0`ADD LICENSE HERE`";
string developerKey = "ADD DEVELOPMENT KEY HERE";
byte[] licBytes = System.Text.Encoding.UTF8.GetBytes(licString);
RasterSupport.SetLicense(licBytes, developerKey);
}

// Main conversion function
public string ConvertDocument(LEADRequest request, StringWriter sw)
{
var isUrl = Uri.IsWellFormedUriString(request.InputUrl, UriKind.RelativeOrAbsolute);

if (isUrl)
{
var response = httpClient.GetAsync(request.InputUrl).Result;
if (response.IsSuccessStatusCode)
{
var stream = response.Content.ReadAsStreamAsync().Result;

using (var document = DocumentFactory.LoadFromStream(stream, new LoadDocumentOptions()))
{
string ext = DocumentWriter.GetFormatFileExtension(request.DocumentFormat);
string fileName = Path.Combine("/tmp", Path.ChangeExtension(Path.GetFileName(request.InputUrl), ext));
DocumentConverterJobData jobData = DocumentConverterJobs.CreateJobData(document, fileName, request.DocumentFormat);
DocumentConverterJob job = documentConverter.Jobs.CreateJob(jobData);
documentConverter.Jobs.RunJob(job);

if (job.Errors.Count > 0)
foreach (var error in job.Errors)
sw.WriteLine($"Error during conversion: {error.Error.Message} {error.Error.StackTrace}");
else
return fileName;
}
}
else
sw.WriteLine("Download of URL is not successful");
}
else
sw.WriteLine("Url is invalid.");

return null;
}
}

    设置许可文件

    许可证解锁项目所需的功能。它必须在调用任何工具包函数之前设置。有关详细信息，包括针对不同平台的教程，请参阅设置运行时许可证。

    有两种类型的运行时许可证：

    • 评估许可证，在下载评估工具包时获得。它允许评估工具包。
    • 部署许可证。如果需要部署许可证文件和开发人员密钥，请参阅获取许可证。

    笔记

    添加 LEADTOOLS NuGet 和本地引用以及设置许可证在添加引用和设置许可证教程 中有更详细的介绍。

    更新 FunctionHandler

    当触发 AWS Lambda 函数时，将FunctionHandler调用该方法。Function函数首次启动时，将在此之前调用全局类中的所有内容。当容器处于warm状态时，它只会调用该FunctionHandler方法，直到执行上下文发生变化。

    为了利用此功能，大部分初始化代码都在构造函数中完成，以便在容器处于热LEADLambdaHandler状态时尽可能快地调用每个函数。

    打开Function.cs作为项目一部分包含的文件，并将以下内容添加到using其余 using 语句下的块中。

    【C#】

    using System.IO;

    将以下全局变量添加到Function类中：

    【C#】

    public LEADLambdaHandler LEADHandler = new LEADLambdaHandler();

    将该方法替换为FunctionHandler以下方法以接受 aLEADRequest作为输入而不是字符串输入，然后调用该LEADHandler.ConvertDocument方法：

    【C#】

    public string FunctionHandler(LEADRequest request, ILambdaContext context)
{
StringWriter sw = new StringWriter();
try
{
string outputFile = LEADHandler.ConvertDocument(request, sw);

if (outputFile != null)
sw.WriteLine($"Successfully saved to {outputFile}.");
else
sw.WriteLine("Error occurred. Output file not saved.");
}
catch (Exception ex)
{
sw.WriteLine(ex.Message);
sw.WriteLine(ex.StackTrace);
if (ex.InnerException != null)
{
sw.WriteLine(ex.InnerException.Message);
sw.WriteLine(ex.InnerException.StackTrace);
}
}
return sw.ToString();
}

    添加所有代码后，构建项目以确保一切都按预期工作。

    收集所需的 Lambda 依赖项

    笔记

    如果需要，可以跳过此步骤。此项目中包含的 ZIP 已包含所需的 Lambda 依赖项。

    LEADTOOLS SDK 需要在 Linux 机器上安装某些依赖项才能正常运行。有关完整列表，请参阅LEADTOOLS Linux 库和演示项目入门。

    AWS Lambda 提供了一个包含相同 Linux 发行版的 Docker 镜像，以便在部署到 Lambda 之前测试功能。这也可用于安装所需的依赖项并创建部署包。这需要安装Docker Desktop。

    • 打开 Windows PowerShell
    • 跑docker pull amazonlinux
    • 在主机上的某个位置创建本地卷，例如C:\temp\docker
    • 跑docker run -it -v C:\temp\docker:/var/task amazonlinux:latest
    • 使用以下 2 个命令在 VM 中安装 .NET Core 3.1：
      • rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
      • yum -y install dotnet-sdk-3.1
    • 安装 LEADTOOLS 第 3 方依赖项：
      • yum -y install uuid-devel uuidd gcc gcc-c++ glibc-devel kernel-devel kernel-headers libX11 libXt libX11-devel libXt-devel sqlite sqlite-devel freetype fontconfig
    • 发布 Lambda 项目
      • 导航到之前创建的项目的位置
      • 在该位置打开CMDcsproj
      • 跑dotnet publish
    • 导航到发布文件夹并将文件复制\bin\Debug\netcoreapp3.1\publish\runtimes\linux-x64\nativeassets\netcoreapp到C:\temp\docker
    • 在该C:\temp\docker目录中，创建一个新的文本文件并复制并粘贴以下 shell 脚本并将其另存为CopyDeps.sh：
    indir="/var/task/"
outdir="/var/task/lib/"
ldcache=$(ldconfig -p)

mkdir -p $outdir

for i in $(ls ${indir}/*.so); do
deps=$(ldd $i | grep "=>" | grep -v "liblt")

while IFS= read -r line; do
result=""
list=( $line )

dep=$(echo $ldcache | grep "${list[0]}")

if [ ! -z "$dep" ] ; then
cp -vL "${list[2]}" $outdir 2> /dev/null
fi

done <<< "$deps"
done
    • 运行 shell 脚本以创建具有所需依赖项的 lib 文件夹：sh /var/task/CopyDeps.sh
    • shell 脚本完成后，在主机上转到C:\temp\docker\lib这将包含所有依赖项
    • 删除以下内容，因为它们已安装在 Lambda 环境中：
      • liddl.so.2
      • libexpat.so.1
      • libz.so.1

    创建 Lambda 层

    LEADTOOLS SDK 需要在 Lambda 函数中安装环境依赖项。为了保持包的小和灵活，使用了 Lambda 层。有关层是什么的更多信息，请参阅AWS Lambda 层。

    LEADTOOLS SDK OCR 引擎需要依赖项包含在任何 OCR 部署中。有关所需内容的更多信息，请参见LEADTOOLS OCR 模块 - LEAD 引擎运行时文件。

    由于需要 AWS Lambda 环境，因此还需要 Shadow Fonts。有关 Shadow Fonts 的更多信息，请访问LEADTOOLS Drawing Engine and Multi-Platform Consideration。

    • 创建一个名为的新文件夹lead-deps-layer
    • 将lib文件夹从复制C:\temp\docker\lib到lead-deps-layer
    • lead-deps-layer在命名中创建一个新文件夹native-runtimes
    • 发布 Lambda 项目
      • 导航到之前创建的项目的位置
      • 在该位置打开CMDcsproj
      • 跑dotnet publish
    • 转到发布文件夹的 linux 本机依赖项\bin\Debug\netcoreapp3.1\publish\runtimes\linux-x64\nativeassets\netcoreapp\
    • 将所有.so文件复制到lead-deps-layer\native-runtimes文件夹
    • 将C:\temp\docker\lib文件夹复制到lead-deps-layer
    • 将ShadowFonts文件夹从复制\LEADTOOLS22\Bin\Common\ShadowFonts到lead-deps-layer
    • 将OcrLEADRuntime文件夹从复制\LEADTOOLS22\Bin\Common\OcrLEADRuntime到lead-deps-layer
      • 此文件夹包含 LEADTOOLS 支持的各种 OCR 语言的字典和拼写检查引擎。如果只需要某些语言，请删除不需要的语言以最小化文件夹大小。有关语言文件的更多信息，请参见LEADTOOLS OCR 模块 - LEAD 引擎运行时文件
    • 文件夹中现在应该有 4 个子目录lead-deps-layer：lib、native-runtimes、ShadowFonts和OcrLEADRuntime

    • 压缩lead-deps-layer文件夹的内容。确保 ziplead-deps-layer.zip不包含同名的子文件夹，并且 zip 结构类似于以下屏幕截图：

    上传图层 Zip 文件

    创建层 zip 后，需要将其上传到 AWS Lambda。

    • 导航到AWS Lambda 控制台并登录
    • 在左侧面板上，选择图层
    • 在主窗口中，选择创建图层
    • 第一个上传的将是lead-deps-layer
      • 命名图层lead-deps-layer
      • 给它一个描述
      • 点击上传并选择lead-deps-layer.zip
      • 在运行时下拉列表中，选择.NET Core 3.1 (C#/PowerShell)
      • 单击创建以创建图层

    将 Lambda 函数发布到 AWS

    该层完成后，现在可以将函数发布到 AWS。

    • 打开之前在 Visual Studio 中创建的 Lambda 项目。
    • 右键单击项目名称并选择发布到 AWS Lambda
      • 如果这是第一次发布 Lambda，则需要将帐户配置文件与 AWS 的访问密钥一起使用。有关这方面的更多信息，请参阅管理 IAM 用户的访问密钥
    • 选择要使用的帐户资料和地区
    • 确保语言运行时设置为.NET Core v3.1
    • 填写Function Name，点击Next
    • 将内存 (MB)更改为 2048
    • 从下拉列表中选择角色名称，然后单击上传

    这将dotnet publish在项目上运行，然后压缩文件和依赖项并将其上传到 Lambda。

    减小封装尺寸

    在上一步中创建的包会很大，因为它包含许多添加到层的依赖项。为了减小体积，zip 包将需要修改并手动上传到 Lambda。

    • 进入\bin\Release\netcoreapp3.1\publish目录
    • 删除LEADTOOLS包含已添加到的 OCRRuntimes 的文件夹lead-deps-layer
    • .zip将发布目录的内容压缩到一个名为覆盖自动创建的 zip 文件中
    • 导航回AWS Lambda 控制台并登录
    • 在左侧面板上，选择功能
    • 选择打开功能
    • 在函数的配置中，在函数代码部分下，选择上传以上传缩小尺寸的 zip
    • 从中选择 zip \bin\Release\netcoreapp3.1\publish\.zip，点击确定，然后点击右上角的保存

    这将更新功能包，使其尽可能小。

    更改设置

    上传包后，LD_LIBRARY_PATH需要更新函数的环境变量以正确加载依赖项。

    • 在控制台的功能页面中，向下滚动到环境变量部分
    • 单击管理环境变量以打开编辑环境变量屏幕
    • 点击添加环境变量
    • 对于键，输入LD_LIBRARY_PATH和值输入 
    • /var/lang/lib:/lib64:/usr/lib64:/var/runtime:/var/runtime/lib:/var/task:/var/task/lib:/opt/lib:/tmp
    • 单击保存以保存这些更改

    设置环境变量后，需要将层添加到函数中。

    • 在控制台的功能页面，展开Designer
    • 选择图层
    • 在底部现在打开的图层部分中，选择添加图层
    • 选择从运行时兼容层列表中选择单选按钮
    • 在名称下拉列表中，选择lead-deps-layer
    • 在版本下拉列表中，选择最新的版本号

    • 单击添加将此图层添加到函数中

    确保函数的内存设置为 2048 MB：

    • 在控制台的功能页面中，向下滚动到基本设置部分
    • 单击编辑
    • 将内存 (MB)滑块拖动到2048 MB

    • 单击保存以保存更改

    测试功能

    完成上一步后，该功能就可以进行测试了。

    • 在控制台的功能页面，选择右上角的 测试
      • 这将打开配置测试事件对话框
    • 选择hello-world 活动模板
    • 填写活动名称
    {
"InputUrl": "https://demo.leadtools.com/images/tiff/ocr1.tif",
"DocumentFormat": 1
}
    • 单击创建以创建测试事件

    如果一切设置正确，执行结果应该返回succeeded并类似于：

    以上便是 使用 AWS Lambda 转换文档 ，如果您还有其他疑问，欢迎咨询我们或者加入我们官方技术交流群。

  • 相关阅读:
    SolidWork的使用技巧总结
    【音视频-FFMPEG相关命令使用】
    MYSQL字符串函数详解和实战(字符串函数大全,内含示例)
    页面优化技术
    6、Selector
    十年磨一剑，剑指IT技术之巅，WOT 全球技术创新大会 2022盛大开启
    西瓜书重温(七): 贝叶斯分类器(手推+代码demo)
    Web版RSS阅读器yarr
    基于工业智能网关的PLC远程控制解决方案
    畅享高性能计算！天翼云HPC解决方案来了
  • 原文地址：https://blog.csdn.net/m0_67129275/article/details/127865290