Класс TrustManagerFactory

java.lang.Object

javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory extends Object

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

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

PKIX

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

С момента появления:

1.4

Внешние спецификации

См. также:

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

TrustManagerFactory(TrustManagerFactorySpi factorySpi,
 Provider provider,
 String algorithm)

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

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

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

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

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

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, или значение по умолчанию, специфичное для реализации, если такое свойство отсутствует.

См. также:

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 Reference Implementation дополнительно использует свойство jdk.security.provider.preferred Security, чтобы определить предпочтительный порядок поставщиков для указанного алгоритма. Этот порядок может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders().

Параметры:

algorithm — стандартное имя запрашиваемого алгоритма управления доверием. Сведения о стандартных именах алгоритмов см. в разделе TrustManagerFactory спецификации стандартных имён алгоритмов безопасности Java.

Возвращает:

новый объект TrustManagerFactory

Вызывает:

NoSuchAlgorithmException — если ни один Provider не поддерживает реализацию TrustManagerFactorySpi для указанного алгоритма

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

getInstance

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

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

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

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

Параметры:

provider — имя поставщика.

Возвращает:

новый объект TrustManagerFactory

Вызывает:

IllegalArgumentException — если имя поставщика равно null или пусто

NoSuchAlgorithmException — если у указанного поставщика отсутствует реализация TrustManagerFactorySpi для указанного алгоритма

NoSuchProviderException — если указанный поставщик не зарегистрирован в списке поставщиков безопасности

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

getInstance

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

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

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

Параметры:

provider — экземпляр поставщика.

Возвращает:

новый объект TrustManagerFactory

Вызывает:

IllegalArgumentException — если поставщик равен null

NoSuchAlgorithmException — если у указанного объекта Provider отсутствует реализация TrustManagerFactorySpi для указанного алгоритма

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

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, 2025, 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.