javax.crypto
클래스 ExemptionMechanismSpi

java.lang.Object 
  javax.crypto.ExemptionMechanismSpi

public abstract class ExemptionMechanismSpi
extends Object 

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

도입된 버전 :

1.4

생성자 개요

ExemptionMechanismSpi ()

메서드 개요

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

클래스 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 

키를 사용해 이 제외 도구를 초기화합니다.

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

파라미터:

key - 이 제외 도구 의 키

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

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

engineInit

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

                                   InvalidAlgorithmParameterException,

                                   ExemptionMechanismException 

키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.

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

파라미터:

key - 이 제외 도구 의 키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 제외 도구에 부적절한 경우

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

engineInit

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

                                   InvalidAlgorithmParameterException,

                                   ExemptionMechanismException 

키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.

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

파라미터:

key - 이 제외 도구 의 키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 제외 도구에 부적절한 경우

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

engineGenExemptionBlob

protected abstract byte[] engineGenExemptionBlob()
                                          throws ExemptionMechanismException 

제외 도구 의 키 Blob를 생성합니다.

반환값:

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

예외:

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

engineGenExemptionBlob

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

                                              ExemptionMechanismException 

제외 도구 의 키 Blob를 생성해, 결과를 outputOffset로 부터 시작되는 output 버퍼에 포함합니다.

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

파라미터:

output - 결과를 포함하는 버퍼

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

반환값:

output에 포함된 바이트수

예외:

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

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