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

2023-12-29 13:17:57

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

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

? ??FastReport .net下载(qun:585577353)icon-default.png?t=N7T8https://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

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

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

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

文章来源:https://blog.csdn.net/m0_67129275/article/details/135285280
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。