Класс TrustManagerFactory

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

public class TrustManagerFactory
extends Object

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

Since:: 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, Provider provider)` Возвращает объект `TrustManagerFactory`, который служит фабрикой для менеджеров доверия.
`static TrustManagerFactory`	`getInstance(String algorithm, String 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.

Значение по умолчанию TrustManager можно изменить во время выполнения, задав значение системной переменной 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().

Параметры:: algorithm - стандартное имя запрашиваемого алгоритма управления доверием. См. Java Secure Socket Extension Reference Guide для получения информации о стандартных именах алгоритмов.
Возвращает:: новый объект TrustManagerFactory.
Исключения:: NoSuchAlgorithmException - если ни один поставщик не поддерживает реализацию TrustManagerFactorySpi для указанного алгоритма.; NullPointerException - если algorithm равен null.
См. также:: Provider

getInstance

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

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

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

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

getInstance

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

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

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

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

getProvider

public final Provider getProvider()

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

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

Инициализация

public final void init(KeyStore ks)
                throws KeyStoreException

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

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

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

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

Инициализация

public final void init(ManagerFactoryParameters spec)
                throws InvalidAlgorithmParameterException

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

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

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

Получить менеджеров доверия

public final TrustManager[] getTrustManagers()

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.