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:

 1using System.IO;
 2using Aspose.Svg;
 3using Aspose.Svg.Services;
 4using Aspose.Svg.Converters;
 5using Aspose.Svg.Saving;
 6...
 7
 8   // Prepare SVG code and save it to a file
 9   var code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
10              "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
11              "    <text x=\"80\" y=\"100\">Aspose.SVG</text>\r\n" +
12              "</svg>\r\n";
13
14   File.WriteAllText(Path.Combine(OutputDir, "user-agent.svg"), code);
15
16   // Create an instance of Configuration
17   using (var configuration = new Configuration())
18   {
19       // Get the IUserAgentService
20       var userAgentService = configuration.GetService<IUserAgentService>();
21
22       // Set a custom style parameters for the "circle" and "text" elements
23       userAgentService.UserStyleSheet = "circle { fill:silver; }\r\n" +
24                                         "text { fill:DarkCyan; font-size:3em; }\r\n";
25
26       // Set ISO-8859-1 encoding to parse a document
27       userAgentService.CharSet = "ISO-8859-1";
28
29       // Set a custom font folder path
30       userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "fonts"));
31
32       // Initialize an SVG document with specified configuration
33       using (var document = new SVGDocument(Path.Combine(OutputDir, "user-agent.svg"), configuration))
34       {
35           // Convert SVG to PDF
36           Converter.ConvertSVG(document, new PdfSaveOptions(), Path.Combine(OutputDir, "user-agent.pdf"));
37       }
38   }

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

Texto “Representación de los archivos “user-agent.svg” y “user-agent.pdf””

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.

 1using System.IO;
 2using Aspose.Svg;
 3using Aspose.Svg.Services;
 4using Aspose.Svg.Converters;
 5using Aspose.Svg.Saving;
 6...
 7
 8    // Prepare SVG code and save it to a file
 9    var code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
10               "    <script> while(true) {} </script>\r\n" +
11               "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
12               "</svg>\r\n";
13
14    File.WriteAllText(Path.Combine(OutputDir, "runtime.svg"), code);
15
16    // Create an instance of Configuration
17    using (var configuration = new Configuration())
18    {
19        // Limit JS execution time to 5 seconds
20        var runtimeService = configuration.GetService<IRuntimeService>();
21        runtimeService.JavaScriptTimeout = TimeSpan.FromSeconds(5);
22
23        // Initialize an SVG document with specified configuration
24        using (var document = new SVGDocument(Path.Combine(OutputDir, "runtime.svg"), configuration))
25        {
26            // Convert SVG to PNG
27            Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "runtime.png"));
28        }
29    }

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:

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.
Para crear un controlador de mensajes personalizado, debe definir su propia clase que se derivará de la clase MessageHandler. Construimos una clase LogMessageHandler.
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.

 1using Aspose.Svg.Net;
 2using System.Collections.Generic;
 3using System.Net;
 4...
 5
 6    // Define LogMessageHandler that is derived from the MessageHandler class
 7    public class LogMessageHandler : MessageHandler
 8    {
 9        private List<string> errors = new List<string>();
10
11        public List<string> ErrorMessages
12        {
13            get { return errors; }
14        }
15
16        // Override the Invoke() method
17        public override void Invoke(INetworkOperationContext context)
18        {
19            // Check whether response is OK
20            if (context.Response.StatusCode != HttpStatusCode.OK)
21            {
22                // Set error information
23                errors.Add(string.Format("File '{0}' Not Found", context.Request.RequestUri));
24            }
25
26            // Invoke the next message handler in the chain
27            Next(context);
28        }
29    }

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.

 1using System.IO;
 2using Aspose.Svg;
 3using Aspose.Svg.Services;
 4using Aspose.Svg.Converters;
 5using Aspose.Svg.Saving;
 6using Aspose.Svg.Net;
 7...
 8
 9    // Prepare SVG code and save it to a file
10    var code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
11               "    <image href=\"https://docs.aspose.com/svg/images/drawing/park.jpg\" width=\"640px\" height=\"480px\" />\r\n" +
12               "    <image href=\"https://docs.aspose.com/svg/net/missing1.svg\" width=\"400px\" height=\"300px\" />\r\n" +
13               "    <image href=\"https://docs.aspose.com/svg/net/missing2.svg\" width=\"400px\" height=\"300px\" />\r\n" +
14               "</svg>\r\n";
15
16    File.WriteAllText(Path.Combine(OutputDir, "network.svg"), code);
17
18    // Create an instance of the Configuration class
19    using (var configuration = new Configuration())
20    {
21        // Add LogMessageHandler to the chain of existing message handlers for logging errors
22        var networkService = configuration.GetService<INetworkService>();
23        
24        var logHandler = new LogMessageHandler();
25        networkService.MessageHandlers.Add(logHandler);
26
27        // Initialize an SVG document with specified configuration
28        using (var document = new SVGDocument(Path.Combine(OutputDir, "network.svg"), configuration))
29        {
30            // Convert SVG to PNG
31            Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "network.png"));
32
33            // Print the List of ErrorMessages
34            foreach (string errorMessage in logHandler.ErrorMessages)
35            {
36                Console.WriteLine(errorMessage);
37            }
38        }
39    }

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.

Guardar un documento SVG Navegación e inspección SVG