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 - 생성의 처리로 문제가 발견되었을 경우