HTML aus ZIP-Archiv in PDF konvertieren – C#-Beispiel

In diesem Artikel erstellen wir einen benutzerdefinierten Message Handler für eine bestimmte Aufgabe – die Konvertierung von HTML aus einem ZIP-Archiv in PDF.

Es gibt viele Gründe, warum Sie HTML aus einem ZIP-Archiv in das PDF-Format konvertieren möchten. PDF bietet viele Vorteile, die andere Dateien nicht haben. Zum Beispiel unterstützen viele Programme und Anwendungen PDF-Dokumente, die meisten Webbrowser wie Chrome und Firefox können PDF-Dateien anzeigen. PDF-Dateien sind für den Druck optimiert; sie sind ideal für die Erstellung physischer Kopien Ihrer Dokumente. PDF unterstützt viele Komprimierungsalgorithmen. Sie können die Sicherheitseinstellungen für Ihre PDF-Datei konfigurieren, usw.

Erstellen eines benutzerdefinierten Nachrichten-Handlers

Aspose.HTML for .NET bietet Funktionen für die Erstellung benutzerdefinierter Nachrichten-Handler. Lassen Sie uns einen benutzerdefinierten Handler entwerfen, den wir für die Arbeit mit ZIP-Archiven verwenden können. Führen Sie die folgenden Schritte aus:

1. Verwenden Sie den erforderlichen Namespace, nämlich Aspose.Html.Net. Dieser Namespace wird durch Klassen und Schnittstellen dargestellt, die für eine einfache Netzwerkverarbeitung verantwortlich sind.

2. Um einen benutzerdefinierten Message Handler zu erstellen, müssen Sie Ihre eigene Klasse definieren, die von der Klasse MessageHandler abgeleitet wird. Die Klasse MessageHandler stellt einen Basistyp für Message-Handler dar. Die Vererbung von IDisposable ist notwendig, um einen Mechanismus für die deterministische Freigabe von nicht verwalteten Ressourcen bereitzustellen.

using Aspose.Html.Net;
...

	class ZipArchiveMessageHandler : MessageHandler, IDisposable
	{
	}

Sie haben also Ihre eigene ZipArchiveMessageHandler-Klasse definiert, nun müssen Sie einige Operationen darin durchführen.

3. Initialisieren Sie eine Instanz der Klasse ZipArchiveMessageHandler und definieren Sie eine Filter-Eigenschaft für sie.

4. Überschreiben Sie die Methode Invoke() der Klasse MessageHandler, um das Verhalten des benutzerdefinierten Nachrichten-Handlers zu implementieren.

// Implement ZipArchiveMessageHandler in C#

// 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
        byte[] 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(@"\", @"/");
        ArchiveEntry result = GetArchive().Entries.FirstOrDefault(x => path == x.Name);
        if (result != null)
        {
            using (Stream 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();
    }
}

Schauen wir uns dieses Codeschnipsel einmal genauer an:

• Zunächst einmal muss der benutzerdefinierte ZipArchiveMessageHandler von der Basisklasse MessageHandler erben. Er hat zwei Variablen: das Archiv und die String-Darstellung des Pfads zum Archiv.

• Der Message Handler verfügt über das Konzept der Filterung. In diesem Fall wird ein Protokoll-(Schema-)Filter hinzugefügt; dieser Nachrichten-Handler arbeitet nur mit dem "zip"-Protokoll. Das heißt, wenn die Ressource ein "zip"-Protokoll hat, dann wird sie von ZipArchiveMessageHandler verarbeitet.

  Filtering messages by resource protocol is implemented using the ProtocolMessageFilter class. The ProtocolMessageFilter() constructor initializes a new instance of the ProtocolMessageFilter class. It takes the "zip" protocols as a parameter.

• Die Methode Invoke() implementiert das Verhalten von Nachrichten-Handlern. Sie wird für jeden Handler in der Pipeline aufgerufen und nimmt einen context als Parameter an. Die Methode GetFile() definiert die Logik der Methode Invoke(). Sie implementiert die Aufgabenkette, nach der der nächste Next(context) Handler aufgerufen wird. Die GetFile()-Methode realisiert eine Suche nach Daten als Byte-Array in einem Zip-Archiv auf der Grundlage von Request und Formulare Response.

  context provides contextual information for network services, the entity of the operation is passed through it, and the result of the operation is returned. In Aspose.HTML, the context is realized by INetworkOperationContext interface that has two properties (parameters) – Request and Response. Request gets or sets the request message, Response gets or sets the response message. The Request contains information for a web request, for example, a URL – a path to a resource, headers, etc. The Response contains the response that the endpoint (Internet) returned.

Sie können die vollständigen Beispiele und Datendateien von GitHub herunterladen.

Hinzufügen von ZipArchiveMessageHandler in die Pipeline

Sie müssen nun ZipArchiveMessageHandler in die Pipeline aufnehmen. Verwenden Sie die Methode Add(), die ein “Zip”-Objekt als Parameter annimmt und ZipArchiveMessageHandler am Ende der Sammlung von Nachrichten-Handlern hinzufügt.

Die Eigenschaft INetworkService.MessageHandlers liefert eine Liste von MessageHandler-Instanzen, die bei der Ausführung einer RequestMessage aufgerufen werden.

// Convert HTML from a ZIP archive to PDF using C#

// 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 ZipArchiveMessageHandler zip = new ZipArchiveMessageHandler(documentPath);

// Create an instance of the Configuration class
using Configuration 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 HTMLDocument document = new HTMLDocument("zip:///test.html", configuration);

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

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

Im Beispiel enthält das ZIP-Archiv (test.zip) das HTML-Dokument (test.html), in dem alle zugehörigen Ressourcen Pfade relativ zum HTML-Dokument haben.

Hinweis: Der HTMLDocument(address, configuration) Konstruktor nimmt den absoluten Pfad zum ZIP-Archiv. Alle zugehörigen Ressourcen haben jedoch relative Pfade im HTML-Dokument und im Code des Beispiels.

Bitte lesen Sie den Artikel Feinabstimmung von Konvertern, um mehr über die Umwandlung von HTML in PDF mit der Methode RenderTo(device) zu erfahren.

Aspose.HTML bietet einen kostenlosen Online- ZIP zu PDF Konverter, mit dem Sie schnell, einfach und übersichtlich HTML aus ZIP-Archiven in PDF konvertieren können. Dateien hochladen, konvertieren und in Sekundenschnelle Ergebnisse erhalten. Es ist keine zusätzliche Software erforderlich. Testen Sie unseren robusten Konverter jetzt kostenlos!