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 Security API的“提供者”，其中提供者实现了Java Security的部分或全部部分。 提供商可能实施的服务包括：

• 算法（如DSA，RSA，MD5或SHA-1）。
• 密钥生成，转换和管理功能（如针对特定于算法的密钥）。

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

见The Provider Class在“Java加密体系结构API规范与参考”关于特定类型的供应商，加密服务提供程序，如何工作和安装信息。 但是，请注意，可以使用提供程序来实现Java中使用可插拔架构的任何安全服务，并可选择适合的实现。

一些提供者实现在其操作期间可能会遇到不可恢复的内部错误，例如无法与安全令牌进行通信。 A ProviderException应用于指示此类错误。

服务类型Provider保留供安全框架使用。 这种类型的服务不能被应用程序添加，删除或修改。 以下属性将自动放置在每个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 ），则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非 null 。
Object	computeIfPresent(Object key, BiFunction<? super Object,? super Object,? extends Object> remappingFunction) 如果指定的密钥的值存在且非空，则尝试计算给定密钥及其当前映射值的新映射。
Enumeration<Object>	elements() 返回此散列表中值的枚举。
Set<Map.Entry<Object,Object>>	entrySet() 返回此提供程序中包含的属性条目的不可修改的Set视图。
void	forEach(BiConsumer<? super Object,? super Object> action) 对此映射中的每个条目执行给定的操作，直到所有条目都被处理或操作引发异常。
Object	get(Object key) 返回到指定键所映射的值，或 null如果此映射包含该键的映射。
String	getInfo() 返回提供商及其服务的可读描述。
String	getName() 返回此提供程序的名称。
Object	getOrDefault(Object key, Object defaultValue) 返回到指定键所映射的值，或 defaultValue如果此映射包含该键的映射。
String	getProperty(String key) 使用此属性列表中指定的键搜索属性。
Provider.Service	getService(String type, String algorithm) 获取描述此提供程序实现该算法或别名的指定类型的服务。
Set<Provider.Service>	getServices() 获取不可修改的此提供程序支持的所有服务的集合。
double	getVersion() 返回此提供商的版本号。
Enumeration<Object>	keys() 返回此散列表中键的枚举。
Set<Object>	keySet() 返回此提供程序中包含的属性键的不可修改的Set视图。
void	load(InputStream inStream) 从输入流读取属性列表（键和元素对）。
Object	merge(Object key, Object value, BiFunction<? super Object,? super Object,? extends Object> remappingFunction) 如果指定的键尚未与值相关联或与null关联，则将其与给定值相关联。
Object	put(Object key, Object value) 将 key属性设置为具有指定的 value 。
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

构造方法详细信息

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

清除此提供程序，使其不再包含用于查找由提供程序实施的设施的属性。

如果启用安全管理器，则使用字符串"clearProviderProperties."+name （其中name是提供程序名称）调用其checkSecurityAccess方法，以查看是否可以清除此提供程序。

Specified by:

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)

将指定地图中的所有映射复制到此提供程序。 这些映射将替换此提供者对当前指定的Map中的任何键的任何属性。

Specified by:

putAll在界面 Map<Object,Object>

重写：

putAll在类别 Hashtable<Object,Object>

参数

t - 要存储在此地图中的映射

从以下版本开始：

1.2

entrySet

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

返回此提供程序中包含的属性条目的不可修改的Set视图。

Specified by:

entrySet在界面 Map<Object,Object>

重写：

entrySet在类别 Hashtable<Object,Object>

结果

该地图中包含的映射的集合视图

从以下版本开始：

1.2

另请参见：

Map.Entry

keySet

public Set<Object> keySet()

返回此提供程序中包含的属性键的不可修改的Set视图。

Specified by:

keySet在界面 Map<Object,Object>

重写：

keySet在类别 Hashtable<Object,Object>

结果

该地图中包含的键的集合视图

从以下版本开始：

1.2

values

