如何从 S3 下载 PDF 并使用 GroupDocs .NET 进行注释

Install-Package GroupDocs.Annotation -Version 25.4.0

dotnet add package GroupDocs.Annotation --version 25.4.0

using GroupDocs.Annotation;

// Initialize the annotator with a file stream from S3
Annotator annotator = new Annotator(s3DocumentStream);

using Amazon.S3;
using Amazon.S3.Model;

// Create a client instance (uses default credential chain)
AmazonS3Client client = new AmazonS3Client();
string bucketName = "my-bucket"; // Replace with your actual S3 bucket name

GetObjectRequest request = new GetObjectRequest
{
    Key = "your-file-key.pdf",
    BucketName = bucketName
};

using (GetObjectResponse response = client.GetObject(request))
{
    // Create a memory stream to store the PDF content
    MemoryStream stream = new MemoryStream();
    
    // Copy the S3 response directly to our memory stream
    response.ResponseStream.CopyTo(stream);
    
    // Reset position for annotation processing
    stream.Position = 0;
    
    // Return the stream for GroupDocs processing
    return stream;
}

// Initialize the annotator with the S3-downloaded document
using (Annotator annotator = new Annotator(downloadedStream))
{
    // All annotation operations happen here
}

// Create an area annotation for highlighting
AreaAnnotation area = new AreaAnnotation()
{
    // Define the position and dimensions
    Box = new Rectangle(100, 100, 100, 100),
    
    // Set a yellow background color for visibility
    BackgroundColor = 65535,
};

// Add the annotation to the document
annotator.Add(area);

// Define output path for the processed document
string outputPath = Path.Combine("output-directory", "annotated-document.pdf");

// Save the document with all applied annotations
annotator.Save(outputPath);

using System;
using System.IO;
using Amazon.S3;
using Amazon.S3.Model;
using GroupDocs.Annotation;
using GroupDocs.Annotation.Models;
using GroupDocs.Annotation.Models.AnnotationModels;

namespace GroupDocs.Annotation.Examples
{
    class DocumentAnnotationFromS3Example
    {
        public static void Run()
        {
            Console.WriteLine("Starting document annotation from S3...");
            
            // Define your output path
            string outputPath = Path.Combine("output-directory", "annotated-document.pdf");
            
            // Define the key of the file to download from S3
            string key = "sample.pdf";
            
            // Download and annotate the document
            using (Annotator annotator = new Annotator(DownloadFileFromS3(key)))
            {
                // Create an area annotation
                AreaAnnotation area = new AreaAnnotation()
                {
                    Box = new Rectangle(100, 100, 100, 100),
                    BackgroundColor = 65535, // Yellow color
                };
                
                // Add the annotation to the document
                annotator.Add(area);
                
                // Save the annotated document
                annotator.Save(outputPath);
            }
            
            Console.WriteLine($"Document successfully annotated and saved to: {outputPath}");
        }
        
        private static Stream DownloadFileFromS3(string key)
        {
            // Initialize S3 client (assumes AWS credentials are configured)
            AmazonS3Client client = new AmazonS3Client();
            string bucketName = "my-bucket"; // Replace with your actual bucket name
            
            // Create request to get object from S3
            GetObjectRequest request = new GetObjectRequest
            {
                Key = key,
                BucketName = bucketName
            };
            
            // Download the file from S3
            using (GetObjectResponse response = client.GetObject(request))
            {
                MemoryStream stream = new MemoryStream();
                response.ResponseStream.CopyTo(stream);
                stream.Position = 0;
                return stream;
            }
        }
    }
}

// Configure client for specific region
AmazonS3Client client = new AmazonS3Client(Amazon.RegionEndpoint.USEast1);

// Good: Direct stream processing
using (var s3Stream = DownloadFileFromS3(key))
using (var annotator = new Annotator(s3Stream))
{
    // Process annotations
}

var downloadTasks = pdfKeys.Select(key => 
    Task.Run(() => DownloadAndAnnotateFromS3(key))
).ToArray();

await Task.WhenAll(downloadTasks);

// For explicit credential configuration
var awsOptions = new AWSOptions
{
    Credentials = new BasicAWSCredentials("access-key", "secret-key"),
    Region = RegionEndpoint.USEast1
};

stream.Position = 0; // Always reset before passing to GroupDocs

// Use buffered streams for large files
using (var bufferedStream = new BufferedStream(s3ResponseStream))
{
    // Process in manageable chunks
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:GetObject"],
            "Resource": "arn:aws:s3:::your-bucket/*"
        }
    ]
}

// Save with explicit options
annotator.Save(outputPath, new SaveOptions 
{ 
    AnnotationTypes = AnnotationType.All 
});

var config = new AmazonS3Config
{
    RegionEndpoint = Amazon.RegionEndpoint.USWest2,
    Timeout = TimeSpan.FromMinutes(5),
    UseAccelerateEndpoint = true, // For global applications
    ForcePathStyle = false
};

using var client = new AmazonS3Client(config);

// Initialize with specific load options
var loadOptions = new LoadOptions
{
    Password = documentPassword, // If PDF is password-protected
};

using var annotator = new Annotator(stream, loadOptions);

using var outputStream = new MemoryStream();
annotator.Save(outputStream);
outputStream.Position = 0;

var putRequest = new PutObjectRequest
{
    BucketName = bucketName,
    Key = "annotated-" + originalKey,
    InputStream = outputStream,
    ContentType = "application/pdf"
};

await client.PutObjectAsync(putRequest);

// Production: Uses IAM role automatically
var client = new AmazonS3Client();

// Development: Uses environment variables
Environment.SetEnvironmentVariable("AWS_ACCESS_KEY_ID", "your-key");
Environment.SetEnvironmentVariable("AWS_SECRET_ACCESS_KEY", "your-secret");

string userVersionKey = $"{originalKey}-user-{userId}-{timestamp}";

var retryPolicy = Policy
    .Handle<AmazonS3Exception>()
    .WaitAndRetryAsync(3, retryAttempt => 
        TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));

await retryPolicy.ExecuteAsync(async () =>
{
    return await DownloadFileFromS3(key);
});