java.security
클래스 Provider.Service

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

포함되어 있는 클래스:

Provider

public static class Provider.Service
extends Object 

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

각 서비스는, 그 서비스를 제공하는 프로바이더, 타입, 알고리즘명, 및 그 서비스를 구현하는 클래스명을 포함합니다. 또, 이 서비스 (별명) 및 속성에 대한 대체 알고리즘명의 일람을 가지고 있습니다. 이 일람은, 이름과 값의 String 페어의 맵입니다.

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

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

도입된 버젼:

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 암호화 아키텍쳐(architecture) API 의 스펙 및 레퍼런스」를 참조해 주세요.

파라미터:

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

반환값:

이 서비스의 새로운 구현

예외:

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

NoSuchAlgorithmException - 하등의 이유로써 인스턴스화가 실패했을 경우

supportsParameter

public boolean supportsParameter(Object  parameter)

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

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

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

파라미터:

parameter - 판정 대상의 파라미터

반환값:

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

예외:

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

toString

public String  toString()

이 서비스의 String 표현을 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 서비스의 String 표현