Класс Provider

public abstract class Provider
extends Properties

Этот класс представляет "поставщика" для Java Security API, где поставщик реализует некоторые или все части Java Security. Услуги, которые может реализовать поставщик, включают:

• Алгоритмы (такие как DSA, RSA, MD5 или SHA-1).
• Средства генерации, преобразования и управления ключами (например, для ключей, специфичных для алгоритма).

Каждый поставщик имеет имя и номер версии и настраивается в каждой среде выполнения, в которой он установлен.

См. Класс Provider в "Спецификации и справке API архитектуры Java Cryptography" для получения информации о том, как работает и устанавливается конкретный тип поставщика, поставщик криптографических услуг. Однако обратите внимание, что поставщик может использоваться для реализации любой службы безопасности в Java, которая использует архитектуру с подключаемыми реализациями, которые подходят под нее.

Некоторые реализации поставщиков могут столкнуться с невосстановимыми внутренними ошибками во время своей работы, например, с отказом в общении с токеном безопасности. Для указания таких ошибок следует использовать ProviderException.

Тип службы Provider зарезервирован для использования в рамках инфраструктуры безопасности. К услугам этого типа приложения не могут добавляться, удаляться или изменяться. В каждом объекте Provider автоматически размещаются следующие атрибуты:

Имя	Значение
Provider.id name	String.valueOf(provider.getName())
Provider.id version	String.valueOf(provider.getVersion())
Provider.id info	String.valueOf(provider.getInfo())
Provider.id className	provider.getClass().getName()

Конструкторы

Provider

protected Provider(String name,
                   double version,
                   String info)

Создает провайдера с указанным именем, номером версии и информацией.

Параметры:

name - имя провайдера.

version - номер версии провайдера.

info - описание провайдера и его служб.

Методы

getName

public String getName()

Возвращает имя этого провайдера.

Возвращает:

имя этого провайдера.

getVersion

public double getVersion()

Возвращает номер версии для этого провайдера.

Возвращает:

номер версии для этого провайдера.

getInfo

public String getInfo()

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

Возвращает:

описание провайдера и его служб.

toString

public String toString()

Возвращает строку с именем и номером версии этого провайдера.

Переопределяет:

toString в классе Hashtable<Object,Object>

Возвращает:

строку с именем и номером версии для этого провайдера.

clear

public void clear()

Указано в:

clear в интерфейсе Map<Object,Object>

Переопределяет:

clear в классе Hashtable<Object,Object>

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к очистке этого провайдера

С версии:

1.2

load

public void load(InputStream inStream)
          throws IOException

Читает список свойств (пары ключ-элемент) из входного потока.

Переопределяет:

load в классе Properties

Параметры:

inStream - входной поток.

Исключения:

IOException - если произошла ошибка при чтении из входного потока.

См. также:

Properties.load(java.io.Reader)

putAll

public void putAll(Map<?,?> t)

Копирует все сопоставления из указанной карты в этого провайдера. Эти сопоставления заменят любые свойства, которые этот провайдер имел для любых ключей, в настоящее время находящихся в указанной карте.

Указано в:

putAll в интерфейсе Map<Object,Object>

Переопределяет:

putAll в классе Hashtable<Object,Object>

Параметры:

t - сопоставления, которые необходимо сохранить в этой карте

С версии:

1.2

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

Возвращает неизменяемый вид Set записей свойств, содержащихся в этом провайдере.

Указано в:

entrySet в интерфейсе Map<Object,Object>

Переопределяет:

entrySet в классе Hashtable<Object,Object>

Возвращает:

вид набора сопоставлений, содержащихся в этой карте

С версии:

1.2

См. также:

Map.Entry

keySet

public Set<Object> keySet()

Возвращает неизменяемый вид Set ключей свойств, содержащихся в этом провайдере.

Указано в:

keySet в интерфейсе Map<Object,Object>

Переопределяет:

keySet в классе Hashtable<Object,Object>

Возвращает:

вид набора ключей, содержащихся в этой карте

С версии:

1.2

values

public Collection<Object> values()

Возвращает неизменяемый вид Collection значений свойств, содержащихся в этом провайдере.

Указано в:

values в интерфейсе Map<Object,Object>

Переопределяет:

values в классе Hashtable<Object,Object>

Возвращает:

вид коллекции значений, содержащихся в этой карте

С версии:

1.2

put

public Object put(Object key,
                  Object value)

Указано в:

put в интерфейсе Map<Object,Object>

Переопределяет:

put в классе Hashtable<Object,Object>

Параметры:

