compact1, compact2, compact3

java.security

Class Provider

java.lang.Object

java.util.Dictionary<K,V>

java.util.Hashtable<Object,Object>

java.util.Properties

java.security.Provider

All Implemented Interfaces:

Serializable， Cloneable， Map < Object， Object >

已知直接子类：

AuthProvider

public abstract class Provider
extends Properties

这类代表一个“提供者”为java安全API，其中一个供应商实现部分或全部的java安全部件。服务提供商可以实现包括：

• 算法（DSA，RSA，MD5或SHA-1）。
• 密钥生成、转换和管理设施（如算法特定键）。

每个提供程序都有一个名称和一个版本号，并在每一个运行时它被安装在。

在看到“java加密体系API规范和参考”The Provider Class为关于一个特定类型的供应商信息，加密服务提供程序、工程和安装。但是，请注意，一个供应商可以用来实现任何安全服务，使用java插件架构与选择符合下面的实现。

一些供应商可能会遇到不可恢复的错误实现内部经营过程中，例如一个失效与安全令牌传递。一个ProviderException应该用来表示这样的错误。

服务型Provider预留使用的安全框架。无法添加此类型的服务，或通过应用程序进行修改或修改。下列属性被自动放置在每个提供程序对象中：

Attributes Automatically Placed in a Provider Object

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

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Provider.Service 安全服务的描述。

Field Summary

Fields inherited from class java.util.Properties

defaults

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Provider(String name, double version, String info) 使用指定的名称、版本号和信息构造一个提供程序。

方法摘要

Modifier and Type	Method and Description
void	clear() 清除此提供程序，以便它不再包含用于查找由提供程序实现的设备的属性。
Object	compute(Object key, BiFunction<? super Object,? super Object,? extends Object> remappingFunction) 试图计算出指定键和当前的映射值的映射（或 null如果没有当前映射）。
Object	computeIfAbsent(Object key, Function<? super Object,? extends Object> mappingFunction) 如果指定的键是不是已经与价值相关的（或映射到 null），尝试使用给定的映射功能，进入到这个Map除非 null计算其价值。
Object	computeIfPresent(Object key, BiFunction<? super Object,? super Object,? extends Object> remappingFunction) 如果指定键的值是存在和非空的，尝试计算一个新的映射，给出了键和它当前的映射值。
Enumeration<Object>	elements() 返回哈希表中的值的枚举。
Set<Map.Entry<Object,Object>>	entrySet() 返回一个不可修改的设置视图的属性条目包含在该提供商。
void	forEach(BiConsumer<? super Object,? super Object> action) 在该映射中的每个条目执行给定的操作，直到所有的条目被处理或操作抛出异常。
Object	get(Object key) 返回指定的键映射的值，或 null如果这个Map不包含的键映射。
String	getInfo() 返回一个可读取的提供者和它的服务的可读描述。
String	getName() 返回此提供程序的名称。
Object	getOrDefault(Object key, Object defaultValue) 返回指定的键映射的值，或 defaultValue如果这个Map不包含的键映射。
String	getProperty(String key) 在这个属性列表中搜索指定的键的属性。
Provider.Service	getService(String type, String algorithm) 获取描述此提供程序的指定类型的该算法或别名的实现的服务。
Set<Provider.Service>	getServices() 得到所有服务支持的一个不可修改的设置提供程序。
double	getVersion() 返回此提供程序的版本号。
Enumeration<Object>	keys() 返回哈希表中的键枚举。
Set<Object>	keySet() 返回一个不可修改的设置视图的属性包含在该提供商的钥匙。
void	load(InputStream inStream) 从输入流读取属性列表（键和元素对）。
Object	merge(Object key, Object value, BiFunction<? super Object,? super Object,? extends Object> remappingFunction) 如果指定的键已与一个值关联或与空关联，则将其与给定值关联。
Object	put(Object key, Object value) 设置有指定的 value的 key财产。
void	putAll(Map<?,?> t) 从指定的映射到此提供程序复制所有的映射。
Object	putIfAbsent(Object key, Object value) 如果指定的键是不是已经与价值相关的（或映射到 null）将其与给定的值并返回 null，否则返回当前值。
protected void	putService(Provider.Service s) 添加服务。
Object	remove(Object key) 删除 key财产（及其相应的 value）。
boolean	remove(Object key, Object value) 仅当它当前映射到指定的值时，为指定的键移除条目。
protected void	removeService(Provider.Service s) 删除以前添加的使用 putService()服务。
Object	replace(Object key, Object value) 仅当它当前映射到某一值时，替换指定的键的条目。
boolean	replace(Object key, Object oldValue, Object newValue) 仅当当前映射到指定的值时，替换指定的键的条目。
void	replaceAll(BiFunction<? super Object,? super Object,? extends Object> function) 用调用给定函数的结果来替换每个条目的值，在顺序条目中返回一个条目集的迭代器，直到所有的条目被处理或函数抛出异常。
String	toString() 返回此提供程序的名称和版本号的字符串。
Collection<Object>	values() 返回一个不可修改的集合视图的属性值包含在该提供商。

