UnpackContent

UnpackContent Processor

类型全限定名：cn.org.acal.lynxus.processors.standard.UnpackContent

所属 Bundle：cn.org.acal.lynxus:lynxus-standard-nar:2.11.8

描述

解压已使用几种不同打包格式之一打包的 FlowFiles 的内容，为每个输入 FlowFile 发出一对多 FlowFiles。支持的格式包括 TAR、ZIP 和 FlowFile Stream 包。

使用场景

解包包含特殊字符文件名的 Zip，该文件在 Windows 上使用文件名编码 'Cp437' 或 'IBM437' 创建。

将 "Packaging Format" 值设置为 "zip" 或 "use mime.type attribute"。
将 "Filename Character Set" 值设置为 "Cp437" 或 "IBM437"。

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
Packaging Format	`use mime.type attribute`	use mime.type attribute tar zip flowfile-stream-v3 flowfile-stream-v2 flowfile-tar-v1	用于创建文件的打包格式
Filename Character Set	`UTF-8`		如果提供，此字符集将提供给 Zip 工具，以尝试使用特定字符集解码文件名。如果未指定，将使用默认的平台字符集。当 Zip 文件是使用与平台默认值不同的字符集创建且 Zip 使用非标准值来指定时，这很有用。
File Filter	`.*`		仅提取存档中名称与给定正则表达式匹配的文件（仅限 tar/zip）
Password			用于解密使用 ZipCrypto 或 AES 加密的 Zip 档案的密码。配置密码会禁用对替代 Zip 压缩算法的支持。敏感属性：是
Allow Stored Entries With Data Descriptor	`false`	true false	某些 Zip 归档包含带有数据描述符的存储条目，按规范这不应该发生。如果此属性为 true，它们仍然会被读取。如果为 false 且发现此类条目，则 Zip 将无法处理。

关系 (Relationships)

名称	描述	自动终止
`failure`	当由于某种原因无法解包时，将原始 FlowFile 发送到此关系	否
`original`	原始FlowFile在成功解包后发送到该关系	否
`success`	解压的 FlowFiles 被发送到此关系	否

读取的 FlowFile 属性

名称描述

mime.type 如果 <Packaging Format> 属性设置为使用 mime.type 属性，则此属性用于确定 FlowFile 的 MIME 类型。在这种情况下，如果属性设置为 application/tar，将使用 TAR 打包格式。如果属性设置为 application/zip，将使用 ZIP 打包格式。如果属性设置为 application/flowfile-v3 或 application/flowfile-v2 或 application/flowfile-v1，将使用相应的 FlowFile 打包格式。如果此属性缺失，FlowFile 将路由到 'failure'。否则，如果属性的值不是上述值之一，FlowFile 将路由到 'success' 而不被解包。使用 File Filter 属性仅提取匹配特定正则表达式的文件。

名称	描述
`mime.type`	如果 <Packaging Format> 属性设置为使用 mime.type 属性，则此属性用于确定 FlowFile 的 MIME 类型。在这种情况下，如果属性设置为 application/tar，将使用 TAR 打包格式。如果属性设置为 application/zip，将使用 ZIP 打包格式。如果属性设置为 application/flowfile-v3 或 application/flowfile-v2 或 application/flowfile-v1，将使用相应的 FlowFile 打包格式。如果此属性缺失，FlowFile 将路由到 'failure'。否则，如果属性的值不是上述值之一，FlowFile 将路由到 'success' 而不被解包。使用 File Filter 属性仅提取匹配特定正则表达式的文件。

写入的 FlowFile 属性

名称	描述
`mime.type`	如果 FlowFile 成功解包，其 MIME 类型不再已知，因此 mime.type 属性设置为 application/octet-stream
`fragment.identifier`	从同一父 FlowFile 产生的所有解包 FlowFile 将添加相同的随机生成 UUID 作为此属性
`fragment.index`	一个递增数字，表示从单个父 FlowFile 创建的解包 FlowFile 的顺序
`fragment.count`	从父FlowFile生成的解包FlowFile的数量
`segment.original.filename`	父 FlowFile 的文件名。.tar、.zip 或 .pkg 扩展名被移除，因为 MergeContent 处理器在用于重建原始 FlowFile 时会自动添加这些扩展名
`file.lastModifiedTime`	上次修改解压文件的日期和时间（仅限 tar 和 zip）。
`file.creationTime`	文件创建的日期和时间。对于加密的 zip 文件，此属性 always holds the same value as file.lastModifiedTime. For tar and unencrypted zip files if available it will be returned otherwise this will be the same value asfile.lastModifiedTime.
`file.lastMetadataChange`	文件元数据更改的日期和时间（仅限 tar）。
`file.lastAccessTime`	上次访问文件的日期和时间（仅限 tar 和未加密的 zip 文件）
`file.owner`	解压文件的所有者（仅限 tar）
`file.group`	解压文件的组所有者（仅限 tar）
`file.size`	解压文件的未压缩大小（仅限 tar 和 zip）
`file.permissions`	解压文件的读/写/执行权限（仅限 tar 和未加密的 zip 文件）
`file.encryptionMethod`	Zip 档案中条目的加密方法

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。

另请参阅

MergeContent