保持多个ODT文档的同步对于需要发现更改并自动合并编辑的开发人员来说,可能很快就会变成头疼的问题。Aspose.Words Cloud SDK for .NET 使在 .NET 中以编程方式比较和合并 ODT 文件变得简单可靠。本指南将带您完成将两个 ODT 文件上传到 Aspose Cloud 存储、生成差异文档、接受所有修订以生成合并文件以及检索结果的过程。您还将看到使用 cURL 的等效 REST 调用,并了解如何在 .NET 项目中配置 SDK。
在 .NET 中比较和合并 ODT 文件的完整工作示例
本示例演示如何比较两个 ODT 文件,生成修订文档,接受所有修订,并下载最终合并的 ODT。
using System;
using System.IO;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
class Program
{
static void Main()
{
// ==== Set up Aspose.Words Cloud SDK ====
var clientId = "YOUR_CLIENT_ID";
var clientSecret = "YOUR_CLIENT_SECRET";
var config = new Configuration
{
ClientId = clientId,
ClientSecret = clientSecret
};
var wordsApi = new WordsApi(config);
// ==== Define file names and storage folder ====
string storageFolder = "Documents";
string originalFile = "original.odt";
string revisedFile = "revised.odt";
string compareResultFile = "compareResult.odt";
string mergedFile = "merged.odt";
// ==== Upload local ODT files to Aspose Cloud storage ====
UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, originalFile),
$"{storageFolder}/{originalFile}");
UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, revisedFile),
$"{storageFolder}/{revisedFile}");
// ==== Perform comparison (diff) ====
var compareData = new CompareData
{
Author = "Comparer",
CompareOptions = new CompareOptions
{
IgnoreCaseChanges = false,
IgnoreComments = false,
IgnoreFormatting = false,
IgnoreHeadersAndFooters = false,
IgnoreTables = false,
IgnoreFields = false,
IgnoreFootnotes = false,
IgnoreTextboxes = false,
IgnoreInsertedParagraphs = false,
IgnoreDeletedParagraphs = false
},
FileReference = new FileReference($"{storageFolder}/{revisedFile}")
};
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
// ==== Download the document that now contains revisions (diff result) ====
var downloadDiff = new DownloadFileRequest($"{storageFolder}/{originalFile}");
using (var diffStream = wordsApi.DownloadFile(downloadDiff))
using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, compareResultFile)))
{
diffStream.CopyTo(fileStream);
}
// ==== Accept all revisions to produce the merged document ====
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
// ==== Download the merged ODT document ====
var downloadMerged = new DownloadFileRequest($"{storageFolder}/{originalFile}");
using (var mergedStream = wordsApi.DownloadFile(downloadMerged))
using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, mergedFile)))
{
mergedStream.CopyTo(fileStream);
}
// ==== Simple verification ====
var info = new FileInfo(mergedFile);
Console.WriteLine($"Merged document saved as '{mergedFile}' (size: {info.Length} bytes).");
}
static void UploadFile(WordsApi api, string localPath, string remotePath)
{
using (var stream = File.OpenRead(localPath))
{
var uploadRequest = new UploadFileRequest(remotePath, stream);
api.UploadFile(uploadRequest);
}
}
}
注意: 此代码示例演示了核心功能。在将其用于项目之前,请确保更新任何文件路径和配置值以匹配实际环境,验证所有必需的依赖项已正确安装,并在开发环境中彻底测试。如果遇到任何问题,请参阅官方文档或联系支持团队获取帮助。
使用 cURL 和 REST API 执行 ODT 文件差异比较和合并
以下是执行相同差异和合并工作流的等效 cURL 命令,这些命令针对 Aspose.Words Cloud REST API。
- 获取访问令牌
将YOUR_CLIENT_ID和YOUR_CLIENT_SECRET替换为您的凭据。
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- 上传原始 ODT 文件
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@original.odt"
- 上传已修订的 ODT 文件
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/revised.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@revised.odt"
- 运行比较(diff)操作
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/compare" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"author": "Comparer",
"compareOptions": {
"ignoreCaseChanges": false,
"ignoreComments": false,
"ignoreFormatting": false,
"ignoreHeadersAndFooters": false,
"ignoreTables": false,
"ignoreFields": false,
"ignoreFootnotes": false,
"ignoreTextboxes": false,
"ignoreInsertedParagraphs": false,
"ignoreDeletedParagraphs": false
},
"fileReference": { "href": "Documents/revised.odt" }
}'
- 接受所有修订以创建合并的 ODT
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- 下载合并后的 ODT 文档
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
有关请求正文和其他选项的更多详细信息,请参阅官方 API 文档。
如何在 .NET 中以编程方式比较和合并 ODT 文件
代码遵循清晰的顺序,映射上述描述的 REST 工作流。
- 初始化 API 客户端 -
new WordsApi(config)使用包含您的ClientId和ClientSecret的Configuration对象创建经过身份验证的客户端。
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
上传源文件 - 辅助方法
UploadFile使用UploadFileRequest将每个本地 ODT 文件发送到云存储文件夹。var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
创建
CompareData对象 - 此对象定义作者、比较选项以及对修订文件的引用。它被传递给CompareDocumentRequest。var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
执行比较操作 -
wordsApi.CompareDocument(compareRequest)将请求发送到服务,服务会在原始文档中添加修订标记。
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
- 接受所有修订 -
AcceptAllRevisionsRequest告诉服务合并更改,生成干净的 ODT 文件。
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
每个步骤都直接对应 cURL 命令,让您可以在 .NET 库和原始 HTTP 调用之间灵活选择。
安装和配置 Aspose.Words Cloud SDK for .NET
- 添加 NuGet 包
dotnet add package Aspose.Words-Cloud
-
恢复包并构建 - SDK 支持 .NET 6.0 及更高版本。确保您的项目针对兼容的框架。
-
配置凭证 - 将示例代码中的占位符值替换为您从 Aspose Cloud 仪表板获取的
ClientId和ClientSecret。 -
下载 SDK - 您也可以从官方发布页面下载最新的二进制文件: Aspose.Words Cloud SDK for .NET Download.
-
生产许可证 - 对于长期使用,请从临时许可证页面获取临时或永久许可证。
常见问题
-
如何在 .NET 中使用 Aspose.Words Cloud SDK 以编程方式比较和合并 ODT 文件?
使用由 Aspose.Words Cloud SDK for .NET 提供的CompareDocument和AcceptAllRevisions操作。上传两个 ODT 文件,执行比较请求,然后接受修订以获取合并后的结果。 -
需要什么身份验证方法来调用 REST API?
您需要客户端 ID 和客户端密钥来获取 OAuth 2.0 访问令牌。将令牌包含在每个 cURL 请求的Authorization标头中。 -
是否有办法在购买前试用 SDK?
您可以从temporary license page请求临时许可证,以在开发期间评估该库。