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

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

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

Есть много причин, по которым вам может потребоваться преобразовать HTML из ZIP-архива в формат JPG. Например, если вы хотите преобразовать документ HTML (XHTML), содержащий связанные ресурсы, в JPG, вы должны упаковать все эти ресурсы вместе с документом в один ZIP-архив и преобразовать ZIP в JPG. Aspose.HTML for .NET предоставляет функциональные возможности для создания пользовательских обработчиков сообщений для работы с ZIP-архивами.

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

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

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

using Aspose.Html.Net;
...

	class ZipArchiveMessageHandler : MessageHandler
	{
	}

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. Он имеет две переменные: архив и строковое представление пути к архиву. Наследование от IDisposable необходимо для обеспечения механизма детерминированного освобождения неуправляемых ресурсов.

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

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

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

  Метод GetFile() реализует поиск данных в виде байтового массива в zip-архиве на основе Request и формирует Response.

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

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

Ключевой концепцией работы обработчиков сообщений является объединение их в цепочку, и теперь вам нужно добавить ZipArchiveMessageHandler в конвейер. Конструктор Configuration() создает экземпляр класса Configuration. После создания конфигурации вызываются методы GetService<INetworkService>() и MessageHandlers.Add(). Метод Add() принимает в качестве параметра объект zip и добавляет ZipArchiveMessageHandler в конец коллекции обработчиков сообщений.

// 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-jpg.jpg");

// 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 an instance of Rendering Options
var options = new ImageRenderingOptions()
{
    Format = ImageFormat.Jpeg
};

// Create an instance of Image Device   
using var device = new ImageDevice(options, savePath);

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

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

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

Для получения дополнительной информации о том, как преобразовать HTML в JPG с помощью метода Renderto(device), пожалуйста, прочитайте Fine-Tuning Converters.

Aspose.HTML предлагает бесплатный онлайн Конвертер ZIP в JPG, который конвертирует HTML из ZIP-архива в JPG с высоким качеством, легко и быстро. Просто загрузите, конвертируйте свои файлы и получите результат за несколько секунд!