在 Node.js 中使用 REST API 比较 PDF 文件

您可以通过编程方式添加、编辑、删除或提取以元数据形式存储的音频文件的各种属性。您可以通过编程方式轻松地从云端的音频文件中提取元数据属性，例如标题、艺术家和流派。在本文中，您将学习如何使用 Java 中的 REST API 提取 MP3 音频文件的元数据。

本文讨论/涵盖以下主题：

MP3 元数据提取 REST API 和 Java SDK
在 Java 中使用 REST API 提取 MP3 文件的元数据
使用 Java 通过匹配精确短语提取元数据
使用 Java 通过正则表达式提取元数据
使用 Java 按属性名称提取元数据
使用 Java 按属性值提取元数据

MP3 元数据提取 REST API 和 Java SDK

我将使用 GroupDocs.Metadata Cloud 的 Java SDK API 来提取 MP3 音频文件的元数据。它允许您从 60 多种类型的文档、图像和多媒体文件格式中添加、编辑、检索和删除元数据属性。您只需定义搜索条件，API 就会在支持的文件格式中处理指定的元数据操作。该 API 适用于最著名的元数据标准，例如内置、XMP、EXIF、IPTC、图像资源块、ID3 和自定义元数据属性。它还为 Cloud API 提供 .NET SDK 作为其文档元数据操作家族成员。

通过添加以下 pom.xml 配置，您可以在基于 Maven 的 Java 应用程序中轻松使用 GroupDocs.Metadata Cloud。

<repository>
    <id>groupdocs-artifact-repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>http://repository.groupdocs.cloud/repo</url>
</repository>

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>20.4</version>
    <scope>compile</scope>
</dependency>

在执行上述步骤之前，请从 dashboard 获取您的 Client ID 和 Secret。获得 ID 和密码后，添加如下所示的代码：

String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";

Configuration configuration = new Configuration(clientId, clientSecret);

在 Java 中使用 REST API 提取 MP3 文件的元数据

您可以按照下面给出的简单步骤轻松提取 MP3 音频文件的元数据：

上传MP3文件至云端
使用 Java 提取 MP3 音频文件的元数据

上传文件

首先，使用下面给出的代码示例将 MP3 音频文件上传到云端：

// 接口初始化
FileApi apiInstance = new FileApi(clientId, clientSecret);

// 输入文件
File fileStream = new File("C:\\Files\\sample.mp3");

// 创建文件上传请求
UploadFileRequest request = new UploadFileRequest("sample.mp3", fileStream, myStorage);

// 上传文件
FilesUploadResult response = apiInstance.uploadFile(request);

因此，上传的 MP3 文件将在云端仪表板的文件部分中可用。

使用 Java 提取 MP3 音频文件的元数据

您可以按照以下步骤以编程方式提取 MP3 音频文件的所有元数据属性。

创建 MetadataApi 的实例
创建 FileInfo 的实例
设置MP3文件路径
创建 ExtractOptions 的实例
将 FileInfo 分配给 ExtractOptions
创建提取请求
调用MetadataApi.extract()方法并得到结果

以下代码示例展示了如何使用 REST API 提取 MP3 文件的元数据。

// 初始化接口
MetadataApi apiInstance = new MetadataApi(configuration);

// 定义提取选项
ExtractOptions options = new ExtractOptions();
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.mp3");
options.setFileInfo(fileInfo);

// 创建提取请求
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

// 显示结果
for (MetadataPackage metaPackage : response.getMetadataTree().getInnerPackages()) {
  for(MetadataProperty entry : metaPackage.getPackageProperties()) {
    System.out.println(entry.getName() + ": " + entry.getValue());
    if (entry.getTags() == null)
      continue;
   for (Tag tagItem : entry.getTags()) {
      System.out.println(
          "Tag for property: name - " + tagItem.getName() + ", category - " + tagItem.getCategory());
    }
  }
}