key - ключ хэш-таблицы

value - значение

Возвращает:

предыдущее значение указанного ключа в этой хэш-таблице или null, если его не было

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

С версии:

1.2

См. также:

Object.equals(Object), Hashtable.get(Object)

putIfAbsent

public Object putIfAbsent(Object key,
                          Object value)

Указано в:

putIfAbsent в интерфейсе Map<Object,Object>

Переопределяет:

putIfAbsent в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым должно быть связано указанное значение

value - значение, которое должно быть связано с указанным ключом

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было сопоставления. (Возвращаемое значение null также может указывать на то, что карта ранее связывала null с ключом, если реализация поддерживает нулевые значения.)

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

С версии:

1.8

remove

public Object remove(Object key)

Указано в:

remove в интерфейсе Map<Object,Object>

Переопределяет:

remove в классе Hashtable<Object,Object>

Параметры:

key - ключ, который необходимо удалить

Возвращает:

значение, с которым ключ был сопоставлен в этой хэш-таблице, или null, если у ключа не было сопоставления

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к удалению свойств этого провайдера.

С версии:

1.2

remove

public boolean remove(Object key,
                      Object value)

Указано в:

remove в интерфейсе Map<Object,Object>

Переопределяет:

remove в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым связано указанное значение

value - значение, которое должно быть связано с указанным ключом

Возвращает:

true если значение было удалено

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к удалению свойств этого провайдера.

С версии:

1.8

replace

public boolean replace(Object key,
                       Object oldValue,
                       Object newValue)

Указано в:

replace в интерфейсе Map<Object,Object>

Переопределяет:

replace в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым связано указанное значение

oldValue - значение, которое должно быть связано с указанным ключом

newValue - значение, которое должно быть связано с указанным ключом

Возвращает:

true если значение было заменено

Исключения:

SecurityException - если существует менеджер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

С версии:

1.8

replace

public Object replace(Object key,
                      Object value)

Указано в:

replace в интерфейсе Map<Object,Object>

Переопределяет:

replace в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым связано указанное значение

value - значение, которое должно быть связано с указанным ключом

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было сопоставления. (Возвращение null также может указывать на то, что карта ранее сопоставляла null с ключом, если реализация поддерживает значения null.)

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

С версии:

1.8

replaceAll

public void replaceAll(BiFunction<? super Object,? super Object,? extends Object> function)

Указано в:

replaceAll в интерфейсе Map<Object,Object>

Переопределяет:

replaceAll в классе Hashtable<Object,Object>

Параметры:

function - функция, которая применяется к каждой записи

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

С версии:

1.8

compute

public Object compute(Object key,
                      BiFunction<? super Object,? super Object,? extends Object> remappingFunction)

Указано в:

compute в интерфейсе Map<Object,Object>

Переопределяет:

compute в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым должно быть связано указанное значение

remappingFunction - функция для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если его нет

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств или удалению свойств.

С версии:

1.8

computeIfAbsent

public Object computeIfAbsent(Object key,
                              Function<? super Object,? extends Object> mappingFunction)

Указано в:

computeIfAbsent в интерфейсе Map<Object,Object>

Переопределяет:

computeIfAbsent в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым должно быть связано указанное значение

mappingFunction - функция для вычисления значения

Возвращает:

текущее (существующее или вычисленное) значение, связанное с указанным ключом, или null, если вычисленное значение равно null

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств и удалению свойств.

С версии:

1.8

computeIfPresent

public Object computeIfPresent(Object key,
                               BiFunction<? super Object,? super Object,? extends Object> remappingFunction)

Указано в:

computeIfPresent в интерфейсе Map<Object,Object>

Переопределяет:

computeIfPresent в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым должно быть связано указанное значение

remappingFunction - функция для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если его нет

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств или удалению свойств.

С версии:

1.8

merge

public Object merge(Object key,
                    Object value,
                    BiFunction<? super Object,? super Object,? extends Object> remappingFunction)

Указано в:

merge в интерфейсе Map<Object,Object>

Переопределяет:

merge в классе Hashtable<Object,Object>

Параметры:

key - ключ, с которым должно быть связано результирующее значение

value - ненулевое значение, которое должно быть объединено с существующим значением, связанным с ключом, или, если с ключом не связано существующее значение или значение null, должно быть связано с ключом

remappingFunction - функция для перевычисления значения, если оно присутствует

Возвращает:

новое значение, связанное с указанным ключом, или null, если с ключом не связано значение

Исключения:

