Configuración del entorno – Aspose.SVG for .NET

La configuración del entorno se utiliza para diversos fines. Por ejemplo, cuando desarrolle una aplicación, definitivamente exigirá alguna configuración que puede variar desde el servicio de tiempo de ejecución o manejar cualquier solicitud web de la aplicación hasta la inyección de temas personalizados.

En esta guía aprenderá a crear diversas configuraciones y adaptarlas a los diferentes entornos donde se ejecuta la aplicación. Puede ser un tema personalizado, un servicio de ejecución o un servicio de red de solicitud web.

El espacio de nombres Aspose.Svg.Services contiene un conjunto de interfaces para implementaciones de servicios separados. Este artículo considera diferentes tipos de servicios de configuración del entorno, como User Agent Service, Runtime Service y Network Service. Aspose.SVG for .NET proporciona la clase Configuración que se puede utilizar para configurar el entorno donde se ejecuta la aplicación.

Puede descargar los ejemplos completos y los archivos de datos desde GitHub. Encontrará información sobre cómo descargar desde GitHub y ejecutar ejemplos en la sección Cómo ejecutar los ejemplos.

Servicio de agente de usuario – User Agent Service

El User Agent Service le permite especificar una hoja de estilo de usuario personalizada, un conjunto de caracteres principal para el documento, el idioma y la configuración de fuentes. Puede seleccionar su información de estilo personalizada para un documento en particular y proporcionar tantos cambios de configuración del entorno como sean necesarios.

La interfaz IUserAgentService describe un entorno de agente de usuario.

• La propiedad UserStyleSheet de la interfaz IUserAgentService permite especificar información de estilo para un documento en particular;

• La propiedad CharSet establece el juego de caracteres principal de un documento.

  Para analizar y mostrar un documento SVG correctamente, la aplicación debe saber qué codificación está utilizando. Si la codificación de caracteres no se especifica directamente en el encabezado del documento, Aspose.SVG usa UTF-8, que está definido como predeterminado. Sin embargo, si está seguro de que su documento SVG está escrito con una codificación diferente a la UTF-8, puede especificarla manualmente, como se muestra en el ejemplo anterior.

• La propiedad FontsSettings se utiliza para la configuración del manejo de fuentes. Cuando necesite utilizar fuentes personalizadas en lugar de las fuentes instaladas en el sistema operativo, puede establecer la ruta a su carpeta personalizada, como se muestra en el siguiente fragmento de código.

• La propiedad CSSEngineMode obtiene o establece el modo en el que funciona el motor CSS.

• La propiedad Language especifica el idioma principal del contenido del elemento y de cualquiera de los atributos del elemento que contienen texto.

Considere un ejemplo que ilustra la aplicación de las propiedades UserStyleSheet, CharSet y FontsSettings:

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;

// Set custom user agent, styles, charset, and fonts for SVG conversion to PDF in C#

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
              "    <text x=\"80\" y=\"100\">Aspose.SVG</text>\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "user-agent.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Get the IUserAgentService
    IUserAgentService userAgentService = configuration.GetService<IUserAgentService>();

    // Set a custom style parameters for <circle> and <text> elements
    userAgentService.UserStyleSheet = "circle { fill:silver; }\r\n" +
                                      "text { fill:DarkCyan; font-size:3em; }\r\n";

    // Set ISO-8859-1 encoding to parse a document
    userAgentService.CharSet = "ISO-8859-1";

    // Set a custom font folder path
    userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "fonts"));

    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "user-agent.svg"), configuration))
    {
        // Convert SVG to PDF
        Converter.ConvertSVG(document, new PdfSaveOptions(), Path.Combine(OutputDir, "user-agent.pdf"));
    }
}

La figura ilustra el resultado de User Agent Service aplicando (b) al archivo fuente “user-agent.svg” (a).

Servicio de tiempo de ejecución – Runtime Service

Cuando planee ejecutar su aplicación, es posible que necesite una configuración del servicio de tiempo de ejecución. Este servicio le brinda control sobre la vida útil de los procesos internos. Por ejemplo, utilizando IRuntimeService puede especificar tiempos de espera para JavaScripts. Es importante tener dicho tiempo de espera en caso de que un script contenga un bucle sin fin. El siguiente fragmento de código demuestra cómo utilizar los tiempos de espera.

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;