public Collection<Object> values()

返回此提供程序中包含的属性值的不可修改的集合视图。

Specified by:

values在界面 Map<Object,Object>

重写：

values在类别 Hashtable<Object,Object>

结果

该地图中包含的值的集合视图

从以下版本开始：

1.2

put

public Object put(Object key,
                  Object value)

将key属性设置为具有指定的value 。

如果启用安全管理器，则使用字符串"putProviderProperty."+name调用其checkSecurityAccess方法，其中name是提供程序名称，以查看是否可以设置此提供程序的属性值。

Specified by:

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)

如果指定的键尚未与值相关联（或映射到null ）将其与给定值相关联并返回null ，否则返回当前值。

如果安全管理器被启用，其checkSecurityAccess方法调用带有字符串"putProviderProperty."+name ，其中name是供应商的名字，看它是否可以设置此provider的属性值。

Specified by:

putIfAbsent在界面 Map<Object,Object>

重写：

putIfAbsent在类别 Hashtable<Object,Object>

参数

key - 指定值与之关联的键

value - 与指定键相关联的值

结果

与指定键相关联的上一个值，如果没有键的映射， null 。 （A null返回也可以指示以前关联的映射关系为null ，如果实现支持空值）。

异常

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

从以下版本开始：

1.8

remove

public Object remove(Object key)

删除key属性（及其对应的value ）。

如果启用了安全管理器，则使用字符串"removeProviderProperty."+name调用其checkSecurityAccess方法，其中name是提供程序名称，以查看是否可以删除此提供程序的属性。

Specified by:

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)

仅当指定的密钥当前映射到指定的值时删除该条目。

如果安全管理器已启用，则其checkSecurityAccess方法将使用字符串"removeProviderProperty."+name （其中name是提供程序名称）来调用，以查看是否可以删除此提供程序的属性。

Specified by:

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)

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

如果启用了安全管理器，则使用字符串"putProviderProperty."+name调用其checkSecurityAccess方法，其中name是提供程序名称，以查看是否可以设置此提供程序的属性值。

Specified by:

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)

只有当目标映射到某个值时，才能替换指定键的条目。

如果安全管理器被启用，其checkSecurityAccess方法调用带有字符串"putProviderProperty."+name ，其中name是供应商的名字，看它是否可以设置此provider的属性值。

Specified by:

replace在界面 Map<Object,Object>

重写：

replace在类别 Hashtable<Object,Object>

参数

key - 与指定值相关联的键

value - 与指定键相关联的值

结果

与指定键相关联的上一个值，如果没有键的映射， null 。 （A null返回也可以指示映射以前关联的是null的关键字，如果实现支持空值）。

异常

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

从以下版本开始：

1.8

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)方法拒绝对设置属性值的访问。

从以下版本开始：

1.8

compute

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

尝试计算用于指定键和其当前映射的值的映射（或null如果没有当前映射）。

如果启用安全管理器，则使用字符串"putProviderProperty."+name和"removeProviderProperty."+name调用其checkSecurityAccess方法，其中name是提供程序名称，以查看是否可以设置此提供程序的属性值并删除此提供程序的属性。

Specified by:

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)

如果指定的键尚未与值相关联（或映射到null ），则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非null 。

如果启用安全管理器，则使用字符串"putProviderProperty."+name和"removeProviderProperty."+name （其中name是提供程序名称）调用其checkSecurityAccess方法，以查看是否可以设置此提供程序的属性值并删除此提供程序的属性。

Specified by:

computeIfAbsent在界面 Map<Object,Object>

重写：

computeIfAbsent在类别 Hashtable<Object,Object>

参数

key - 要与其关联的指定值的键

mappingFunction - 计算值的函数

结果

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

异常

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

从以下版本开始：

1.8

computeIfPresent

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

如果指定的密钥的值存在且非空，则尝试计算给定密钥及其当前映射值的新映射。