Methods inherited from class java.util.Properties

getProperty, list, list, load, loadFromXML, propertyNames, save, setProperty, store, store, storeToXML, storeToXML, stringPropertyNames

Methods inherited from class java.util.Hashtable

clone, contains, containsKey, containsValue, equals, hashCode, isEmpty, rehash, size

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

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

清除此提供程序，以便它不再包含用于查找由提供程序实现的设备的属性。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"clearProviderProperties."+name（其中name是提供者的名称）是否可以明确该提供商。

Specified by:

clear 接口 Map<Object,Object>

重写：

clear 方法重写，继承类 Hashtable<Object,Object>

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问明确该提供商

从以下版本开始：

一点二

load

public void load(InputStream inStream)
          throws IOException

从输入流读取属性列表（键和元素对）。

重写：

load 方法重写，继承类 Properties

参数

inStream -输入流。

异常

IOException如果当读取输入流时发生了一个错误。

另请参见：

Properties.load(java.io.Reader)

putAll

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

从指定的映射到此提供程序复制所有的映射。这些映射将替换此提供程序在指定的映射中的任何键的任何属性。

Specified by:

putAll 接口 Map<Object,Object>

重写：

putAll 方法重写，继承类 Hashtable<Object,Object>

参数

t映射被存储在这个Map

从以下版本开始：

一点二

entrySet

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

返回一个不可修改的设置视图的属性条目包含在该提供商。

Specified by:

entrySet 接口 Map<Object,Object>

重写：

entrySet 方法重写，继承类 Hashtable<Object,Object>

结果

映射中包含的映射的一个集合视图

从以下版本开始：

一点二

另请参见：

Map.Entry

keySet

public Set<Object> keySet()

返回一个不可修改的设置视图的属性包含在该提供商的钥匙。

Specified by:

keySet 接口 Map<Object,Object>

重写：

keySet 方法重写，继承类 Hashtable<Object,Object>

结果

在这个Map中包含的键的一个集合视图

从以下版本开始：

一点二

values

public Collection<Object> values()

返回一个不可修改的集合视图的属性值包含在该提供商。

Specified by:

values 接口 Map<Object,Object>

重写：

values 方法重写，继承类 Hashtable<Object,Object>

结果

一个包含在这个Map中的值的集合视图

从以下版本开始：

一点二

put

public Object put(Object key,
                  Object value)

设置有指定的 value的 key财产。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。

Specified by:

put 接口 Map<Object,Object>

重写：

put 方法重写，继承类 Hashtable<Object,Object>

参数

key -哈希表中的键

value -价值

结果

对哈希表中指定的键以前的值，或者如果它没有 null

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

从以下版本开始：

一点二

另请参见：

Object.equals(Object)， Hashtable.get(Object)

putIfAbsent

public Object putIfAbsent(Object key,
                          Object value)

如果指定的键是不是已经与价值相关的（或映射到 null）将其与给定的值并返回 null，否则返回当前值。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。

Specified by:

putIfAbsent 接口 Map<Object,Object>

重写：

putIfAbsent 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定的值是相关联的

value值必须与指定键关联

结果