// Limit JavaScript execution time in SVG before conversion to PNG in C#

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <script> while(true) {} </script>\r\n" +
              "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "runtime.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Limit JS execution time to 5 seconds
    IRuntimeService runtimeService = configuration.GetService<IRuntimeService>();
    runtimeService.JavaScriptTimeout = TimeSpan.FromSeconds(5);
                   
    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "runtime.svg"), configuration))
    {
        // Convert SVG to PNG
        Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "runtime.png"));
    }
}

La propiedad JavaScriptTimeout establece TimeSpan, que limita el tiempo de ejecución de JavaScript. Si el script se ejecuta durante más tiempo del TimeSpan proporcionado, se cancelará. El valor predeterminado es 1 minuto.

Servicio de red – Network Service

Los entornos de red modernos generan una cantidad significativa de eventos de seguridad y registran datos a través de enrutadores y conmutadores de red, servidores, sistemas antimalware, etc.

Aspose.SVG for .NET ofrece INetworkService que se concibe como una solución para ayudar a gestionar y analizar toda esta información. El servicio le permite controlar todo el tráfico entrante/saliente e implementar sus controladores de mensajes personalizados. Se puede utilizar para diferentes propósitos, como crear un mecanismo de almacenamiento en caché personalizado, rastrear/registro de mensajes de solicitud, etc.

Crear un controlador de mensajes personalizado

Aspose.SVG for .NET ofrece funcionalidad para la creación de controladores de mensajes personalizados. Desarrollemos un controlador personalizado simple que registre información sobre recursos inalcanzables. Tome los siguientes pasos:

1. Utilice el espacio de nombres necesario, que es Aspose.Svg.Net. Este espacio de nombres se presenta mediante clases e interfaces, que son responsables de facilitar el procesamiento de la red.
2. Para crear un controlador de mensajes personalizado, debe definir su propia clase que se derivará de la clase MessageHandler. Construimos una clase LogMessageHandler.
3. Anule el método Invoke() de la clase MessageHandler para implementar el comportamiento personalizado del controlador de mensajes.

El siguiente ejemplo demuestra cómo crear LogMessageHandler para registrar información sobre recursos inaccesibles.

using Aspose.Svg.Net;
using System.Collections.Generic;
using System.Net;

// Сustom network message handler to log HTTP errors during SVG processing

// Define LogMessageHandler that is derived from the MessageHandler class
public class LogMessageHandler : MessageHandler
{
    private List<string> errors = new List<string>();

    public List<string> ErrorMessages
    {
        get { return errors; }
    }

    // Override the Invoke() method
    public override void Invoke(INetworkOperationContext context)
    {
        // Check whether response is OK
        if (context.Response.StatusCode != HttpStatusCode.OK)
        {
            // Set error information
            errors.Add(string.Format("File '{0}' Not Found", context.Request.RequestUri));
        }

        // Invoke the next message handler in the chain
        Next(context);
    }
}

Para obtener más información sobre la creación de controladores de mensajes personalizados, consulte el capítulo Controladores de mensajes.

Utilice LogMessageHandler para registrar información sobre recursos inaccesibles

El siguiente ejemplo demuestra cómo utilizar la clase LogMessageHandler para registrar información sobre recursos inalcanzables.

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;
using Aspose.Svg.Net;

// Log network errors when loading external images in SVG and convert to PNG

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/images/drawing/park.jpg\" width=\"640px\" height=\"480px\" />\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/net/missing1.svg\" width=\"400px\" height=\"300px\" />\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/net/missing2.svg\" width=\"400px\" height=\"300px\" />\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "network.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Add LogMessageHandler to the chain of existing message handlers
    INetworkService networkService = configuration.GetService<INetworkService>();
    
    LogMessageHandler logHandler = new LogMessageHandler();
    networkService.MessageHandlers.Add(logHandler);

    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "network.svg"),  configuration))
    {
        // Convert SVG to PNG
        Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "network.png"));

        // Print the List of ErrorMessages
        foreach (string errorMessage in logHandler.ErrorMessages)
        {
            Console.WriteLine(errorMessage);
        }
    }
}

Después de ejecutar el ejemplo:

• el archivo creado “network.svg” se convertirá a PNG. Sólo hay una imagen en el archivo;
• Se imprimirá la Lista de Mensajes de error:

File 'https://docs.aspose.com/svg/net/missing1.svg' Not Found
File 'https://docs.aspose.com/svg/net/missing2.svg' Not Found

Puede descargar los ejemplos completos y los archivos de datos desde GitHub. Encontrará información sobre la descarga desde GitHub y la ejecución de ejemplos en la sección Cómo ejecutar los ejemplos.