Класс Provider

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

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

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

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

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

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

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

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

public Provider configure(String configArg)

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

public boolean isConfigured()

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

public String getName()

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

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

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

public String getVersionStr()

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

public String getInfo()

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

public String toString()

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

public void clear()

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

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

public void load(InputStream inStream) throws IOException

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

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

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

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

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

public Set<Object> keySet()

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

public Collection<Object> values()

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

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()

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

protected void putService(Provider.Service s)

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

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

protected void removeService(Provider.Service s)

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

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