javax.crypto
클래스 ExemptionMechanismSpi

java.lang.Object 
  javax.crypto.ExemptionMechanismSpi

public abstract class ExemptionMechanismSpi
extends Object 

이 클래스는,ExemptionMechanism 클래스의 Service Provider Interface (SPI)를 정의합니다. 특정의 Exemption Mechanism의 구현을 제공하는 각 암호화 서비스 프로바이더는, 이 클래스의 모든 추상 메소드를 구현할 필요가 있습니다.

도입된 버젼:

1.4

생성자 의 개요

ExemptionMechanismSpi ()

메소드의 개요

protected abstract byte[]	engineGenExemptionBlob () Exemption Mechanism의 열쇠 Blob 를 생성합니다.
protected abstract int	engineGenExemptionBlob (byte[] output, int outputOffset) Exemption Mechanism의 열쇠 Blob 를 생성해, 결과를 outputOffset 로부터 시작되는 output 버퍼에 포함합니다.
protected abstract int	engineGetOutputSize (int inputLen) 입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 engineGenExemptionBlob 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 돌려줍니다.
protected abstract void	engineInit (Key key) 열쇠를 사용해 이 Exemption Mechanism를 초기화합니다.
protected abstract void	engineInit (Key key, AlgorithmParameters params) 열쇠와 알고리즘 파라미터세트를 사용해 이 Exemption Mechanism를 초기화합니다.
protected abstract void	engineInit (Key key, AlgorithmParameterSpec params) 열쇠와 알고리즘 파라미터세트를 사용해 이 Exemption Mechanism를 초기화합니다.

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

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

생성자 의 상세

ExemptionMechanismSpi

public ExemptionMechanismSpi()

메소드의 상세

engineGetOutputSize

protected abstract int engineGetOutputSize(int inputLen)

입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 engineGenExemptionBlob 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 돌려줍니다.

다음의 engineGenExemptionBlob 호출의 실제의 출력 길이은, 이 메소드가 돌려주는 길이보다 작은 일이 있습니다.

파라미터:

inputLen - 입력 길이 (바이트 단위)

반환값:

필요한 출력 버퍼 사이즈 (바이트 단위)

engineInit

protected abstract void engineInit(Key  key)
                            throws InvalidKeyException ,
                                   ExemptionMechanismException 

열쇠를 사용해 이 Exemption Mechanism를 초기화합니다.

이 Exemption Mechanism가, 지정된 key 로부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 Exemption Mechanism의 구현은, 프로바이더 고유의 디폴트 값를 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는,InvalidKeyException 가 발생합니다.

파라미터:

key - 이 Exemption Mechanism의 열쇠

예외:

InvalidKeyException - 지정된 열쇠가 이 Exemption Mechanism에 올바르지 않은 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

engineInit

protected abstract void engineInit(Key  key,
                                   AlgorithmParameterSpec  params)
                            throws InvalidKeyException ,
                                   InvalidAlgorithmParameterException ,
                                   ExemptionMechanismException 

열쇠와 알고리즘 파라미터세트를 사용해 이 Exemption Mechanism를 초기화합니다.

이 Exemption Mechanism가 알고리즘 파라미터를 필요로 해,params 가 null 인 경우, 기본이 되는 Exemption Mechanism의 구현은, 프로바이더 고유의 디폴트 값를 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는,InvalidAlgorithmParameterException 가 발생합니다.

파라미터:

key - 이 Exemption Mechanism의 열쇠

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 열쇠가 이 Exemption Mechanism에 올바르지 않은 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 Exemption Mechanism에 올바르지 않은 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

engineInit

protected abstract void engineInit(Key  key,
                                   AlgorithmParameters  params)
                            throws InvalidKeyException ,
                                   InvalidAlgorithmParameterException ,
                                   ExemptionMechanismException 

열쇠와 알고리즘 파라미터세트를 사용해 이 Exemption Mechanism를 초기화합니다.

이 Exemption Mechanism가 알고리즘 파라미터를 필요로 해,params 가 null 인 경우, 기본이 되는 Exemption Mechanism의 구현은, 프로바이더 고유의 디폴트 값를 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는,InvalidAlgorithmParameterException 가 발생합니다.

파라미터:

key - 이 Exemption Mechanism의 열쇠

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 열쇠가 이 Exemption Mechanism에 올바르지 않은 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 Exemption Mechanism에 올바르지 않은 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

engineGenExemptionBlob

protected abstract byte[] engineGenExemptionBlob()
                                          throws ExemptionMechanismException 

Exemption Mechanism의 열쇠 Blob 를 생성합니다.

반환값:

결과의 열쇠 Blob 가 들어간 새로운 버퍼

예외:

ExemptionMechanismException - 생성의 처리로 문제가 발견되었을 경우

engineGenExemptionBlob

protected abstract int engineGenExemptionBlob(byte[] output,
                                              int outputOffset)
                                       throws ShortBufferException ,
                                              ExemptionMechanismException 

Exemption Mechanism의 열쇠 Blob 를 생성해, 결과를 outputOffset 로부터 시작되는 output 버퍼에 포함합니다.

output 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우는,ShortBufferException 가 throw 됩니다. 이 경우, 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다. engineGetOutputSize 를 사용해, 필요한 출력 버퍼의 사이즈를 판정합니다.

파라미터:

output - 결과를 포함하는 버퍼

outputOffset - 결과가 포함되는 output 내의 오프셋(offset)

반환값:

output 에 포함된 바이트수

예외:

ShortBufferException - 지정된 출력 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우

ExemptionMechanismException - 생성의 처리로 문제가 발견되었을 경우