java.security.cert
클래스 CertificateFactorySpi

java.lang.Object 
  java.security.cert.CertificateFactorySpi

public abstract class CertificateFactorySpi
extends Object 

CertificateFactory 클래스의 Service Provider Interface (SPI)를 정의합니다. 이 클래스의 모든 abstract 메소드는, X. 509 등의 특정의 증명서형의 증명서 팩토리의 구현을 제공하는 각 암호화 서비스 프로바이더에 의해 구현될 필요가 있습니다.

증명서 팩토리는 증명서 객체, 증명서 패스 (CertPath) 및 증명서의 취소 리스트 (CRL) 객체를 부호로부터 생성하기 위해서 사용합니다.

X. 509 의 증명서 팩토리는,java.security.cert.X509Certificate 의 인스턴스인 증명서, 및 java.security.cert.X509CRL 의 인스턴스인 CRL 를 돌려줍니다.

도입된 버젼:

1.2

관련 항목:

CertificateFactory , Certificate , X509Certificate , CertPath , CRL , X509CRL

생성자 의 개요

CertificateFactorySpi ()

메소드의 개요

abstract Certificate	engineGenerateCertificate (InputStream inStream) 증명서 객체를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 그 증명서 객체를 초기화합니다.
abstract Collection <? extends Certificate >	engineGenerateCertificates (InputStream inStream) 지정된 입력 스트림 inStream 로부터 읽어내진 증명서의 코레크션뷰를 돌려줍니다.
CertPath	engineGenerateCertPath (InputStream inStream) CertPath 객체를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다.
CertPath	engineGenerateCertPath (InputStream inStream, String encoding) CertPath 객체를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다.
CertPath	engineGenerateCertPath (List <? extends Certificate > certificates) CertPath 객체를 생성해,Certificate 의 List 로 초기화합니다.
abstract CRL	engineGenerateCRL (InputStream inStream) 증명서의 취소 리스트 (CRL) 객체를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 초기화합니다.
abstract Collection <? extends CRL >	engineGenerateCRLs (InputStream inStream) 지정된 입력 스트림 inStream 로부터 읽어내진 CRL 의 코레크션뷰를 돌려줍니다.
Iterator <String >	engineGetCertPathEncodings () 이 증명서 팩토리로 지원하는 CertPath 의 encode의 반복을 돌려줍니다.

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

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

생성자 의 상세

CertificateFactorySpi

public CertificateFactorySpi()

메소드의 상세

engineGenerateCertificate

public abstract Certificate  engineGenerateCertificate(InputStream  inStream)
                                               throws CertificateException 

증명서 객체를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 그 증명서 객체를 초기화합니다.

이 증명서 팩토리에 의해 지원되고 있는 특수 형식의 증명서를 이용하기 위해서, 반환된 증명서 객체를 대응하는 증명서 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 증명서를 구현하는 경우, 반환된 증명서 객체를 X509Certificate 클래스에 형태 캐스트 할 수 있습니다.

X. 509 증명서의 증명서 팩토리의 경우는,inStream 로 제공되는 증명서는 DER 로 encode 될 필요가 있어, 바이너리 또는 프린트 가능 (Base64)인 부호로 제공되는 일도 있습니다. 증명서가 Base64 의 부호로 제공되었을 경우, 선두는 -----BEGIN CERTIFICATE----- 에 의해 단락지어져 끝은 -----END CERTIFICATE----- 에 의해 단락지어질 필요가 있습니다.

지정된 입력 스트림이 mark 및 reset 를 지원하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다. 그렇지 않은 경우, 이 메소드가 불려 갈 때마다 증명서를 1 개 소비해, 입력 스트림의 read 위치는, 고유의 end-of-certificate 마커의 나중에 다음에 사용 가능한 바이트로 설정됩니다. 고유의 end-of-certificate 마커 (EOF 이외)가 입력 스트림의 데이터에 포함되지 않고, 증명서가 구문 분석 된 후에 데이터가 계속되는 경우는,CertificateException 가 throw 됩니다.

파라미터:

inStream - 증명서 데이터를 가지는 입력 스트림

반환값:

