Класс TransformService

public abstract class TransformService
extends Object
implements Transform

Интерфейс поставщика сервисов для алгоритмов преобразования и канонизации.

Каждый экземпляр TransformService поддерживает определённый алгоритм преобразования или канонизации и тип механизма XML. Для создания TransformService, вызовите один из статических методов getInstance, передав в него требуемый URI алгоритма и тип механизма XML, например:

TransformService ts = TransformService.getInstance(Transform.XPATH2, "DOM");

Реализации TransformService регистрируются и загружаются с помощью механизма Provider. Каждая реализация поставщика сервисов TransformService должна содержать атрибут сервиса MechanismType, который определяет тип механизма XML, который он поддерживает. Если атрибут не указан, используется "DOM". Например, поставщик сервисов, поддерживающий преобразование XPath Filter 2 и механизм DOM, будет определён в подклассе Provider следующим образом:

put("TransformService." + Transform.XPATH2,
         "org.example.XPath2TransformService");
     put("TransformService." + Transform.XPATH2 + " MechanismType", "DOM");

TransformService реализации, поддерживающие тип механизма DOM, должны соответствовать требованиям межсетевой совместимости DOM, определённым в разделе Требования к механизму DOM обзора API. Список стандартных типов механизмов см. в разделе Поставщики сервисов обзора API.

После создания TransformService, его можно использовать для обработки объектов Transform или CanonicalizationMethod. Если объекты Transform или CanonicalizationMethod существуют в формате XML (например, при валидации существующего XMLSignature), необходимо сначала вызвать метод init(XMLStructure, XMLCryptoContext) для инициализации преобразования и предоставления контекста документа (даже если параметров нет). В противном случае, если объекты Transform или CanonicalizationMethod создаются с нуля, вызывается метод init(TransformParameterSpec) для инициализации преобразования с параметрами, а затем метод marshalParams для сериализации параметров в XML и предоставления преобразованию контекста документа. Наконец, вызывается метод transform для выполнения преобразования.

Доступность в нескольких потоках

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

Однако это не относится к методам, не являющимся статическими, определенным в этом классе. Если не указано иное конкретным поставщиком, потоки, которым необходимо получить одновременный доступ к одному экземпляру TransformService, должны синхронизироваться между собой и обеспечить необходимое блокирование. Несколько потоков, каждый из которых манипулирует разными экземплярами TransformService , синхронизироваться не должны.