Конфигурация среды – Aspose.SVG for .NET

Настройка конфигурации среды используется для различных целей. Например, когда вы разрабатываете приложение, вам обязательно потребуется некоторая конфигурация, которая может варьироваться от службы времени выполнения или обработки любых веб-запросов из приложения до внедрения пользовательских тем.

В этом руководстве вы узнаете, как создавать различные конфигурации и адаптировать их к различным средам, в которых работает приложение. Это может быть пользовательская тема, служба времени выполнения или сетевая служба веб-запросов.

Пространство имен Aspose.Svg.Services содержит набор интерфейсов для реализации отдельных сервисов. В этой статье рассматриваются различные типы служб настройки среды, такие как Служба пользовательского агента, Служба выполнения и Сетевая служба. Aspose.SVG для .NET предоставляет класс Configuration, который можно использовать для настройки среды, в которой работает приложение.

Служба пользовательского агента – User Agent Service

User Agent Service позволяет указать пользовательскую таблицу стилей, основной набор символов для документа, настройки языка и шрифтов. Вы можете выбрать информацию о собственном стиле для конкретного документа и внести столько изменений в конфигурацию среды, сколько необходимо.

Интерфейс IUserAgentService описывает среду пользовательского агента.

Свойство UserStyleSheet интерфейса IUserAgentService позволяет указать информацию о стиле для конкретного документа;
Свойство CharSet устанавливает основной набор символов для документа.
Чтобы правильно проанализировать и отобразить документ SVG, приложение должно знать, какая кодировка используется. Если кодировка символов не указана напрямую в заголовке документа, Aspose.SVG использует UTF-8, который определен по умолчанию. Однако если вы уверены, что ваш SVG-документ написан с использованием кодировки, отличной от UTF-8, вы можете указать ее вручную, как показано в примере выше.
Свойство FontsSettings используется для настройки обработки шрифтов. Если вам нужно использовать пользовательские шрифты вместо шрифтов, установленных в ОС, вы можете указать путь к своей пользовательской папке, как показано в следующем фрагменте кода.
Свойство CSSEngineMode получает или устанавливает режим работы CSS-движка.
Свойство Language определяет основной язык содержимого элемента и любого атрибута элемента, содержащего текст.

Рассмотрим пример, иллюстрирующий применение свойств UserStyleSheet, CharSet и FontsSettings:

1using System.IO;
2using Aspose.Svg;
3using Aspose.Svg.Services;
4using Aspose.Svg.Converters;
5using Aspose.Svg.Saving;

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

Example-CustomUserAgentSvg.cs hosted with ❤ by GitHub

На рисунке показан результат применения User Agent Service (b) к исходному файлу user-agent.svg (a).

Text «Визуализация файлов «user-agent.svg» и «user-agent.pdf»»

Служба выполнения – Runtime Service

При планировании запуска приложения вам может потребоваться конфигурация службы времени выполнения. Этот сервис дает вам контроль над временем жизни внутренних процессов. Например, используя IRuntimeService вы можете указать таймауты для JavaScript. Наличие такого таймаута важно в том случае, если скрипт содержит бесконечный цикл. Следующий фрагмент кода демонстрирует, как использовать таймауты.

1using System.IO;
2using Aspose.Svg;
3using Aspose.Svg.Services;
4using Aspose.Svg.Converters;
5using Aspose.Svg.Saving;

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

Example-LimitSvgRuntime.cs hosted with ❤ by GitHub

Свойство JavaScriptTimeout устанавливает параметр TimeSpan, который ограничивает время выполнения JavaScript. Если скрипт выполняется дольше, чем указано в TimeSpan, он будет отменен. Значение по умолчанию – 1 минута.

Сетевая служба – Network Service

Современные сетевые среды генерируют значительное количество событий безопасности и регистрируют данные через сетевые маршрутизаторы и коммутаторы, серверы, системы защиты от вредоносных программ и т. д.

Aspose.SVG for .NET предлагает INetworkService, который задуман как решение, помогающее управлять и анализировать всю эту информацию. Сервис позволяет вам контролировать весь входящий/исходящий трафик и реализовывать собственные обработчики сообщений. Его можно использовать для различных целей, например для создания собственного механизма кэширования, отслеживания/регистрации сообщений запросов и т. д.

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

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

Используйте необходимое пространство имен, то есть Aspose.Svg.Net. Это пространство имен представлено классами и интерфейсами, которые отвечают за упрощение сетевой обработки.
Чтобы создать собственный обработчик сообщений, вам необходимо определить собственный класс, который будет производным от класса MessageHandler. Мы создаем класс LogMessageHandler.
Переопределите метод Invoke() класса MessageHandler, чтобы реализовать собственное поведение обработчика сообщений.

В следующем примере показано, как создать LogMessageHandler для регистрации информации о недоступных ресурсах.

1using Aspose.Svg.Net;
2using System.Collections.Generic;
3using System.Net;

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

Example-LogMessageHandler.cs hosted with ❤ by GitHub

Дополнительную информацию о создании пользовательских обработчиков сообщений вы найдете в главе Обработчики сообщений.

Используйте LogMessageHandler для регистрации информации о недоступных ресурсах

В следующем примере показано, как использовать класс LogMessageHandler для регистрации информации о недоступных ресурсах.

1using System.IO;
2using Aspose.Svg;
3using Aspose.Svg.Services;
4using Aspose.Svg.Converters;
5using Aspose.Svg.Saving;
6using Aspose.Svg.Net;

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

Example-LogSvgNetworkErrors.cs hosted with ❤ by GitHub

После запуска примера:

созданный файл “network.svg” будет конвертирован в PNG. В файле только одно изображение;
Будет напечатан список ErrorMessages:

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

Вы можете загрузить полные примеры и файлы данных с GitHub. О загрузке с GitHub и запуске примеров вы узнаете из раздела Как запускать примеры.

Как оптимизировать SVG-документы Как создать NFT?