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

于 2022-11-15 14:27:50 发布
阅读量651 收藏 2
点赞数
分类专栏： Leadtools系列教程 文章标签： c# aws .netcore leadtools
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/m0_67129275/article/details/127865290
版权

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 = <doc><ver>2.0</ver>`ADD LICENSE HERE`</doc>";
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
  • 导航到发布文件夹并将文件复制<PROJECT-DIR>\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 本机依赖项<PROJECT-DIR>\bin\Debug\netcoreapp3.1\publish\runtimes\linux-x64\nativeassets\netcoreapp\
  • 将所有.so文件复制到lead-deps-layer\native-runtimes文件夹
  • 将C:\temp\docker\lib文件夹复制到lead-deps-layer
  • 将ShadowFonts文件夹从复制<INSTALL_DIR>\LEADTOOLS22\Bin\Common\ShadowFonts到lead-deps-layer
  • 将OcrLEADRuntime文件夹从复制<INSTALL_DIR>\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。

  • 进入<PROJECT-DIR>\bin\Release\netcoreapp3.1\publish目录
  • 删除LEADTOOLS包含已添加到的 OCRRuntimes 的文件夹lead-deps-layer
  • <function-name>.zip将发布目录的内容压缩到一个名为覆盖自动创建的 zip 文件中
  • 导航回AWS Lambda 控制台并登录
  • 在左侧面板上，选择功能
  • 选择<function-name>打开功能
  • 在函数的配置中，在函数代码部分下，选择上传以上传缩小尺寸的 zip
  • 从中选择 zip <PROJECT-DIR>\bin\Release\netcoreapp3.1\publish\<function-name>.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 转换文档 ，如果您还有其他疑问，欢迎咨询我们或者加入我们官方技术交流群。

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值