Класс Provider

@Deprecated(since="9") protected Provider(String name, double version, String info)

Создаёт Provider с указанным именем, номером версии и информацией. Вызов этого конструктора эквивалентен вызову Provider(String, String, String) с name именем, Double.toString(version), и info.

protected Provider(String name, String versionStr, String info)

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

Строка версии содержит номер версии, за которым необязательно следуют другие сведения, разделённые одним из символов '+', '-'. Формат номера версии:

     ^[0-9]+(\.[0-9]+)*
 

Для возвращения номера версии в виде double, когда есть более двух компонентов (разделённых '.', как определено выше), сохраняются только первые два компонента. Полученная строка затем передаётся в Double.valueOf(String) для получения номера версии, т.е. getVersion().

Если преобразование не удалось, используется значение 0.

public Provider configure(String configArg)

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

public boolean isConfigured()

Проверяет, был ли настроен этот экземпляр Provider.

public String getName()

Возвращает имя этого Provider.

@Deprecated(since="9") public double getVersion()

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

public String getVersionStr()

Возвращает строку версии для этого Provider.

public String getInfo()

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

public String toString()

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

public void clear()

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

Если включён менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "clearProviderProperties."+name (где name - имя поставщика), чтобы узнать, можно ли очистить этого поставщика.

public void load(InputStream inStream) throws IOException

Считывает список свойств (пар ключ-значение) из потока ввода.

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

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

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

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

public Set<Object> keySet()

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

public Collection<Object> values()

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

public Object put(Object key, Object value)

Устанавливает свойство key со значением value.

Если включён менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name - имя поставщика, чтобы узнать, можно ли установить значения свойств этого поставщика.

public Object putIfAbsent(Object key, Object value)

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

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств этого поставщика.

public Object remove(Object key)

Удаляет свойство key (и соответствующее ему value).

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "removeProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли удалять свойства этого поставщика.

public boolean remove(Object key, Object value)

Удаляет запись для указанного ключа только в том случае, если она в настоящее время сопоставлена ​​с указанным значением.

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "removeProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли удалять свойства этого поставщика.

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

Заменяет запись для указанного ключа только в том случае, если она в настоящее время сопоставлена ​​с указанным значением.

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств этого поставщика.

public Object replace(Object key, Object value)

Заменяет запись для указанного ключа только в том случае, если она в настоящее время сопоставлена ​​с каким-либо значением.

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств этого поставщика.

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

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

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств этого поставщика.

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

Попытка вычислить сопоставление для указанного ключа и его текущего сопоставленного значения (или null, если текущего сопоставления нет).

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строками "putProviderProperty."+name и "removeProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств и удалять свойства этого поставщика.

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

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

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строками "putProviderProperty."+name и "removeProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств и удалять свойства этого поставщика.

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

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

Если включен менеджер безопасности, его метод checkSecurityAccess вызывается со строками "putProviderProperty."+name и "removeProviderProperty."+name, где name — имя поставщика, чтобы проверить, разрешено ли устанавливать значения свойств и удалять свойства этого поставщика.

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

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

Если включён менеджер безопасности, его метод checkSecurityAccess вызывается со строками "putProviderProperty."+name и "removeProviderProperty."+name, где name — имя поставщика, чтобы убедиться, что можно установить значения свойств этого поставщика и удалить свойства этого поставщика.

public Object getOrDefault(Object key, Object defaultValue)

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

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

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

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

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

public Set<Provider.Service> getServices()

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

protected void putService(Provider.Service s)

Добавить сервис. Если сервис того же типа с тем же именем алгоритма существует, и он был добавлен с помощью putService(), он заменяется новым сервисом. Этот метод также помещает информацию об этом сервисе в таблицу хеширования значений поставщика в формате, описанном в руководстве по архитектуре криптографии Java (JCA).

Также, если существует менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "putProviderProperty."+name, где name — имя поставщика, чтобы убедиться, что можно установить значения свойств этого поставщика. Если используется стандартная реализация checkSecurityAccess (то есть этот метод не переопределён), это приводит к вызову метода менеджера безопасности checkPermission с разрешением SecurityPermission("putProviderProperty."+name).

protected void removeService(Provider.Service s)

Удалить сервис, добавленный ранее с помощью putService(). Указанный сервис удаляется из этого Provider. Он больше не будет возвращаться методом getService(), и его информация будет удалена из таблицы хеширования этого поставщика.

Также, если существует менеджер безопасности, его метод checkSecurityAccess вызывается со строкой "removeProviderProperty."+name, где name — имя поставщика, чтобы убедиться, что можно удалить свойства этого поставщика. Если используется стандартная реализация checkSecurityAccess (то есть этот метод не переопределён), это приводит к вызову метода менеджера безопасности checkPermission с разрешением SecurityPermission("removeProviderProperty."+name).