与指定的键相关联的前一个值，或 null如果没有键映射。（一 null返回也表明，与先前的 nullMap的关键，如果实施支持空值。）

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

从以下版本开始：

一点八

remove

public Object remove(Object key)

删除 key财产（及其相应的 value）。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以删除该供应商的性质。

Specified by:

remove 接口 Map<Object,Object>

重写：

remove 方法重写，继承类 Hashtable<Object,Object>

参数

key -需要去除的关键

结果

价值的关键是哈希表中的键映射，或 null如果没有映射

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问删除该供应商的性质。

从以下版本开始：

一点二

remove

public boolean remove(Object key,
                      Object value)

仅当它当前映射到指定的值时，为指定的键移除条目。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以删除该供应商的性质。

Specified by:

remove 接口 Map<Object,Object>

重写：

remove 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定值相关联的

value值将与指定键关联

结果

true如果值被删除

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问删除该供应商的性质。

从以下版本开始：

一点八

replace

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

仅当当前映射到指定的值时，替换指定的键的条目。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。

Specified by:

replace 接口 Map<Object,Object>

重写：

replace 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定值相关联的

oldValue值将与指定键关联

newValue值必须与指定键关联

结果

true如果值代替

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

从以下版本开始：

一点八

replace

public Object replace(Object key,
                      Object value)

仅当它当前映射到某一值时，替换指定的键的条目。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。

Specified by:

replace 接口 Map<Object,Object>

重写：

replace 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定值相关联的

value值必须与指定键关联

结果

与指定的键相关联的前一个值，或 null如果没有键映射。（一 null返回也表明，与先前的 nullMap的关键，如果实施支持空值。）

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

从以下版本开始：

一点八

replaceAll

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

用调用给定函数的结果来替换每个条目的值，在顺序条目中返回一个条目集的迭代器，直到所有的条目被处理或函数抛出异常。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。

Specified by:

replaceAll 接口 Map<Object,Object>

重写：

replaceAll 方法重写，继承类 Hashtable<Object,Object>

参数

function -功能适用于每一个条目

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

从以下版本开始：

一点八

compute

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

试图计算出指定键和当前的映射值的映射（或 null如果没有当前映射）。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name和"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值和删除该供应商的性质。

Specified by:

compute 接口 Map<Object,Object>

重写：

compute 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定的值是相关联的

remappingFunction的函数来计算一个值

结果

与指定的键相关联的新值，或为空

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值或删除属性。

从以下版本开始：

一点八

computeIfAbsent

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

如果指定的键是不是已经与价值相关的（或映射到 null），尝试使用给定的映射功能，进入到这个Map除非 null计算其价值。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name和"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值和删除该供应商的性质。

Specified by:

computeIfAbsent 接口 Map<Object,Object>

重写：

computeIfAbsent 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定的值是相关联的

mappingFunction的函数来计算一个值

结果

如果计算的值为空，则与指定的键相关联的当前（现有的或计算的）值

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值和删除属性。

从以下版本开始：

一点八

computeIfPresent

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

如果指定键的值是存在和非空的，尝试计算一个新的映射，给出了键和它当前的映射值。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name和"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值和删除该供应商的性质。

Specified by:

computeIfPresent 接口 Map<Object,Object>

重写：

computeIfPresent 方法重写，继承类 Hashtable<Object,Object>

参数

key键与指定的值是相关联的

remappingFunction的函数来计算一个值

结果

与指定的键相关联的新值，或为空

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值或删除属性。

从以下版本开始：

一点八

merge

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

如果指定的键已与一个值关联或与空关联，则将其与给定值关联。否则，替换值的结果与给定的映射函数，或删除如果结果是空的。此方法可以将多个映射值组合在一个键时使用。

如果安全管理器启用，其checkSecurityAccess方法被调用的字符串"putProviderProperty."+name和"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值和删除该供应商的性质。

Specified by:

merge 接口 Map<Object,Object>

重写：

merge 方法重写，继承类 Hashtable<Object,Object>

参数

key键，得到的值是相关联的

value -非空值是与存在价值的关键或相关的合并，如果没有存在的价值或空值与密钥相关的，是与密钥相关的

