javax.crypto
클래스 ExemptionMechanism

java.lang.Object 
  |
  +--javax.crypto.ExemptionMechanism

public class ExemptionMechanism

extends Object

이 클래스는 제외 기구의 기능과 「열쇠의 회복」, 「열쇠의 약화」, 및 「열쇠 에스크로-」의 예를 제공합니다.

제외 기구를 사용하는 어플리케이션 또는 애플릿에는 사용하지 않는 것보다 강력한 암호화 기능을 부여할 수 있습니다.

도입된 버젼:

1.4

생성자의 개요

protected

ExemptionMechanism (ExemptionMechanismSpi exmechSpi, Provider provider, String mechanism) ExemptionMechanism 오브젝트를 작성합니다.

메소드의 개요

protected void	finalize () ExemptionMechanism 오브젝트에의 참조가 존재하지 않게 되었을 때에, 이 오브젝트에 의해 저장된 열쇠가 확실히 지워지도록(듯이) 합니다.
byte[]	genExemptionBlob () 제외 기구의 열쇠 Blob 를 생성합니다.
int	genExemptionBlob (byte[] output) 제외 기구의 열쇠 Blob 를 생성해, 결과를 output 버퍼에 저장합니다.
int	genExemptionBlob (byte[] output, int outputOffset) 제외 기구의 열쇠 Blob 를 생성해, 결과를 outputOffset 로부터 시작되는 output 버퍼에 저장합니다.
static ExemptionMechanism	getInstance (String mechanism) 지정된 제외 기구를 구현하는 ExemptionMechanism 오브젝트를 작성합니다.
static ExemptionMechanism	getInstance (String mechanism, Provider provider) 지정된 프로바이더로부터, 지정된 제외 기구의 ExemptionMechanism 오브젝트를 생성합니다.
static ExemptionMechanism	getInstance (String mechanism, String provider) 지정된 프로바이더로부터, 지정된 제외 기구의 ExemptionMechanism 오브젝트를 작성합니다.
String	getName () 이 ExemptionMechanism 오브젝트의 제외 기구명을 돌려줍니다.
int	getOutputSize (int inputLen) 입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 genExemptionBlob 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 돌려줍니다.
Provider	getProvider () 이 ExemptionMechanism 오브젝트의 프로바이더를 돌려줍니다.
void	init (Key key) 열쇠를 사용해 이 제외 기구를 초기화합니다.
void	init (Key key, AlgorithmParameters params) 열쇠와 알고리즘 파라미터세트를 사용해 이 제외 기구를 초기화합니다.
void	init (Key key, AlgorithmParameterSpec params) 열쇠와 알고리즘 파라미터세트를 사용해 이 제외 기구를 초기화합니다.
boolean	isCryptoAllowed (Key key) 이 제외 기구에 의해 결과 Blob 가 정상적으로 생성되었는지 어떠했는지를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

ExemptionMechanism

protected ExemptionMechanism(ExemptionMechanismSpi  exmechSpi,
                             Provider  provider,
                             String  mechanism)

ExemptionMechanism 오브젝트를 작성합니다.

파라미터:

exmechSpi - delegate처

provider - 프로바이더

mechanism - 제외 기구

메소드의 상세

getName

public final String  getName()

이 ExemptionMechanism 오브젝트의 제외 기구명을 돌려줍니다.

이것은 이 ExemptionMechanism 오브젝트를 작성한 getInstance 호출의 1 개로 지정된 이름과 같습니다.

반환값:

이 ExemptionMechanism 오브젝트의 제외 기구명

getInstance

public static final ExemptionMechanism  getInstance(String  mechanism)
                                            throws NoSuchAlgorithmException 

지정된 제외 기구를 구현하는 ExemptionMechanism 오브젝트를 작성합니다. 디폴트의 프로바이더의 패키지가, 요구된 제외 기구의 구현을 제공하고 있는 경우는 그 구현을 가진 ExemptionMechanism 클래스의 인스턴스가 돌려주어집니다. 제외 기구가 디폴트의 패키지로 얻을 수 없는 경우는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

mechanism - 요구된 제외 기구의 표준적인 이름. 제외 기구의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스」의 부록 A 를 참조

반환값:

새로운 ExemptionMechanism 오브젝트

예외:

NoSuchAlgorithmException - 지정된 제외 기구가, 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우

getInstance

public static final ExemptionMechanism  getInstance(String  mechanism,
                                                   String  provider)
                                            throws NoSuchAlgorithmException ,
                                                   NoSuchProviderException 

지정된 프로바이더로부터, 지정된 제외 기구의 ExemptionMechanism 오브젝트를 작성합니다.

파라미터:

mechanism - 요구된 제외 기구의 표준적인 이름. 제외 기구의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스」의 부록 A 를 참조

provider - 프로바이더명

반환값:

새로운 ExemptionMechanism 오브젝트

예외:

NoSuchAlgorithmException - 지정된 제외 기구가, 지정된 프로바이더에 없는 경우