입력 스트림의 데이터를 사용해 초기화된 증명서 객체

예외:

CertificateException - 구문 분석 에러의 경우

engineGenerateCertPath

public CertPath  engineGenerateCertPath(InputStream  inStream)
                                throws CertificateException 

CertPath 객체를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다. 데이터는 디폴트의 encode가 되고 있으면(자) 가정됩니다.

이 메소드는, Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 throw 합니다.

파라미터:

inStream - 데이터가 포함되는 InputStream

반환값:

InputStream 로부터의 데이터로 초기화된 CertPath

예외:

CertificateException - 복호화중에 예외가 발생했을 경우

UnsupportedOperationException - 메소드가 지원되어 있지 않은 경우

도입된 버젼:

1.4

engineGenerateCertPath

public CertPath  engineGenerateCertPath(InputStream  inStream,
                                       String  encoding)
                                throws CertificateException 

CertPath 객체를 생성해,InputStream 인 inStream 로부터 읽힌 데이터로 초기화합니다. 데이터는 지정한 encode가 되고 있으면(자) 가정됩니다.

이 메소드는, Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 throw 합니다.

파라미터:

inStream - 데이터가 포함되는 InputStream

encoding - 데이터로 사용되는 encode

반환값:

InputStream 로부터의 데이터로 초기화된 CertPath

예외:

CertificateException - 복호화중에 예외가 발생했을 경우, 또는 지정한 encode가 지원되어 있지 않은 경우

UnsupportedOperationException - 메소드가 지원되어 있지 않은 경우

도입된 버젼:

1.4

engineGenerateCertPath

public CertPath  engineGenerateCertPath(List <?  extends Certificate > certificates)
                                throws CertificateException 

CertPath 객체를 생성해,Certificate 의 List 로 초기화합니다.

제공되는 증명서는,CertificateFactory 로 지원되고 있는 종류일 필요가 있습니다. 이것들은, 지정된 List 객체로부터 카피됩니다.

이 메소드는, Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 throw 합니다.

파라미터:

certificates - Certificate 의 List

반환값:

제공된 증명서의 리스트로 초기화된 CertPath

예외:

CertificateException - 예외가 발생하는 경우

UnsupportedOperationException - 메소드가 지원되어 있지 않은 경우

도입된 버젼:

1.4

engineGetCertPathEncodings

public Iterator <String > engineGetCertPathEncodings()

이 증명서 팩토리로 지원하는 CertPath 의 encode의 반복을 돌려줍니다. 반복의 처음은 디폴트의 encode가 됩니다. 표준의 encode명에 대해서는,「Java Certification Path API 개발자 안내」 의 부록 A 를 참조해 주세요.

반환된 Iterator 를 remove 메소드로 변경하려고 하면(자),UnsupportedOperationException 가 throw 됩니다.

이 메소드는, Java 2 Platform Standard Edition 의 버젼 1.4 로 추가되었습니다. 기존의 서비스 프로바이더와의 하위 호환성을 유지하기 위해서,abstract 에는 하지 못하고, 디폴트로 UnsupportedOperationException 를 throw 합니다.

반환값:

지원되는 CertPath 의 encode의 이름 (String)을 반복하는 Iterator

예외:

UnsupportedOperationException - 메소드가 지원되어 있지 않은 경우

도입된 버젼:

1.4

engineGenerateCertificates

public abstract Collection <?  extends Certificate > engineGenerateCertificates(InputStream  inStream)
                                                                      throws CertificateException 

지정된 입력 스트림 inStream 로부터 읽어내진 증명서의 코레크션뷰를 돌려줍니다. 코레크션뷰는 빈 상태(empty)의 경우도 있습니다.

이 증명서 팩토리에 의해 지원되고 있는 특수한 형식의 증명서를 이용하기 위해서, 반환된 코레크션뷰의 각 요소를 대응하는 증명서 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 증명서를 구현하는 경우, 반환된 컬렉션내의 요소를 X509Certificate 클래스에 형태 캐스트 할 수 있습니다.