remappingFunction -函数重新计算值如果存在

结果

与指定的键关联的新值，或如果没有值与密钥相关联的空值

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值或删除属性。

从以下版本开始：

一点八

get

public Object get(Object key)

从阶级复制的描述： Hashtable

返回指定的键映射的值，或 null如果这个Map不包含的键映射。

更正式地说，如果这个图中包含了从关键k到价值v这样(key.equals(k))映射，那么这个方法返回v；否则返回null。（最多可以有一个这样的映射。）

Specified by:

get 接口 Map<Object,Object>

重写：

get 方法重写，继承类 Hashtable<Object,Object>

参数

key -关键的相关值被返回

结果

值，指定的键映射，或 null如果这个Map不包含的键映射

另请参见：

Hashtable.put(Object, Object)

getOrDefault

public Object getOrDefault(Object key,
                           Object defaultValue)

从接口复制的描述： Map

返回指定的键映射的值，或 defaultValue如果这个Map不包含的键映射。

Specified by:

getOrDefault 接口 Map<Object,Object>

重写：

getOrDefault 方法重写，继承类 Hashtable<Object,Object>

参数

key -关键的相关值被返回

defaultValue -键的默认映射

结果

值，指定的键映射，或 defaultValue如果这个Map不包含的键映射

从以下版本开始：

一点八

forEach

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

从接口复制的描述： Map

在该映射中的每个条目执行给定的操作，直到所有的条目被处理或操作抛出异常。除非实现类的其他指定，否则操作在输入集迭代的顺序（如果指定的迭代顺序）中执行。由操作引发的异常被传递给调用方。

Specified by:

forEach 接口 Map<Object,Object>

重写：

forEach 方法重写，继承类 Hashtable<Object,Object>

参数

action将每项执行的动作

从以下版本开始：

一点八

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)

获取描述此提供程序的指定类型的该算法或别名的实现的服务。如果没有这样的实现，此方法返回空。如果有两个匹配服务，一加这个供应商使用 putService()一加 put()，添加服务，通过 putService()返回。

参数

type - service请求类型（例如， MessageDigest）

algorithm -不区分大小写的算法名称（或交替的别名）的服务请求（例如， SHA-1）

结果

如果没有这样的服务，描述此服务提供商的匹配服务或空的服务

异常

NullPointerException如果型或算法是无效的

从以下版本开始：

一点五

getServices

public Set<Provider.Service> getServices()

得到所有服务支持的一个不可修改的设置提供程序。

结果

所有服务支持的一个不可修改的设置提供程序

从以下版本开始：

一点五

putService

protected void putService(Provider.Service s)

添加服务。如果使用相同的算法名称相同类型的服务的存在，增加了使用 putService()，它是由新的服务取代。这种方法也对这个服务信息的格式在 Java Cryptography Architecture API Specification & Reference 描述供应商的哈希值。

另外，如果存在安全管理器，它的checkSecurityAccess方法被调用的字符串"putProviderProperty."+name，哪里name是提供者的名称，看是否可以将此供应商的属性值。如果checkSecurityAccess默认的实现是使用（即，方法不修改），然后这个结果在一个叫保安部经理的checkPermission方法与SecurityPermission("putProviderProperty."+name)许可。

参数

s -服务添加

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问设置属性值。

NullPointerException -如果是空的

从以下版本开始：

一点五

removeService

protected void removeService(Provider.Service s)

删除以前添加的使用 putService()服务。从该提供程序中删除指定的服务。它将不再由 getService()及其返回的信息将被删除从该供应商的哈希表。

另外，如果存在安全管理器，它的checkSecurityAccess方法被调用的字符串"removeProviderProperty."+name，哪里name是提供者的名称，看是否可以删除该供应商的性质。如果checkSecurityAccess默认的实现是使用（即，方法不修改），然后这个结果在一个叫保安部经理的checkPermission方法与SecurityPermission("removeProviderProperty."+name)许可。

参数

s -服务被删除

异常

SecurityException -如果存在一个安全管理及其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问删除该供应商的性质。

NullPointerException -如果是空的

从以下版本开始：

一点五