NoSuchProviderException - 지정된 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - provider 가 null 의 경우

getInstance

public static final ExemptionMechanism  getInstance(String  mechanism,
                                                   Provider  provider)
                                            throws NoSuchAlgorithmException 

지정된 프로바이더로부터, 지정된 제외 기구의 ExemptionMechanism 오브젝트를 생성합니다. provider 는 등록되어 있을 필요는 없는 것에 주의해 주세요.

파라미터:

mechanism - 요구된 제외 기구의 표준적인 이름. 제외 기구의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스 」의 부록 A 를 참조

provider - 프로바이더

반환값:

새로운 ExemptionMechanism 오브젝트

예외:

NoSuchAlgorithmException - 지정된 제외 기구가, 지정된 프로바이더에 없는 경우

IllegalArgumentException - provider 가 null 의 경우

getProvider

public final Provider  getProvider()

이 ExemptionMechanism 오브젝트의 프로바이더를 돌려줍니다.

반환값:

이 ExemptionMechanism 오브젝트의 프로바이더

isCryptoAllowed

public final boolean isCryptoAllowed(Key  key)
                              throws ExemptionMechanismException 

이 제외 기구에 의해 결과 Blob 가 정상적으로 생성되었는지 어떠했는지를 돌려줍니다.

이 메소드는 건네받은 열쇠가, 이 제외 기구가 초기화 및 생성 단계에서 사용한 열쇠와 같은 것도 확인합니다.

파라미터:

key - 암호가 사용하는 열쇠

반환값:

이 제외 기구에 의해 같은 열쇠의 결과 Blob 가 정상적으로 생성되었는지 어떠했는지를 돌려줍니다.

예외:

ExemptionMechanismException - 이 제외 기구 오브젝트에 의해 결과 Blob 가 정상적으로 생성되었는지 어떠했는지를 판정할 때에 문제가 발견되었을 경우

getOutputSize

public final int getOutputSize(int inputLen)
                        throws IllegalStateException 

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

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

파라미터:

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

반환값:

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

예외:

IllegalStateException - 이 제외 기구가 잘못한 상태에 있는 경우 (예를 들어, 아직 초기화되어 있지 않다)

init

public final void init(Key  key)
                throws InvalidKeyException ,
                       ExemptionMechanismException 

열쇠를 사용해 이 제외 기구를 초기화합니다.

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

파라미터:

key - 이 제외 기구의 열쇠

예외:

InvalidKeyException - 지정된 열쇠가 이 제외 기구에 부적절한 경우

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

init

public final void init(Key  key,
                       AlgorithmParameterSpec  params)
                throws InvalidKeyException ,
                       InvalidAlgorithmParameterException ,
                       ExemptionMechanismException 

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

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

파라미터:

key - 이 제외 기구의 열쇠

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 열쇠가 이 제외 기구에 부적절한 경우

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

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

init

public final void init(Key  key,
                       AlgorithmParameters  params)
                throws InvalidKeyException ,
                       InvalidAlgorithmParameterException ,
                       ExemptionMechanismException 

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

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

파라미터:

key - 이 제외 기구의 열쇠

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 열쇠가 이 제외 기구에 부적절한 경우

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

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

genExemptionBlob

public final byte[] genExemptionBlob()
                              throws IllegalStateException ,
                                     ExemptionMechanismException 

제외 기구의 열쇠 Blob 를 생성합니다.

반환값:

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

예외:

IllegalStateException - 이 제외 기구가 잘못한 상태에 있는 경우 (예를 들어, 초기화되어 있지 않다)

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

genExemptionBlob

public final int genExemptionBlob(byte[] output)
                           throws IllegalStateException ,
                                  ShortBufferException ,
                                  ExemptionMechanismException 

제외 기구의 열쇠 Blob 를 생성해, 결과를 output 버퍼에 저장합니다.

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

파라미터:

output - 결과를 저장하는 버퍼

반환값:

output 에 저장된 바이트수

예외:

IllegalStateException - 이 제외 기구가 잘못한 상태에 있는 경우 (예를 들어, 초기화되어 있지 않다)

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

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

genExemptionBlob

public final int genExemptionBlob(byte[] output,
                                  int outputOffset)
                           throws IllegalStateException ,
                                  ShortBufferException ,
                                  ExemptionMechanismException 

제외 기구의 열쇠 Blob 를 생성해, 결과를 outputOffset 로부터 시작되는 output 버퍼에 저장합니다.

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

파라미터:

output - 결과를 저장하는 버퍼

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

반환값:

output 에 저장된 바이트수

예외:

IllegalStateException - 이 제외 기구가 잘못한 상태에 있는 경우 (예를 들어, 초기화되어 있지 않다)

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

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

finalize

protected void finalize()

ExemptionMechanism 오브젝트에의 참조가 존재하지 않게 되었을 때에, 이 오브젝트에 의해 저장된 열쇠가 확실히 지워지도록(듯이) 합니다.

오버라이드(override):

클래스 Object 내의 finalize