java.security
클래스 Provider.Service

java.lang.Object 
  java.security.Provider.Service

포함되어 있는 클래스:

Provider

public static class Provider.Service
extends Object 

특정의 시큐러티 서비스를 기술한 것입니다. 이 클래스에는 특정의 서비스의 프로퍼티가 캡슐화되는 것 외에 그 서비스의 새로운 구현 인스턴스를 취득하기 위한 팩토리 메서드가 포함됩니다.

각 서비스는 그 서비스를 제공하는 프로바이더, 타입, 알고리즘명 및 그 서비스를 구현하는 클래스명을 포함합니다. 또 옵션으로 그 서비스의 대체 알고리즘명 (별명)의 리스트나, (name, value) 형식의 String 형 페어로서 구현된 속성 맵도 포함합니다.

이 클래스에 정의되고 있는 메서드 supportsParameter() 와 newInstance() 는 Java 시큐러티 체제가 조건에 합치하는 서비스를 검색해 인스턴스화할 때에 사용됩니다. 이러한 메서드에 대한 유효한 인수는 서비스의 타입 마다 다릅니다. J2SE 로 정의되고 있는 서비스 타입에 대해서는 「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」를 참조하십시오. 다만, J2SE 외측에 있는 컴퍼넌트에서는 다른 서비스 타입이나 그 동작을 정의할 수 있습니다 .

이 클래스의 인스턴스는 불변입니다.

도입된 버전 :

1.5

생성자 개요

Provider.Service (Provider provider, String type, String algorithm, String className, List <String > aliases, Map <String, String > attributes)
새로운 서비스를 구축합니다.

메서드 개요

String	getAlgorithm () 이 서비스의 알고리즘명 (SHA-1 등)을 리턴합니다.
String	getAttribute (String name) 지정된 속성의 값을 리턴합니다.
String	getClassName () 이 서비스를 구현하는 클래스의 이름을 리턴합니다.
Provider	getProvider () 이 서비스의 Provider를 리턴합니다.
String	getType () 이 서비스의 타입 (MessageDigest 등)을 취득합니다.
Object	newInstance (Object constructorParameter) 이 서비스가 기술하는 구현의 새로운 인스턴스를 리턴합니다.
boolean	supportsParameter (Object parameter) 이 Service가 지정된 파라미터를 사용할 수 있을지 어떨지를 판정합니다.
String	toString () 이 서비스의 String 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

Provider.Service

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

새로운 서비스를 구축합니다.

파라미터:

provider - 이 서비스를 제공하는 프로바이더

type - 이 서비스의 타입

algorithm - 알고리즘명

className - 이 서비스를 구현하는 클래스의 이름

aliases - 별명의 리스트. 알고리즘의 별명이 존재하지 않는 경우는 null

attributes - 속성 맵. 이 구현에 속성이 포함되지 않은 경우는 null

예외:

NullPointerException - 프로바이더, 타입, 알고리즘, 또는 className가 null인 경우

메서드의 상세

getType

public final String  getType()

이 서비스의 타입 (MessageDigest 등)을 취득합니다.

반환값:

이 서비스의 타입

getAlgorithm

public final String  getAlgorithm()

이 서비스의 알고리즘명 (SHA-1 등)을 리턴합니다.

반환값:

이 서비스의 알고리즘

getProvider

public final Provider  getProvider()

이 서비스의 Provider를 리턴합니다.

반환값:

이 서비스의 Provider

getClassName

public final String  getClassName()

이 서비스를 구현하는 클래스의 이름을 리턴합니다.

반환값:

이 서비스를 구현하는 클래스의 이름

getAttribute

public final String  getAttribute(String  name)

지정된 속성의 값을 리턴합니다. 그 속성이 이 Service 로 설정되어 있지 않은 경우는 null을 리턴합니다.

파라미터:

name - 요구된 속성의 이름

반환값:

지정된 속성의 값. 그 속성이 존재하지 않는 경우는 null

예외:

NullPointerException - 이름이 null인 경우

newInstance

public Object  newInstance(Object  constructorParameter)
                   throws NoSuchAlgorithmException 

이 서비스가 기술하는 구현의 새로운 인스턴스를 리턴합니다. 시큐러티 프로바이더 체제는 이 메서드를 사용해 구현의 구축을 실시합니다. 보통 의 경우, 어플리케이션으로부터 이 메서드를 호출할 필요는 없습니다.

디폴트 구현은 리플렉션을 사용해 이 서비스 타입에 대한 표준의 생성자를 호출합니다. 시큐러티 프로바이더는 이 메서드를 오버라이드(override) 하는 것으로 인스턴스화를 다른 방법으로 구현할 수 있습니다. 다양한 서비스 타입의 상세나 유효한 constructorParameter 치에 대해서는 「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」를 참조하십시오.

파라미터:

constructorParameter - 생성자에 건네주는 값. 이 서비스 타입이 constructorParameter를 사용하지 않는 경우는 null

반환값:

이 서비스의 새로운 구현

예외:

InvalidParameterException - constructorParameter 값이 이 서비스 타입에 대해서 무효인 경우

NoSuchAlgorithmException - 어떠한 이유로써 인스턴스화가 실패했을 경우

supportsParameter

public boolean supportsParameter(Object  parameter)

이 Service가 지정된 파라미터를 사용할 수 있을지 어떨지를 판정합니다. 이 서비스가 그 파라미터를 사용할 수 없는 경우는 false를 리턴합니다. 이 서비스가 그 파라미터를 사용할 수 있는 경우, 고속의 판정이 실행 불가능한 경우, 혹은 상태가 불명한 경우에는 true를 리턴합니다.

시큐러티 프로바이더 체제는 일부의 서비스 타입으로 이 메서드를 사용하는 것으로 조건에 합치하지 않는 구현을 처리 대상으로부터 재빠르게 제외합니다. 보통 의 경우, 어플리케이션으로부터 이 메서드를 호출할 필요는 없습니다.

다양한 서비스 타입의 상세나 유효한 파라미터값에 대해서는 이 클래스의 선두 부분의 설명과「Java 암호화 아키텍쳐 API 사양 및 레퍼런스」를 참조하십시오. 시큐러티 프로바이더는 이 메서드를 오버라이드(override) 하는 것으로 독자적인 판정 논리를 구현할 수 있습니다.

파라미터:

parameter - 판정 대상의 파라미터

반환값:

이 서비스가 지정된 파라미터를 사용할 수 없는 경우는 false, 이 서비스가 그 파라미터를 사용할 수 있을 가능성이 있는 경우는 true

예외:

InvalidParameterException - 파라미터의 값이 이 서비스 타입에 대해서 무효인 경우, 혹은 이 메서드가 이 서비스 타입으로 사용할 수 없는 경우

toString

public String  toString()

이 서비스의 String 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 서비스의 String 표현