X. 509 증명서로 사용하는 증명서 팩토리의 경우,inStream 에는,generateCertificate 로 설명되고 있는 형식의, DER 로 encode 된 단일의 증명서가 포함됩니다. 또,inStream 에는 PKCS#7 증명서 체인이 포함됩니다. 이것은 PKCS#7 SignedData 객체이며, 상위 필드는 certificates 뿐입니다. 특히, 서명 및 내용은 무시됩니다. 이 형식의 경우, 복수의 증명서를 1 회에 다운로드할 수 있습니다. 증명서가 없는 경우는, 빈 상태(empty)의 컬렉션이 돌려주어집니다.

지정된 입력 스트림이 mark 및 reset 를 지원하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다.

파라미터:

inStream - 증명서를 가지는 입력 스트림

반환값:

입력 스트림로부터의 데이터를 사용해 초기화된 java.security.cert.Certificate 객체의 코레크션뷰. 빈 상태(empty)의 경우도 있다

예외:

CertificateException - 구문 분석 에러의 경우

engineGenerateCRL

public abstract CRL  engineGenerateCRL(InputStream  inStream)
                               throws CRLException 

증명서의 취소 리스트 (CRL) 객체를 생성해, 입력 스트림 inStream 로부터 읽어내진 데이터를 사용해 초기화합니다.

이 증명서 팩토리에 의해 지원되고 있는 특수한 형식의 CRL 를 이용하기 위해서, 반환된 CRL 객체를 대응하는 CRL 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 CRL 를 구현하는 경우, 반환된 CRL 객체를 X509CRL 클래스에 형태 캐스트 할 수 있습니다.

지정된 입력 스트림이 mark 및 reset 를 지원하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다. 그렇지 않은 경우, 이 메소드가 불려 갈 때마다 CRL 를 1 개 소비해, 입력 스트림의 read 위치는, 고유의 end-of-CRL 마커의 나중에 다음에 사용 가능한 바이트로 설정됩니다. 고유의 end-of-CRL 마커 (EOF 이외)가 입력 스트림의 데이터에 포함되지 않고, CRL 가 구문 분석 된 후에 데이터가 계속되는 경우는,CertificateException 가 throw 됩니다.

파라미터:

inStream - CRL 데이터를 가지는 입력 스트림

반환값:

입력 스트림의 데이터를 사용해 초기화된 CRL 객체

예외:

CRLException - 구문 분석 에러의 경우

engineGenerateCRLs

public abstract Collection <?  extends CRL > engineGenerateCRLs(InputStream  inStream)
                                                      throws CRLException 

지정된 입력 스트림 inStream 로부터 읽어내진 CRL 의 코레크션뷰를 돌려줍니다. 코레크션뷰는 빈 상태(empty)의 경우도 있습니다.

이 증명서 팩토리에 의해 지원되고 있는 특수한 형식의 CRL 를 이용하기 위해서, 반환된 코레크션뷰의 각 요소를 대응하는 CRL 클래스에 형태 캐스트 할 수 있습니다. 예를 들어, 이 증명서 팩토리가 X. 509 CRL 를 구현하는 경우, 반환된 컬렉션내의 요소를 X509CRL 클래스에 형태 캐스트 할 수 있습니다.

X. 509 CRL 의 증명서 팩토리의 경우는,inStream 에는, DER 로 encode 된 1 개의 CRL 가 포함됩니다. 또,inStream 에는 PKCS#7 CRL 세트가 포함됩니다. 이것은 PKCS#7 SignedData 객체로, 상위 필드는 crls 뿐입니다. 특히, 서명 및 내용은 무시됩니다. 이 형식의 경우, 복수의 CRL 를 1 회에 다운로드할 수 있습니다. CRL 가 없는 경우는, 빈 상태(empty)의 컬렉션이 돌려주어집니다.

지정된 입력 스트림이 mark 및 reset 를 지원하고 있지 않는 경우, 이 메소드는 입력 스트림 전체를 사용합니다.

파라미터:

inStream - CRL 를 가지는 입력 스트림

반환값:

입력 스트림로부터의 데이터를 사용해 초기화된 java.security.cert.Certificate 객체의 코레크션뷰. 빈 상태(empty)의 경우도 있다

예외:

CRLException - 구문 분석 에러의 경우