Класс TrustManagerFactory

java.lang.Object

javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory extends Object

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

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

PKIX

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

Since:

1.4

См. также:

TrustManager

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

TrustManagerFactory(TrustManagerFactorySpi factorySpi,
 Provider provider,
 String algorithm)

Модификатор	Конструктор	Описание
`protected`	Создаёт объект TrustManagerFactory.

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

Модификатор и тип	Метод	Описание
`final String`	`getAlgorithm()`	Возвращает имя алгоритма этого `TrustManagerFactory` объекта.
`static final String`	`getDefaultAlgorithm()`	Получает имя алгоритма по умолчанию для TrustManagerFactory.
`static final TrustManagerFactory`	`getInstance(String algorithm)`	Возвращает объект, который выступает в роли фабрики для менеджеров доверия.
`static final TrustManagerFactory`	`getInstance(String algorithm, String provider)`	Возвращает объект, который выступает в роли фабрики для менеджеров доверия.
`static final TrustManagerFactory`	`getInstance(String algorithm, Provider provider)`	Возвращает объект, который выступает в роли фабрики для менеджеров доверия.
`final Provider`	`getProvider()`	Возвращает поставщика этого `TrustManagerFactory` объекта.
`final TrustManager[]`	`getTrustManagers()`	Возвращает один менеджер доверия для каждого типа данных доверия.
`final void`	`init(KeyStore ks)`	Инициализирует эту фабрику источником сертификатов уполномоченных органов и связанных данных доверия.
`final 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 - стандартное имя запрашиваемого алгоритма управления доверием. См. раздел TrustManagerFactory в спецификации 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 от указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков безопасности.

Параметры:

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 - экземпляр поставщика.

Возвращает:

новый объект 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 - если фабрика не инициализирована.

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/javax/net/ssl/TrustManagerFactory.html