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

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

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

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

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

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

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

using Aspose.Html.Net;
...

	class ZipArchiveMessageHandler : MessageHandler
	{
	}

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

	
using System.Net;
using Aspose.Html;
using Aspose.Html.Net;
using Aspose.Html.Net.MessageFilters;
using Aspose.Zip;
...	

	// Define ZipArchiveMessageHandler class that is derived from the MessageHandler class
	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 in the chain
			Next(context);
	    }
	}	

Рассмотрим поближе фрагмент кода:

• Пользовательский 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.

Определите методы GetFile(), GetArchive() и Dispose()

using System.IO;
using Aspose.Zip;
...

	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 в конвейер

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

using System;
using Aspose.Html;
using Aspose.Html.Net;
using Aspose.Html.Rendering.Image;
using Aspose.Html.Services;
...

	// 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 HTML 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 с высоким качеством, легко и быстро. Просто загрузите, конвертируйте свои файлы и получите результат за несколько секунд!