compact1, compact2, compact3

java.security

Class Provider.Service

java.lang.Object

java.security.Provider.Service

Enclosing class:

Provider

public static class Provider.Service
extends Object

安全服务的描述。它封装了一个服务的性质，包含获得这项服务的新实例的工厂方法的实现。

每个服务都有一个提供服务的提供者，一个类型，一个算法名称，以及实现该服务的类的名称。或者，它还包括一个列表的这个服务的替代算法名称（别名）和属性，这是一个Map（名称、值）的字符串对。

这类定义的方法supportsParameter()和newInstance()由java安全框架时使用的搜索合适的服务和instantes他们。这些方法的有效参数依赖于服务的类型。为服务类型定义在java SE，看到的有效值 Java Cryptography Architecture API Specification & Reference 。注意java SE外部组件可以定义附加的服务类型和他们的行为。

这个类的实例是不可变的。

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
Service(Provider provider, String type, String algorithm, String className, List<String> aliases, Map<String,String> attributes) 建设一个新的服务。

方法摘要

Modifier and Type	Method and Description
String	getAlgorithm() 返回此服务的算法的名称。
String	getAttribute(String name) 如果此属性未设置为此服务，则返回指定属性或空值的值。
String	getClassName() 返回实现此服务的类的名称。
Provider	getProvider() 返回此服务的提供程序。
String	getType() 获取此服务的类型。
Object	newInstance(Object constructorParameter) 返回此服务所描述的实现的新实例。
boolean	supportsParameter(Object parameter) 测试此服务是否可以使用指定的参数。
String	toString() 返回此服务的字符串表示形式。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Service

public Service(Provider provider,
               String type,
               String algorithm,
               String className,
               List<String> aliases,
               Map<String,String> attributes)

建设一个新的服务。

参数

provider -提供这种服务的提供者

type -此服务的类型

algorithm的算法名称

className -类实现该服务的名称

aliases -别名或空列表，如果算法没有别名

attributesMap属性或null如果实施没有属性

异常

NullPointerException如果供应商类型、算法，或类名为空

方法详细信息

getType

public final String getType()

获取此服务的类型。例如， MessageDigest。

结果

此服务的类型

getAlgorithm

public final String getAlgorithm()

返回此服务的算法的名称。例如， SHA-1。

结果

此服务的算法

getProvider

public final Provider getProvider()

返回此服务的提供程序。

结果

此服务的提供者

getClassName

public final String getClassName()

返回实现此服务的类的名称。

结果

实现此服务的类的名称

getAttribute

public final String getAttribute(String name)

如果此属性未设置为此服务，则返回指定属性或空值的值。

参数

name -请求的属性的名称

结果

如果属性不存在指定的属性或空值的值

异常

NullPointerException如果名称是空的

newInstance

public Object newInstance(Object constructorParameter)
                   throws NoSuchAlgorithmException

返回此服务所描述的实现的新实例。安全提供程序框架使用此方法来构造实现。应用程序通常不需要调用它。

默认实现使用反射来调用这种类型的服务的标准构造函数。安全服务提供商可以重写此方法以不同的方式实现实例。对细节和constructorparameter，不同类型的服务是有效值见 Java Cryptography Architecture API Specification & Reference。

参数

constructorParameter -传递给构造函数的值，或null如果这类服务不使用constructorparameter。

结果

这项服务的新实现

异常

InvalidParameterException -如果constructorparameter价值这类服务是无效的。

NoSuchAlgorithmException -如果任何其他原因instantation失败。

supportsParameter

public boolean supportsParameter(Object parameter)

测试此服务是否可以使用指定的参数。如果此服务不能使用参数，则返回错误。如果此服务可以使用参数，如果快速测试是不可行的，或者如果状态未知，则返回真值。

安全提供程序框架使用这种方法与某些类型的服务，以快速排除非匹配的实现，供考虑。应用程序通常不需要调用它。

细节和参数，为不同类型的服务是有效值见本班上的 Java Cryptography Architecture API Specification & Reference。安全提供程序可以重写它来实现自己的测试。

参数

parameter -测试参数

结果

如果此服务不能使用指定的参数；如果它可能使用参数，则是错误的

异常

InvalidParameterException如果参数的值为这种类型的服务或如果此方法不能用于这种类型的服务是无效的

toString

public String toString()

返回此服务的字符串表示形式。

重写：

toString 方法重写，继承类 Object

结果

此服务的字符串表示形式。