SecurityException - если существует диспетчер безопасности и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств или удалению свойств.

С версии:

1.8

get

public Object get(Object key)

Описание скопировано из класса: Hashtable

Указано в:

get в интерфейсе Map<Object,Object>

Переопределяет:

get в классе Hashtable<Object,Object>

Параметры:

key - ключ, связанное с которым значение должно быть возвращено

Возвращает:

значение, с которым сопоставлен указанный ключ, или null, если эта карта не содержит сопоставления для ключа

См. также:

Hashtable.put(Object, Object)

getOrDefault

public Object getOrDefault(Object key,
                           Object defaultValue)

Описание скопировано из интерфейса: Map

Возвращает значение, с которым сопоставлен указанный ключ, или defaultValue, если эта карта не содержит сопоставления для ключа.

Указано в:

getOrDefault в интерфейсе Map<Object,Object>

Переопределяет:

getOrDefault в классе Hashtable<Object,Object>

Параметры:

key - ключ, связанное с которым значение должно быть возвращено

defaultValue - значение по умолчанию для ключа

Возвращает:

значение, с которым сопоставлен указанный ключ, или defaultValue, если эта карта не содержит сопоставления для ключа

С версии:

1.8

forEach

public void forEach(BiConsumer<? super Object,? super Object> action)

Описание скопировано из интерфейса: Map

Выполняет данное действие для каждой записи в этой карте, пока все записи не будут обработаны или действие не вызовет исключение. Если реализующим классом не указано иное, действия выполняются в порядке итерации множества записей (если порядок итерации указан). Исключения, выброшенные действием, передаются вызывающей стороне.

Указано в:

forEach в интерфейсе Map<Object,Object>

Переопределяет:

forEach в классе Hashtable<Object,Object>

Параметры:

action - Действие, которое должно быть выполнено для каждой записи

С версии:

1.8

keys

public Enumeration<Object> keys()

Описание скопировано из класса: Hashtable

Возвращает перечисление ключей в этой хэш-таблице.

Переопределяет:

keys в классе Hashtable<Object,Object>

Возвращает:

перечисление ключей в этой хеш-таблице.

См. также:

Enumeration, Hashtable.elements(), Hashtable.keySet(), Map

elements

public Enumeration<Object> elements()

Описание скопировано из класса: Hashtable

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

Переопределяет:

elements в классе Hashtable<Object,Object>

Возвращает:

перечисление значений в этой хеш-таблице.

См. также:

Enumeration, Hashtable.keys(), Hashtable.values(), Map

getProperty

public String getProperty(String key)

Описание скопировано из класса: Properties

Ищет свойство с указанным ключом в этом списке свойств. Если ключ не найден в этом списке свойств, проверяется список свойств по умолчанию и его значения по умолчанию рекурсивно. Метод возвращает null , если свойство не найдено.

Переопределяет:

getProperty в классе Properties

Параметры:

key - ключ свойства.

Возвращает:

значение свойства в этом списке свойств с указанным ключом.

См. также:

Properties.setProperty(java.lang.String, java.lang.String), Properties.defaults

getService

public Provider.Service getService(String type,
                                   String algorithm)

Получает описание службы, описывающей реализацию данного поставщика указанного типа этого алгоритма или псевдонима. Если такая реализация не существует, этот метод возвращает null. Если существует две соответствующих службы, одна из которых добавлена в этот поставщик с помощью putService(), а другая — с помощью put(), возвращается служба, добавленная с помощью putService().

Параметры:

type - тип запрашиваемой service (например, MessageDigest)

algorithm - нечувствительное к регистру имя алгоритма (или альтернативный псевдоним) запрашиваемой службы (например, SHA-1)

Возвращает:

службу, описывающую соответствующую службу этого поставщика, или null, если такой службы не существует

Исключения:

NullPointerException - если тип или алгоритм равны null

С:

1.5

getServices

public Set<Provider.Service> getServices()

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

Возвращает:

неизменяемый набор всех служб, поддерживаемых этим поставщиком

С:

1.5

putService

protected void putService(Provider.Service s)

Параметры:

s - добавляемая служба

Исключения:

SecurityException - если менеджер безопасности существует и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к установке значений свойств.

NullPointerException - если s равно null

С:

1.5

removeService

protected void removeService(Provider.Service s)

Параметры:

s - удаляемая служба

Исключения:

SecurityException - если менеджер безопасности существует и его метод SecurityManager.checkSecurityAccess(java.lang.String) запрещает доступ к удалению свойств этого поставщика.

NullPointerException - если s равно null

С:

1.5