FileFormat: 21
Tag for property: name - FileFormat, category - Content
MimeType: audio/mpeg
Tag for property: name - FileFormat, category - Content
HeaderPosition: 2402
MpegAudioVersion: 3
Layer: 3
HasCrc: True
Bitrate: 224
Frequency: 32000
PaddingBit: 0
PrivateBit: False
Channel: 0
ModeExtensionBits: 0
Copyright: False
Original: True
Emphasis: 0
Version: ID3v1.1
Genre: 255
Album: YouTube Audio Library
Artist: Kevin MacLeod
Comment: This is sample comment.
Tag for property: name - Comment, category - Content
Title: Impact Moderato
Tag for property: name - Title, category - Content
Year: 2021
Tag for property: name - IntellectualContentCreated, category - Time
TrackNumber: 1
Version: ID3v2.3.0
TagSize: 2402
TALB: null
TPE1: null
TPE2: null
COMM: null
Tag for property: name - Comment, category - Content
TCOM: null
TPOS: null
TCON: null
TIT2: null
Tag for property: name - Title, category - Content
TRCK: null
TYER: null
Tag for property: name - IntellectualContentCreated, category - Time
title: Impact Moderato
Tag for property: name - Title, category - Content
artist: Kevin MacLeod
album: YouTube Audio Library
year: 2021
track: 1
genre: Cinematic
Tag for property: name - Type, category - Content
comment: This is sample comment.
Tag for property: name - Comment, category - Content
albumartist: MacLeod Kevin
composer: Kevin
discnumber: 101

使用 Java 通过匹配精确短语提取元数据

您可以按照以下步骤提取与确切短语匹配的 MP3 文件的元数据属性：

创建 MetadataApi 实例
创建 MatchOptions 的实例并将 ExactPhrase 设置为 true
初始化 NameOptions 的实例
提供匹配值并设置 MatchOptions
创建 SearchCriteria 的实例并设置 NameOptions
创建 FileInfo 的实例
设置MP3文件路径
创建 ExtractOptions 的实例
将定义的 SearchCriteria 和 FileInfo 分配给 ExtractOptions
创建提取请求
调用MetadataApi.extract()方法并得到结果

以下代码示例展示了如何使用 REST API 通过匹配精确短语来提取元数据。

// 初始化接口
MetadataApi apiInstance = new MetadataApi(configuration);

// 创建匹配选项
MatchOptions matchOptions = new MatchOptions();
matchOptions.setExactPhrase(true);

// 创建名称选项
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("MimeType");
nameOptions.setMatchOptions(matchOptions);

// 定义搜索条件
SearchCriteria searchCriteria = new SearchCriteria();
searchCriteria.setNameOptions(nameOptions);

// 定义提取选项
ExtractOptions options = new ExtractOptions();
options.setSearchCriteria(searchCriteria);

// 提供输入文件
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.mp3");
options.setFileInfo(fileInfo);

// 创建提取请求
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

// 显示结果
for (MetadataProperty entry : response.getProperties()) {
  System.out.println(entry.getName() + ": " + entry.getValue());
  if (entry.getTags() == null)
    continue;
 for (Tag tagItem : entry.getTags()) {
    System.out.println(
        "Tag for property: name - " + tagItem.getName() + ", category - " + tagItem.getCategory());
  }
}

MimeType: audio/mpeg
Tag for property: name - FileFormat, category - Content

使用 Java 通过正则表达式提取元数据

您可以按照以下步骤使用正则表达式定义搜索条件以提取 MP3 文件的元数据：

创建 MetadataApi 的实例
初始化 MatchOptions 的实例并将 IsRegex 设置为 true
创建 NameOptions 的实例
提供正则表达式并设置 MatchOptions
创建 SearchCriteria 的实例并设置 NameOptions
创建 FileInfo 的实例
设置MP3文件路径
创建 ExtractOptions 的实例
将定义的 SearchCriteria 和 FileInfo 分配给 ExtractOptions
创建提取请求
调用MetadataApi.extract()方法并得到结果

以下代码示例展示了如何使用 REST API 通过正则表达式搜索提取元数据。

// 初始化接口
MetadataApi apiInstance = new MetadataApi(configuration);

// 创建匹配选项
MatchOptions matchOptions = new MatchOptions();
matchOptions.setIsRegex(true);

// 创建名称选项
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("^Co.*");
nameOptions.setMatchOptions(matchOptions);

// 定义搜索条件
SearchCriteria searchCriteria = new SearchCriteria();
searchCriteria.setNameOptions(nameOptions);

// 定义提取选项
ExtractOptions options = new ExtractOptions();
options.setSearchCriteria(searchCriteria);

// 提供输入文件
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.mp3");
options.setFileInfo(fileInfo);

// 创建提取请求
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

for (MetadataProperty entry : response.getProperties()) {
  System.out.println(entry.getName() + ": " + entry.getValue());
  if (entry.getTags() == null)
    continue;
 for (Tag tagItem : entry.getTags()) {
    System.out.println(
        "Tag for property: name - " + tagItem.getName() + ", category - " + tagItem.getCategory());
  }
}

Copyright: False
Comment: This is sample comment.
Tag for property: name - Comment, category - Content
COMM: GroupDocs.Metadata.Formats.Audio.ID3V2CommentFrame
Tag for property: name - Comment, category - Content
CommEncoding: 1
CommLanguage: eng
CommShortContentDescription: 
CommText: This is sample comment.
comment: This is sample comment.
Tag for property: name - Comment, category - Content
composer: Kevin

