Класс TrustManagerFactory

java.lang.Object
- javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory
extends Object

Этот класс служит фабрикой для менеджеров доверия, основанных на источнике материалов доверия. Каждый менеджер доверия управляет определённым типом материалов доверия, используемых защищёнными сокетами. Материалы доверия основаны на KeyStore и/или поставщиках специфических источников.

Каждая реализация Java платформы обязана поддерживать следующие стандартные TrustManagerFactory алгоритмы:

PKIX

Этот алгоритм описан в разделе TrustManagerFactory спецификации стандартных имён алгоритмов Java Security. Обратитесь к документации выпуска вашей реализации, чтобы узнать, поддерживаются ли другие алгоритмы.

С:: 1.4
См. также:: TrustManager

Краткое описание конструкторов

Модификатор	Конструктор	Описание
`protected`	`TrustManagerFactory(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm)`	Создаёт объект TrustManagerFactory.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getAlgorithm()`	Возвращает имя алгоритма этого объекта `TrustManagerFactory`.
`static String`	`getDefaultAlgorithm()`	Получает имя алгоритма по умолчанию для TrustManagerFactory.
`static TrustManagerFactory`	`getInstance(String algorithm)`	Возвращает объект `TrustManagerFactory`, который служит фабрикой для менеджеров доверия.
`static TrustManagerFactory`	`getInstance(String algorithm, String provider)`	Возвращает объект `TrustManagerFactory`, который служит фабрикой для менеджеров доверия.
`static TrustManagerFactory`	`getInstance(String algorithm, Provider provider)`	Возвращает объект `TrustManagerFactory`, который служит фабрикой для менеджеров доверия.
`Provider`	`getProvider()`	Возвращает поставщика этого объекта `TrustManagerFactory`.
`TrustManager[]`	`getTrustManagers()`	Возвращает по одному менеджеру доверия для каждого типа материалов доверия.
`void`	`init(KeyStore ks)`	Инициализирует эту фабрику источником сертификатов уполномоченных организаций и связанных материалов доверия.
`void`	`init(ManagerFactoryParameters spec)`	Инициализирует эту фабрику источником материалов доверия, специфичных для поставщика.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

TrustManagerFactory

protected TrustManagerFactory(TrustManagerFactorySpi factorySpi,
                              Provider provider,
                              String algorithm)

Создаёт объект TrustManagerFactory.

Параметры:: factorySpi - делегат; provider - поставщик; algorithm - алгоритм

Подробное описание методов

getDefaultAlgorithm

public static final String getDefaultAlgorithm()

Получает имя алгоритма по умолчанию для TrustManagerFactory.

Менеджер доверия по умолчанию может быть изменён во время выполнения, задав значение свойства безопасности ssl.TrustManagerFactory.algorithm до желаемого имени алгоритма.

Возвращает:: имя алгоритма по умолчанию, указанное в свойстве безопасности ssl.TrustManagerFactory.algorithm, или алгоритм по умолчанию, специфичный для реализации, если такое свойство не существует.
См. также:: security properties

getAlgorithm

public final String getAlgorithm()

Возвращает имя алгоритма этого объекта TrustManagerFactory.

Это то же имя, которое было указано в одном из getInstance вызовов, которые создали этот объект TrustManagerFactory.

Возвращает:: имя алгоритма этого объекта TrustManagerFactory

getInstance

public static final TrustManagerFactory getInstance(String algorithm)
                                             throws NoSuchAlgorithmException

Возвращает объект TrustManagerFactory, который служит фабрикой для менеджеров доверия.

Этот метод перебирает список зарегистрированных поставщиков безопасности, начиная с наиболее предпочтительного. Возвращается новый объект TrustManagerFactory, инкапсулирующий реализацию TrustManagerFactorySpi от первого поставщика, который поддерживает указанный алгоритм.

Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().

Примечание реализации:: Реализация JDK дополнительно использует свойство jdk.security.provider.preferred Security, чтобы определить порядок предпочтительных поставщиков для указанного алгоритма. Это может отличаться от порядка поставщиков, возвращаемого методом Security.getProviders().
Параметры:: algorithm - стандартное имя запрошенного алгоритма управления доверием. См. документ Java Security Standard Algorithm Names для получения информации о стандартных именах алгоритмов.
Возвращает:: новый объект TrustManagerFactory
Исключения:: NoSuchAlgorithmException - если ни один Provider не поддерживает реализацию TrustManagerFactorySpi для указанного алгоритма; NullPointerException - если algorithm null
См. также:: Provider

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                                                    String provider)
                                             throws NoSuchAlgorithmException,
                                                    NoSuchProviderException

Возвращает объект TrustManagerFactory, который служит фабрикой для менеджеров доверия.

Возвращается новый объект KeyManagerFactory, инкапсулирующий реализацию KeyManagerFactorySpi от указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков безопасности.

Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().

Параметры:: algorithm - стандартное имя запрошенного алгоритма управления доверием. См. документ Java Security Standard Algorithm Names для получения информации о стандартных именах алгоритмов.; provider - имя поставщика.
Возвращает:: новый объект TrustManagerFactory
Исключения:: IllegalArgumentException - если имя поставщика null или пустое; NoSuchAlgorithmException - если реализация TrustManagerFactorySpi для указанного алгоритма недоступна от указанного поставщика; NoSuchProviderException - если указанный поставщик не зарегистрирован в списке поставщиков безопасности; NullPointerException - если algorithm null
См. также:: Provider

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                                                    Provider provider)
                                             throws NoSuchAlgorithmException

Возвращает объект TrustManagerFactory, который служит фабрикой для менеджеров доверия.

Возвращается новый объект TrustManagerFactory, инкапсулирующий реализацию TrustManagerFactorySpi от указанного объекта Provider. Обратите внимание, что указанный объект Provider не обязательно должен быть зарегистрирован в списке поставщиков.

Параметры:: algorithm - стандартное имя запрошенного алгоритма управления доверием. См. документ Java Security Standard Algorithm Names для получения информации о стандартных именах алгоритмов.; provider - экземпляр поставщика.
Возвращает:: новый объект TrustManagerFactory
Исключения:: IllegalArgumentException - если поставщик null; NoSuchAlgorithmException - если реализация TrustManagerFactorySpi для указанного алгоритма недоступна от указанного объекта Provider; NullPointerException - если algorithm null
См. также:: Provider

getProvider

public final Provider getProvider()

Возвращает поставщика этого объекта TrustManagerFactory.

Возвращает:: поставщик этого объекта TrustManagerFactory

init

public final void init(KeyStore ks)
                throws KeyStoreException

Инициализирует эту фабрику источником сертификатов уполномоченных организаций и связанных материалов доверия.

Поставщик обычно использует KeyStore в качестве основы для принятия решений о доверии.

Для более гибкой инициализации, пожалуйста, см. init(ManagerFactoryParameters).

Параметры:: ks - хранилище ключей, или null
Исключения:: KeyStoreException - если эта операция завершается ошибкой

init

public final void init(ManagerFactoryParameters spec)
                throws InvalidAlgorithmParameterException

Инициализирует эту фабрику источником материалов доверия, специфичных для поставщика.

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

Параметры:: spec - реализация спецификации параметров, специфичной для поставщика
Исключения:: InvalidAlgorithmParameterException - если возникла ошибка

getTrustManagers

public final TrustManager[] getTrustManagers()

Возвращает по одному менеджеру доверия для каждого типа материалов доверия.

Возвращает:: менеджеры доверия
Исключения:: IllegalStateException - если фабрика не инициализирована.