报表控件FastReport VCL 中的新 S3 传输 (Amazon)

在本文中，我们将探讨新的 S3 传输。从功能上来说，S3 与大多数人习惯使用的有很大不同，因此在本文的开头，我们将详细介绍它的主要功能。

FastReport .NET?是适用于.NET Core 3，ASP.NET，MVC和Windows窗体的全功能报告库。使用FastReport .NET，您可以创建独立于应用程序的.NET报告。

? ??FastReport .net下载（qun：585577353）https://www.evget.com/product/1861/download

它是什么？

S3 不是像 Dropbox、Google Drive、Mega 等那样的文件存储。S3是对象存储。首先，我们需要了解这两个概念之间的区别。

文件存储具有通常的分层（树）结构。即存储其他目录和文件的熟悉的目录（文件夹）。

对象存储相对较新（最古老的现在大约有 20 年历史）。它们的实现略有不同，因此大多数功能都是通用的，但有些功能仅适用于 S3。

所有对象存储都是“扁平的”，这意味着它们没有层次结构，尽管它们可以“模仿”它。

开始使用 S3 时您将遇到的第一个实体是 Bucket。最接近的类比是许多编程语言中的“Map”，其中通过键请求数据。一个桶只能存放自己的文件，不能存放其他桶的文件。

关于bucket

Bucket
Key	Data
video.mp4	Data
text_file.txt	Data
code.pas	Data

使用该密钥，您可以获得与其对应的元数据，并根据需要自行解释。更有趣的是在这样的系统中模仿分层文件夹结构。

Bucket
Key	Data
video.mp4	Data
folder1\text_file.txt	Data
folder1\video.mp4	Data
folder1\folder1_1\video.mp4	Data
folder2\text_file.txt	Data
folder1\	Empty
folder1\folder1_1\	Empty
folder2\	Empty

某些“文件夹”与文件是相同的对象。它们只是为了视觉清晰度而采用不同的颜色。然而，它们有一个显着特征——键末尾有一个斜杠 (\)。通常，这些“文件夹”不包含任何数据（尽管它们可以）。

要查看“文件夹”folder1 的内容，我们需要按键前缀“folder1\”进行过滤。但更有趣的是删除“文件夹”。如果我们尝试在 Web GUI 中删除“文件夹”folder1，某些服务会允许这样做，但其他服务会向我们显示错误“无法删除非空文件夹”。

如果我们通过 API 删除带有键“folder1\”的单个记录，大多数 GUI 将停止渲染该特定“文件夹”。我们也将无法访问它，但实际上，该“文件夹”内的文件仍然存在。一旦我们再次创建一个名为folder1的“文件夹”，它就已经包含了被遗忘的文件。该密钥几乎没有限制，例如，它可以是“”之类的内容。这些将是名称为空的“文件夹”。

为什么对象存储比文件存储更好？

1. 对象存储要便宜得多。每个对象不绑定到特定设备，因此对象存储可以轻松扩展到所需的容量。您可以轻松租用 PB（约 1,000,000 GB）的对象存储。

2. 对象存储的搜索速度非常快。但自然地，对象存储最适合用于非结构化（非树）数据。

新的认证系统

之前的所有传输均使用 OAuth 2 协议。理论上，S3 也可以与 OAuth 2 配合使用，但它的 API 中有内置的身份验证系统。OAuth 2 使用客户端 ID 和秘密 ID 获取存在一定时间并且可以签署任何请求的令牌。

S3 的内部身份验证使用相同的 Client ID 和 Secret ID，基于大约 30 个变量（包括令牌创建时间、所需操作等），使用 SHA256HMAC 为每个操作生成新的一次性令牌。服务器仅验证令牌的正确生成，如果服务器接收到的令牌与服务器本身生成的令牌匹配，则执行操作。此后，该令牌将无法再使用。

AWS S3

尽管该传输被命名为“TfrxS3IOTransport”，明确引用了AWS S3（Amazon Simple Storage Service），但它的API已被许多对象存储系统（可以宽松地称为类S3）复制，因此该传输允许您工作不仅有亚马逊的服务。

向应用程序及其配置添加传输

首先，您需要从“FastReport VCL Internet Transports”选项卡添加适当的组件。

您可以使用组件上的上下文菜单。它将直接从开发环境建立连接。单击“编辑连接”子菜单。

S3 连接对话框

当您需要使用传输打开或保存到文件时，将可以使用以下标准授权对话框（如果之前没有授权）。

让我们看看这个表单的所有独特字段：

服务器 URL?— API 中使用的 URL。要找到 URL，您需要阅读文档；对于 AWS S3，默认情况下应为“s3.amazonaws.com”。

客户端 ID?— 用于授权的公钥（通常称为访问密钥）。

秘密 ID?— 用于授权的秘密密钥（通常称为秘密访问密钥）。

区域- 您需要阅读文档以了解可能的区域值。有时，会有不寻常的要求：例如，在AWS S3中，您只能请求具有“us-east-1”区域的存储桶列表。

Bucket——为了不用每次都手动选择Bucket，可以在此字段指定；有时桶具有特定区域的特征。

存储桶样式— 指定存储桶有 2 种类型：路径样式 (aws.s3.com/bucket?)和虚拟托管样式 (?bucket.aws.s3.com。“路径样式”被认为已过时，因为通过特定的 DNS，可以向不同的存储桶发出多个请求，这可能会产生额外的负载。有些服务支持两种类型，有些只支持一种，有些可以针对不同的情况进行配置。?您可以在以下链接中了解这一点。

如果连接成功，您将看到标准的FastReport VCL文件浏览器（下面的屏幕截图显示了存储桶内的文件列表）。

这样就成功完成了连接设置。现在您知道如何在 FastReport VCL 中连接到 S3。

只需要注意我们实施的最后细微差别即可。我们团队还没有实现创建和删除桶。到目前为止，存储桶在视觉上与文件夹（在我们的第一个 GUI 版本中）没有什么不同，因为它风险太大。此外，删除文件夹及其内容尚未实现。此外，缺少分段上传大文件的功能（建议大于 100 MB 的文件）。

这种传输有许多配置细节和细微差别，但在某些情况下它可以是文件存储的替代方案。