使用 Java 按属性名称提取元数据

您可以按照以下步骤定义搜索条件以提取特定属性的 MP3 文件的元数据：

创建 MetadataApi 的实例
初始化 NameOptions 的实例并设置值
创建 SearchCriteria 的实例并设置 NameOptions
创建 FileInfo 的实例
设置MP3文件路径
创建 ExtractOptions 的实例
将定义的 SearchCriteria 和 FileInfo 分配给 ExtractOptions
创建提取请求
调用MetadataApi.extract()方法并得到结果

以下代码示例展示了如何使用 REST API 搜索属性名称来提取元数据。

// 初始化接口
MetadataApi apiInstance = new MetadataApi(configuration);

// 创建名称选项
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("Artist");

// 定义搜索条件
SearchCriteria searchCriteria = new SearchCriteria();
searchCriteria.setNameOptions(nameOptions);

// 提供输入文件
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.mp3");

// 定义提取选项
ExtractOptions options = new ExtractOptions();
options.setSearchCriteria(searchCriteria);
options.setFileInfo(fileInfo);

// 创建提取请求
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

for (MetadataProperty entry : response.getProperties()) {
  System.out.println(entry.getName() + ": " + entry.getValue());
  if (entry.getTags() == null)
    continue;
 for (Tag tagItem : entry.getTags()) {
    System.out.println(
        "Tag for property: name - " + tagItem.getName() + ", category - " + tagItem.getCategory());
  }
}

Artist: Kevin MacLeod
artist: Kevin MacLeod
albumartist: MacLeod Kevin

使用 Java 按属性值提取元数据

您可以按照以下步骤定义搜索条件以提取与属性值匹配的 MP3 文件的元数据：

创建 MetadataApi 的实例
创建 ValueOptions 的实例
提供要搜索的值及其类型
创建 SearchCriteria 的实例并设置 ValueOptions
创建 FileInfo 的实例
设置MP3文件路径
创建 ExtractOptions 的实例
将定义的 SearchCriteria 和 FileInfo 分配给 ExtractOptions
创建提取请求
调用MetadataApi.extract()方法并得到结果

以下代码片段显示了如何使用 REST API 通过搜索属性值来提取元数据。

// 初始化接口
MetadataApi apiInstance = new MetadataApi(configuration);

// 创造价值的选择
ValueOptions valueOptions = new ValueOptions();
valueOptions.setValue("Impact Moderato");
valueOptions.setType("string");

// 定义搜索条件
SearchCriteria searchCriteria = new SearchCriteria();
searchCriteria.setValueOptions(valueOptions);

// 提供输入文件
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.mp3");

// 定义提取选项
ExtractOptions options = new ExtractOptions();
options.setSearchCriteria(searchCriteria);
options.setFileInfo(fileInfo);

// 创建提取请求
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

for (MetadataProperty entry : response.getProperties()) {
  System.out.println(entry.getName() + ": " + entry.getValue());
  if (entry.getTags() == null)
    continue;
 for (Tag tagItem : entry.getTags()) {
    System.out.println(
        "Tag for property: name - " + tagItem.getName() + ", category - " + tagItem.getCategory());
  }
}

Title: Impact Moderato
Tag for property: name - Title, category - Content
TextValue: Impact Moderato

在线试用

请试用以下免费的在线 MP3 元数据提取工具，它是使用上述 API 开发的。 https://products.groupdocs.app/metadata/total

结论

在本文中，您学习了如何提取云端 MP3 音频文件的元数据。您还学习了如何通过定义搜索条件(例如匹配精确短语、使用正则表达式以及按属性名称或值)来提取元数据。本文还介绍了如何以编程方式将 MP3 音频文件上传到云端。您可以使用文档了解有关 GroupDocs.Metadata 提取 Cloud API 的更多信息。我们还提供了一个 API 参考部分，让您可以直接通过浏览器可视化我们的 API 并与之交互。如有任何歧义，请随时在论坛上与我们联系。

也可以看看

使用 Java 和 .NET 管理文档的元数据

MP3 元数据提取 REST API 和 Java SDK#

在 Java 中使用 REST API 提取 MP3 文件的元数据#

上传文件#

使用 Java 提取 MP3 音频文件的元数据#

使用 Java 通过匹配精确短语提取元数据#

使用 Java 通过正则表达式提取元数据#

使用 Java 按属性名称提取元数据#

使用 Java 按属性值提取元数据#

在线试用#

结论#

也可以看看#