如果启用安全管理器，则使用字符串"putProviderProperty."+name和"removeProviderProperty."+name调用其checkSecurityAccess方法，其中name是提供程序名称，以查看是否可以设置此提供程序的属性值并删除此提供程序的属性。

Specified by:

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)

如果指定的键尚未与值相关联或与null关联，则将其与给定值相关联。 否则，将该值替换为给定重映射函数的结果，如果结果为空，则将其移除。 当组合键的多个映射值时，该方法可能是有用的。

如果启用安全管理器，则使用字符串"putProviderProperty."+name和"removeProviderProperty."+name （其中name是提供程序名称）调用其checkSecurityAccess方法，以查看是否可以设置此提供程序的属性值并删除此提供程序的属性。

Specified by:

merge在界面 Map<Object,Object>

重写：

merge在类别 Hashtable<Object,Object>

参数

key - 与结果值相关联的键

value - 要与与密钥相关联的现有值合并的非空值，或者如果没有现有值或空值与密钥相关联，则与该密钥相关联

remappingFunction - 重新计算值（如果存在）的功能

结果

与指定键相关联的新值，如果没有值与该键相关联，则返回null

异常

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

从以下版本开始：

1.8

get

public Object get(Object key)

描述从类别： Hashtable复制

返回到指定键所映射的值，或null如果此映射包含该键的映射。

更正式地，如果该地图包含从键k到值v ，使得(key.equals(k)) ，则该方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）

Specified by:

get在界面 Map<Object,Object>

重写：

get在类别 Hashtable<Object,Object>

参数

key - 要返回其关联值的键

结果

指定键映射到的值，如果此映射不包含键的映射， null

另请参见：

Hashtable.put(Object, Object)

getOrDefault

public Object getOrDefault(Object key,
                           Object defaultValue)

说明从界面： Map复制

返回到指定键所映射的值，或 defaultValue如果此映射包含该键的映射。

Specified by:

getOrDefault在界面 Map<Object,Object>

重写：

getOrDefault在类别 Hashtable<Object,Object>

参数

key - 要返回其关联值的键

defaultValue - 键的默认映射

结果

指定键映射到的值，如果此映射不包含键的映射， defaultValue

从以下版本开始：

1.8

forEach

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

说明从界面： Map复制

对此映射中的每个条目执行给定的操作，直到所有条目都被处理或操作引发异常。 除非实现类另有指定，否则按照进入设置迭代的顺序执行操作（如果指定了迭代顺序）。操作引发的异常被转发给调用者。

Specified by:

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 - algorithm服务的不区分大小写的算法名称（或替代别名）（例如， SHA-1 ）

结果

描述此提供商的匹配服务的服务，如果不存在此类服务，则为null

异常

NullPointerException - 如果类型或算法为空

从以下版本开始：

1.5

getServices

public Set<Provider.Service> getServices()

获取不可修改的此提供程序支持的所有服务的集合。

结果

该提供商支持的所有服务的一个不可修改的集合

从以下版本开始：

1.5

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 - 如果s为空

从以下版本开始：

1.5

removeService

protected void removeService(Provider.Service s)

删除以前使用putService()添加的服务。 指定的服务将从此提供程序中删除。 它将不再由getService()返回，其信息将从此提供商的Hashtable中删除。

另外，如果有一个安全管理器，它的checkSecurityAccess方法被调用与字符串"removeProviderProperty."+name ，其中name是提供程序的名称，看看是否可以删除此提供程序的属性。 如果默认实现checkSecurityAccess被使用（即，未重写此方法），那么这会导致对安全管理器的一个电话checkPermission方法有SecurityPermission("removeProviderProperty."+name)许可。

参数

s - 要删除的服务

异常

SecurityException - 如果存在安全管理员，并且其 SecurityManager.checkSecurityAccess(java.lang.String)方法拒绝访问以删除此提供程序的属性。

NullPointerException - 如果s为空

从以下版本开始：

1.5