Конвертировать HTML из ZIP-архива в PDF – пример С#

В этой статье мы создадим собственный обработчик сообщений для выполнения конкретной задачи – преобразования HTML из ZIP-архива в PDF.

Есть много причин, по которым вам может понадобиться конвертировать HTML из ZIP-архива в формат PDF. PDF имеет много преимуществ, которых нет у других файлов. Например, многие программы и приложения поддерживают PDF-документы, большинство веб-браузеров, таких как Chrome и Firefox, могут отображать PDF-файлы. PDF-файлы оптимизированы для печати; они идеально подходят для создания физических копий ваших документов. PDF поддерживает множество алгоритмов сжатия. Вы можете настроить параметры безопасности для вашего PDF-файла и т. д.

Создайте собственный обработчик сообщений

Aspose.HTML for .NET предлагает функциональные возможности для создания пользовательских обработчиков сообщений. Давайте разработаем собственный обработчик, который мы можем использовать для работы с ZIP-архивами. Выполните следующие действия:

1. Используйте необходимое пространство имен, которым является Aspose.Html.Net. Это пространство имен представлено классами и интерфейсами, которые отвечают за упрощение сетевой обработки.

2. Чтобы создать собственный обработчик сообщений, вам необходимо определить собственный класс, который будет производным от класса MessageHandler. Класс MessageHandler представляет базовый тип для обработчиков сообщений. Наследование от IDisposable необходимо для обеспечения механизма детерминированного освобождения неуправляемых ресурсов.

using Aspose.Html.Net;
...

	class ZipArchiveMessageHandler : MessageHandler, IDisposable
	{
	}

Итак, вы определили свой собственный класс ZipArchiveMessageHandler, теперь вам нужно проделать в нем некоторые операции.

3. Инициализируйте экземпляр класса ZipArchiveMessageHandler и определите для него свойство Filter.
4. Переопределите метод Invoke() класса MessageHandler для реализации пользовательского поведения обработчика сообщений.

// This message handler prints a message about start and finish processing request
class ZipArchiveMessageHandler : MessageHandler, IDisposable
{
    private string filePath;
    private Archive archive;

    // Initialize an instance of the ZipArchiveMessageHandler class
    public ZipArchiveMessageHandler(string path)
    {
        this.filePath = path;
        Filters.Add(new ProtocolMessageFilter("zip"));
    }

    // Override the Invoke() method
    public override void Invoke(INetworkOperationContext context)
    {
        // Call the GetFile() method that defines the logic in the Invoke() method
        var buff = GetFile(context.Request.RequestUri.Pathname.TrimStart('/'));
        if (buff != null)
        {
            // Checking: if a resource is found in the archive, then return it as a Response
            context.Response = new ResponseMessage(HttpStatusCode.OK)
            {
                Content = new ByteArrayContent(buff)
            };
            context.Response.Headers.ContentType.MediaType = MimeType.FromFileExtension(context.Request.RequestUri.Pathname);
        }
        else
        {
            context.Response = new ResponseMessage(HttpStatusCode.NotFound);
        }

        // Call the next message handler
        Next(context);
    }           

                
    byte[] GetFile(string path)
    {
        path = path.Replace(@"\", @"/");
        var result = GetArchive().Entries.FirstOrDefault(x => path == x.Name);
        if (result != null)
        {
            using (var fs = result.Open())
            using (MemoryStream ms = new MemoryStream())
            {
                fs.CopyTo(ms);
                return ms.ToArray();
            }
        }
        return null;
    }

    Archive GetArchive()
    {
        return archive ??= new Archive(filePath);
    }

    public void Dispose()
    {
        archive?.Dispose();
    }          
}

Давайте внимательно посмотрим на этот фрагмент кода:- Прежде всего, пользовательский ZipArchiveMessageHandler должен наследоваться от базового класса MessageHandler. Он имеет две переменные: архив и строковое представление пути к архиву.

• Обработчик сообщений имеет концепцию фильтрации. В этом случае добавляется фильтр протокола (схемы); этот обработчик сообщений будет работать только с протоколом “zip”. То есть, если у ресурса протокол “zip”, то он будет обработан ZipArchiveMessageHandler.

  Фильтрация сообщений по ресурсному протоколу реализована с помощью класса ProtocolMessageFilter. Конструктор ProtocolMessageFilter() инициализирует новый экземпляр класса ProtocolMessageFilter. Он принимает протоколы "zip" в качестве параметра.

• Метод Invoke() реализует поведение обработчика сообщений. Он вызывается для каждого обработчика в конвейере и принимает «контекст» в качестве параметра. Метод GetFile() определяет логику метода Invoke(). Он реализует цепочку обязанностей, после которой вызывается следующий обработчик Next(context). Метод GetFile() реализует поиск данных в виде байтового массива в zip-архиве на основе Request и формирует Response.

  context предоставляет контекстную информацию для сетевых служб, через него проходит сущность операции и возвращается результат операции. В Aspose.HTML «контекст» реализуется интерфейсом INetworkOperationContext, который имеет два свойства (параметра) – Request и Response. Request получает или задает сообщение запроса, Response получает или задает ответное сообщение. Запрос содержит информацию для веб-запроса, например, URL-адрес – путь к ресурсу, заголовки и т. д. Response содержит ответ, который вернула конечная точка (Интернет).

Вы можете скачать полные примеры и файлы данных с GitHub.

Добавьте ZipArchiveMessageHandler в конвейер

Теперь вам нужно добавить ZipArchiveMessageHandler в конвейер. Используйте метод Add(), который принимает объект zip в качестве параметра и добавляет ZipArchiveMessageHandler в конец коллекции обработчиков сообщений.

Свойство INetworkService.MessageHandlers получает список экземпляров MessageHandler, которые будут вызываться как RequestMessage выполняется.

// Add this line before you try to use the 'IBM437' encoding
System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance);

// Prepare path to a source zip file
string documentPath = Path.Combine(DataDir, "test.zip");

// Prepare path for converted file saving
string savePath = Path.Combine(OutputDir, "zip-to-pdf.pdf");

// Create an instance of ZipArchiveMessageHandler
using var zip = new ZipArchiveMessageHandler(documentPath);

// Create an instance of the Configuration class
using var configuration = new Configuration();

// Add ZipArchiveMessageHandler to the chain of existing message handlers
configuration
    .GetService<INetworkService>()
    .MessageHandlers.Add(zip);            

// Initialize an HTML document with specified configuration
using var document = new HTMLDocument("zip:///test.html", configuration);

// Create the PDF Device  
using var device = new PdfDevice(savePath);

// Render ZIP to PDF
document.RenderTo(device);

В примере ZIP-архив (test.zip) содержит HTML-документ (test.html), в котором все связанные ресурсы имеют пути относительно HTML-документа.

Примечание. Конструктор HTMLDocument(address, configuration) принимает абсолютный путь к ZIP-архиву. Но все связанные ресурсы имеют относительные пути в документе HTML и в коде примера.

Прочтите статью Fine-Tuning Convserters, чтобы узнать больше о преобразовании HTML в PDF с помощью Renderto(device).

Aspose.HTML предоставляет бесплатный онлайн-конвертер ZIP to PDF Converter, который позволяет быстро, легко и четко конвертировать ZIP в PDF. Загружайте, конвертируйте файлы и получайте результаты за считанные секунды. Никакого дополнительного программного обеспечения не требуется. Попробуйте наш надежный конвертер ZIP в PDF бесплатно прямо сейчас!