java.security.cert
클래스 CertStoreSpi

java.lang.Object 
  java.security.cert.CertStoreSpi

public abstract class CertStoreSpi
extends Object 

CertStore 클래스의 Service Provider Interface (SPI)입니다. CertStore 모든 구현에서는 이 CertStorerSpi 클래스를 확장해, 타입 CertStoreParameters 인수 1개을 가지는 생성자를 제공해, 모든 메서드를 구현하는 클래스 (SPI 클래스)가 포함되지 않으면 안됩니다. 일반적으로CertStore 클래스 통한 보고, 이 클래스의 인스턴스에 액세스 할 수 있습니다. 상세한 것에 대하여는 「Java 암호화 아키텍쳐」를 참조하십시오.

병행 액세스

CertStoreSpi 객체의 public 메서드는 thread에 대해서 안전하지 않으면 안됩니다. 즉, 그러한 public 메서드는 악영향을 주는 일 없이, 단일 CertStoreSpi 객체 (또는 1개 이상) 상에서 복수 thread가 병행해 호출할 수 있습니다 . 이것에 의해 예를 들어 차례차례로 인증서를 검색하면서, 동시에 CertPathBuilder를 사용해 CRL를 검색할 수 있습니다 .

간단한 CertStoreSpi 구현에서는 synchronized 키워드를 engineGetCertificates 메서드와 engineGetCRLs 메서드에 추가하는 것으로 thread에 대해서 안전하다라고 하는 것이 보증됩니다. 고도의 구현에서는 진정한 병행 액세스가 가능하게 됩니다.

도입된 버전 :

1.4

생성자 개요

CertStoreSpi (CertStoreParameters params)
유일한 생성자 입니다.

메서드 개요

abstract Collection <? extends Certificate >	engineGetCertificates (CertSelector selector) 지정한 셀렉터에 일치하는 Certificate Collection을 리턴합니다.
abstract Collection <? extends CRL >	engineGetCRLs (CRLSelector selector) 지정한 셀렉터에 일치하는 CRL Collection을 리턴합니다.

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

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

생성자 상세

CertStoreSpi

public CertStoreSpi(CertStoreParameters  params)
             throws InvalidAlgorithmParameterException 

유일한 생성자 입니다.

파라미터:

params - 초기화 파라미터. null도 가능

예외:

InvalidAlgorithmParameterException - 초기화 파라미터가 이 CertStoreSpi에 대해서 부적절한 경우

메서드의 상세

engineGetCertificates

public abstract Collection <?  extends Certificate > engineGetCertificates(CertSelector  selector)
                                                                 throws CertStoreException 

지정한 셀렉터에 일치하는 Certificate Collection을 리턴합니다. 셀렉터에 일치하는 Certificate가 없는 경우는 비어있는 Collection가 리턴됩니다 .

CertStore 형태에 따라서는 셀렉터에 일치하는 Certificate 모든 것이 결과의 Collection에 포함되지 않는 것이 있습니다. 예를 들어 LDAP CertStore에 서는 디렉토리내의 모든 엔트리를 검색하지 않습니다. 대신에 검색하는 Certificate가 포함된다고 생각되는 엔트리에 좁혀 검색합니다.

CertStore 안에는 인증서를 찾아내기 위한 특정의 조건을 포함한 비 null CertSelector가 제공되지 않는 한, CertStoreException을 Throw 하는 것이 있습니다 (특히 LDAP CertStore). 발행자나 피인증자의 이름은 특별히 도움이 되는 조건이 됩니다.

파라미터:

selector - 리턴된 Certificate를 선택하기 위해서 이용하는 CertSelector. null을 지정하면, 지원 되고 있는 경우는 모든 Certificate를 돌려준다

반환값:

지정한 셀렉터에 일치하는 Certificate Collection. null은 되지 않는다

예외:

CertStoreException - 예외가 발생하는 경우

engineGetCRLs

public abstract Collection <?  extends CRL > engineGetCRLs(CRLSelector  selector)
                                                 throws CertStoreException 

지정한 셀렉터에 일치하는 CRL Collection을 리턴합니다. 셀렉터에 일치하는 CRL가 없는 경우는 비어있는 Collection가 리턴됩니다 .

CertStore 형태에 따라서는 셀렉터에 일치하는 CRL 모든 것이 결과의 Collection에 포함되지 않는 것이 있습니다. 예를 들어 LDAP CertStore에 서는 디렉토리내의 모든 엔트리를 검색하지 않습니다. 대신에 검색하는 CRL가 포함된다고 생각되는 엔트리에 좁혀 검색합니다.

CertStore 안에는 인증서를 찾아내기 위한 특정의 조건을 포함한 비 null CRLSelector가 제공되지 않는 한, CertStoreException을 Throw 하는 것이 있습니다 (특히 LDAP CertStore). 발행자의 이름이나 체크 대상의 인증서는 특별히 도움이 됩니다.

파라미터:

selector - 리턴된 CRL를 선택하기 위해서 이용하는 CRLSelector. null을 지정하면, 지원 되고 있는 경우는 모든 CRL를 돌려준다

반환값:

지정한 셀렉터에 일치하는 CRL Collection. null은 되지 않는다

예외:

CertStoreException - 예외가 발생하는 경우